documentation_hacking.xml: Fix validation issue.

2012-12-12  Benjamin Kosnik  <bkoz@redhat.com>

	* doc/xml/manual/documentation_hacking.xml: Fix validation issue.

From-SVN: r194455

diff --git a/libstdc++-v3/ChangeLog b/libstdc++-v3/ChangeLog
index 324ef51066e28da2ea547c078a21e411d69fcd20..bde112313576986058e1e4f792256b14d0e2eb3e 100644 (file)
--- a/libstdc++-v3/ChangeLog
+++ b/libstdc++-v3/ChangeLog
@@ -1,3 +1,7 @@
+2012-12-12  Benjamin Kosnik  <bkoz@redhat.com>
+
+       * doc/xml/manual/documentation_hacking.xml: Fix validation issue.
+
 2012-12-11  Jonathan Wakely  <jwakely.gcc@gmail.com>
 
        PR libstdc++/55631

diff --git a/libstdc++-v3/doc/xml/manual/documentation_hacking.xml b/libstdc++-v3/doc/xml/manual/documentation_hacking.xml
index 91d16dd352994032e078c1c4042d9def15c1b8b1..05c05a636ec0bc0435e6acf50c2434ae8c7ec1cf 100644 (file)
--- a/libstdc++-v3/doc/xml/manual/documentation_hacking.xml
+++ b/libstdc++-v3/doc/xml/manual/documentation_hacking.xml
@@ -383,6 +383,8 @@
 <listitem>
   <para>
    <emphasis>refman.out</emphasis>
+  </para>
+
   <para>
     A log of the compilation of the converted LaTeX form to pdf. This
     is a linear list, from the beginning of the
@@ -394,10 +396,20 @@
     incorrect, or will have clues at the end of the file with the dump
     of the memory usage of LaTeX.
   </para>
-  </para>
 </listitem>
 </itemizedlist>
 
+       <para>
+         If the error at hand is not obvious after examination, a
+         fall-back strategy is to start commenting out the doxygen
+         input sources, which can be found in
+         <filename>doc/doxygen/user.cfg.in</filename>, look for the
+         <literal>INPUT</literal> tag. Start by commenting out whole
+         directories of header files, until the offending header is
+         identified. Then, read the latex log files to try and find
+         surround text, and look for that in the offending header.
+       </para>
+
  </section>
 
     <section xml:id="doxygen.markup"><info><title>Markup</title></info>
@@ -872,7 +884,7 @@ make <literal>XSL_STYLE_DIR="/usr/share/xml/docbook/stylesheet/nwalsh"</literal>
 </itemizedlist>
 
        <para>
-         If the issue is not obvious after examination, or if one
+         If the error at hand is not obvious after examination, or if one
          encounters the inscruitable <quote>Incomplete
          \ifmmode</quote> error, a fall-back strategy is to start
          commenting out parts of the XML document (regardless of what