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: Benjamin Kosnik <bkoz at redhat dot com>
- To: Ralf Wildenhues <Ralf dot Wildenhues at gmx dot de>
- Cc: gcc-patches at gcc dot gnu dot org, libstdc++ at gcc dot gnu dot org
- Date: Fri, 18 Apr 2008 11:19:07 -0500
- 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> <20080411181446.GD17584@ins.uni-bonn.de>
> 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.
Yeah, I'm trying to make all generated documentation in the build tree,
not the source tree. Seems like the Right Thing To Do.
So, after the docbook html is generated, then I hand-copy the generated
html to the doc/html directory for checkin.
> 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.
That does matter a tiny bit, but it's just due to the different XSLT
package.
I am using:
docbook-style-xsl-1.73.2-5.fc8
You should be able to download them from:
http://sourceforge.net/project/showfiles.php?group_id=21935
best,
benjamin