This is the mail archive of the
libstdc++@gcc.gnu.org
mailing list for the libstdc++ project.
Re: HTML docs
- From: Gerald Pfeifer <pfeifer at dbai dot tuwien dot ac dot at>
- To: Phil Edwards <phil at jaj dot com>
- Cc: Jonathan Wakely <cow at compsoc dot man dot ac dot uk>, <libstdc++ at gcc dot gnu dot org>, Janis Johnson <janis187 at us dot ibm dot com>, "Joseph S. Myers" <jsm28 at cam dot ac dot uk>
- Date: Wed, 11 Sep 2002 12:49:00 +0200 (CEST)
- Subject: Re: HTML docs
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/