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: Tue, 25 Mar 2008 10:46:56 -0500
- Subject: Re: [PATCH v3] libstdc++ xml doc typos
- References: <20080324171519.GC3858@ins.uni-bonn.de>
> Tested 'make doc-html-doxygen doc-man-doxygen doc-xml-doxygen'
> in $host/libstdc++-v3/doc, is that enough? doc-html and doc-pdf
> did not work for me, presumably due to Debian's differently named
> xml support files.
The include/* source files are really the only input for the doxygen
markup. So, the doc-*-doxygen rules don't especially matter for edits in the
docbook xml files. Although running them certainly doesn't hurt.
;)
doc-html is the rule that would regenerate the html files for you.
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'?
If you need to point to a different stylesheet location, you could use
something like
make XSL_STYLE_DIR=/path/to/stylesheetdirectory doc-html
or
make XSL_HTML_STYLE=/path/to/chunk.xsl doc-html
Can you try this and see if you can get it to work please?
doc-pdf is still a work in progress. See some of the LF summer of code
commentary for more background. I'm hoping somebody works on this for
SoC, or that the LF tries to improve this for everybody:
https://lists.linux-foundation.org/pipermail/lsb-discuss/2008-March/004795.html
> Please note that bitmap_allocator changes are a bit more than mere
> typos.
>
> OK for trunk? In case I have to commit regenerated files, can
> somebody apply the patch for me?
This is ok for trunk and gcc-4_3-branch: thanks again for all your
excellent help on the docs.
If you cannot regenerate, I'll do this for you.
-benjamin