This is the mail archive of the
libstdc++@gcc.gnu.org
mailing list for the libstdc++ project.
Re: PATCH: convert online docs to XHTML
- From: Phil Edwards <phil at jaj dot com>
- To: Jonathan Wakely <cow at compsoc dot man dot ac dot uk>
- Cc: libstdc++ at gcc dot gnu dot org
- Date: Thu, 5 Sep 2002 11:49:52 -0400
- Subject: Re: PATCH: convert online docs to XHTML
- References: <20020821105235.A6802@us.ibm.com> <Pine.SOL.4.44.0208212018040.14159-100000@yellow.csi.cam.ac.uk> <20020822162219.GA34051@compsoc.man.ac.uk> <20020831210153.A15798@disaster.jaj.com> <20020905095740.GA86221@compsoc.man.ac.uk>
On Thu, Sep 05, 2002 at 10:57:40AM +0100, Jonathan Wakely wrote:
> The attached bzip2'd patch is a 6000 line unified diff to convert the
> libstdc++-v3/docs/html tree to XHTML 1.0 Transitional, following the
> main GCC policy for the online docs.
> (I can submit it again as a context diff if preferred, but the unified
> diff is much smaller and IMHO is more readable for these HTML changes)
I like unified myself. This, and your previous change to html/Makefile,
is in. (I also regen'd faq/index.txt.)
> and license.html, I'm pretty confident those files aren't taken from
> upstream pkgs or auto-generated, so I'm assuming it's OK?
> I didn't change the LWG lists or auto-generated pages.
All good.
> All the pages validate as XHTML if they have the boilerplate header added
> to specify the DOCTYPE, XML namespace etc. so if this patch goes in the
> server can preprocess the libstdc++ pages (except for the four listed above
> that I didn't alter, not sure if they can be excluded easily?)
I'm now thinking that we might ought to add the XHTML boilerplate directly,
so that the pages are correctly viewable offline, without having to be
run through the webserver. A couple of distros have started packaging
the pages for local viewing.
Phil
--
I would therefore like to posit that computing's central challenge, viz. "How
not to make a mess of it," has /not/ been met.
- Edsger Dijkstra, 1930-2002