This is the mail archive of the
libstdc++@gcc.gnu.org
mailing list for the libstdc++ project.
[v3] Fixes to libstdc++ manual XML files
- From: Rainer Orth <ro at CeBiTec dot Uni-Bielefeld dot DE>
- To: gcc-patches at gcc dot gnu dot org
- Cc: libstdc++ at gcc dot gnu dot org
- Date: Fri, 26 Mar 2010 17:25:23 +0100
- Subject: [v3] Fixes to libstdc++ manual XML files
I've just tried to get the libstdc++ XML manual into printable form, a
nightmarish experience if there ever was one ;-( I'll prefer TeXinfo
over DocBook every time.
Maybe it were just the tools I used (xsltproc and fop), but the error
messages in case of problems were completely useless (Java stack traces
instead of useful messages, error messages without line numbers etc.).
Ultimately, our local XML expert helped out and I found the problem
(which completely broke converting the XML to PDF): a table was
specified with less columns than it actually had. Once this was fixed
(and a few other tables were there were inconsistencies between the
table header and the colspecs present), I could finally get PDF. Though
still not neatly formatted, it is at least a start.
To spare others this journey, here's the patch.
Ok for mainline?
Rainer
--
-----------------------------------------------------------------------------
Rainer Orth, Center for Biotechnology, Bielefeld University
2010-03-26 Rainer Orth <ro@CeBiTec.Uni-Bielefeld.DE>
* doc/xml/manual/profile_mode.xml (Profile Diagnostics): Correct
cols.
* doc/xml/manual/using.xml (C++ 1998 Library Headers): Add missing
c5 colspec.
(C++ 1998 Library Headers for C Library Facilities): Likewise.
(C++ 200x Library Headers): Likewise.
diff -r feb9655fe2bd libstdc++-v3/doc/xml/manual/profile_mode.xml
--- a/libstdc++-v3/doc/xml/manual/profile_mode.xml Tue Mar 23 19:32:00 2010 +0100
+++ b/libstdc++-v3/doc/xml/manual/profile_mode.xml Fri Mar 26 17:12:05 2010 +0100
@@ -714,7 +714,7 @@
<table frame='all'>
<title>Profile Diagnostics</title>
-<tgroup cols='6' align='left' colsep='1' rowsep='1'>
+<tgroup cols='7' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'></colspec>
<colspec colname='c2'></colspec>
<colspec colname='c3'></colspec>
diff -r feb9655fe2bd libstdc++-v3/doc/xml/manual/using.xml
--- a/libstdc++-v3/doc/xml/manual/using.xml Tue Mar 23 19:32:00 2010 +0100
+++ b/libstdc++-v3/doc/xml/manual/using.xml Fri Mar 26 17:12:05 2010 +0100
@@ -128,6 +128,7 @@
<colspec colname='c2'></colspec>
<colspec colname='c3'></colspec>
<colspec colname='c4'></colspec>
+<colspec colname='c5'></colspec>
<tbody>
<row>
<entry><filename class="headerfile">algorithm</filename></entry>
@@ -187,6 +188,7 @@
<colspec colname='c2'></colspec>
<colspec colname='c3'></colspec>
<colspec colname='c4'></colspec>
+<colspec colname='c5'></colspec>
<tbody>
<row>
<entry><filename class="headerfile">cassert</filename></entry>
@@ -231,6 +233,7 @@
<colspec colname='c2'></colspec>
<colspec colname='c3'></colspec>
<colspec colname='c4'></colspec>
+<colspec colname='c5'></colspec>
<tbody>
<row>