This is the mail archive of the
libstdc++@gcc.gnu.org
mailing list for the libstdc++ project.
Re: [PATCH v3] libstdc++ xml doc typos
- From: Ralf Wildenhues <Ralf dot Wildenhues at gmx dot de>
- To: Benjamin Kosnik <bkoz at redhat dot com>
- Cc: gcc-patches at gcc dot gnu dot org, libstdc++ at gcc dot gnu dot org
- Date: Fri, 11 Apr 2008 20:14:46 +0200
- Subject: Re: [PATCH v3] libstdc++ xml doc typos
- References: <20080324171519.GC3858@ins.uni-bonn.de> <20080325104656.1db600bc@wabash.artheist.org> <20080410172152.29e17a50@wabash.artheist.org>
Hello Benjamin,
* Benjamin Kosnik wrote on Fri, Apr 11, 2008 at 12:21:52AM CEST:
>
> Sorry about the delay here. Attached as checked in.
Thanks, and sorry about not having gotten back to you before.
> > I would like to make sure that others can regenerate the
> > html files. Certainly, some improvement is needed. What kind of error
> > do you get when you try to do 'make doc-html'?
>
> Anybody? I just need to make sure it works for somebody else.
Generating html files...
xsltproc --nonet --xinclude -o /home/ralf/download/cvs/gcc/build/i686-pc-linux-gnu/libstdc++-v3/doc/html/ \
/usr/share/sgml/docbook/xsl-stylesheets/xhtml/chunk.xsl ../../../../gcc/libstdc++-v3/doc/xml/spine.xml
warning: failed to load external entity "/usr/share/sgml/docbook/xsl-stylesheets/xhtml/chunk.xsl"
cannot parse /usr/share/sgml/docbook/xsl-stylesheets/xhtml/chunk.xsl
make: *** [doc-html] Fehler 4
> If you need to point to a different stylesheet location, you could use
> something like
>
> make XSL_STYLE_DIR=/path/to/stylesheetdirectory doc-html
> Can you try this and see if you can get it to work please?
$ make doc-html XSL_STYLE_DIR=/usr/share/xml/docbook/stylesheet/nwalsh
works, but the result is slightly different than what is checked in, and
also things are generated in the build tree and not in the source tree.
As far as I can see, the differences are mostly in anchor ids:
| Only in ../../../../gcc/libstdc++-v3/doc/html/: README
| diff -r ../../../../gcc/libstdc++-v3/doc/html/api.html html/api.html
| 8c8
| < </p></div><div><div class="legalnotice"><a id="id478877"></a><p>
| ---
| > </p></div><div><div class="legalnotice"><a id="id2688074"></a><p>
| Only in ../../../../gcc/libstdc++-v3/doc/html/: ext
| Only in ../../../../gcc/libstdc++-v3/doc/html/: index.html
| diff -r ../../../../gcc/libstdc++-v3/doc/html/manual/abi.html html/manual/abi.html
[...]
Do these matter, or have I maybe used the wrong XSLT? If the latter,
I'd appreciate if someone knew the package I'd need to install.
Cheers,
Ralf