From f52f03c86c7daba3035aaba86f6de8141c30285b Mon Sep 17 00:00:00 2001
From: Benjamin Kosnik <bkoz@redhat.com>
Date: Wed, 12 Dec 2012 22:15:30 +0000
Subject: [PATCH] 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
---
libstdc++-v3/ChangeLog | 4 ++++
.../doc/xml/manual/documentation_hacking.xml | 16 ++++++++++++++--
2 files changed, 18 insertions(+), 2 deletions(-)
diff --git a/libstdc++-v3/ChangeLog b/libstdc++-v3/ChangeLog
index 324ef51066e2..bde112313576 100644
--- 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 91d16dd35299..05c05a636ec0 100644
--- 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
--
GitLab