HTML docs

[Gerald Pfeifer]

On Sat, 31 Aug 2002, Phil Edwards wrote:
> I'm cc'ing Gerald as the author of the preprocessing script... something
> doesn't look right to me.
>
> The update_web_docs (non-libstdc++ version) seems to do this:
>
>     - run makeinfo for onlinedocs area
>     - make gzipped copies of all html files (for smart browsers)
>     - run makeinfo on just the install docs
>     - run the preprocessor on everything
>
> The third line is via gcc/doc/install.texi2html.
>
> I don't understand where/when/what the preprocessor does.  I picked a
> random html file under onlinedocs/gcc and it wasn't preprocessed, so I'm
> not sure what to do.

The preprocessor (wwwdocs:/bin/preprocess) takes a tree of web pages under
some source directory and preprocesses them into a destination directory.

On gcc.gnu.org these are /www/gcc/htdocs-preformatted (where the pages
checked out from CVS reside) and /www/gcc/htdocs, respectively.  The
stuff under onlinedocs is generated directly into /www/gcc/htdocs and
thus exempted from this preprocessing.

I may be missing some context, so if you'd like any further information
or help, just let me know!


(FWIW, I believe that several parts currently in libstdc++-v3/docs/html
really, really should be moved to wwwdocs; there is definitely some
duplication and inconsistency here wrt. the general web area. :-(

Some of the FAQ entries really do not make much sense or should be moved
to the GCC FAQ, in fact, given the general context of GCC. :-( )

Gerald
-- 
Gerald "Jerry" pfeifer@dbai.tuwien.ac.at http://www.dbai.tuwien.ac.at/~pfeifer/