[v3] Fixes to libstdc++ manual XML files

Rainer Orth ro@CeBiTec.Uni-Bielefeld.DE
Fri Mar 26 16:26:00 GMT 2010


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>



More information about the Gcc-patches mailing list