[PATCH v3] libstdc++ xml doc typos

[Benjamin Kosnik]

> 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