Skip to content
Snippets Groups Projects
Commit f52f03c8 authored by Benjamin Kosnik's avatar Benjamin Kosnik Committed by Benjamin Kosnik
Browse files

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
parent 71c753d0
No related branches found
No related tags found
No related merge requests found
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> 2012-12-11 Jonathan Wakely <jwakely.gcc@gmail.com>
PR libstdc++/55631 PR libstdc++/55631
......
...@@ -383,6 +383,8 @@ ...@@ -383,6 +383,8 @@
<listitem> <listitem>
<para> <para>
<emphasis>refman.out</emphasis> <emphasis>refman.out</emphasis>
</para>
<para> <para>
A log of the compilation of the converted LaTeX form to pdf. This A log of the compilation of the converted LaTeX form to pdf. This
is a linear list, from the beginning of the is a linear list, from the beginning of the
...@@ -394,10 +396,20 @@ ...@@ -394,10 +396,20 @@
incorrect, or will have clues at the end of the file with the dump incorrect, or will have clues at the end of the file with the dump
of the memory usage of LaTeX. of the memory usage of LaTeX.
</para> </para>
</para>
</listitem> </listitem>
</itemizedlist> </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>
<section xml:id="doxygen.markup"><info><title>Markup</title></info> <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> ...@@ -872,7 +884,7 @@ make <literal>XSL_STYLE_DIR="/usr/share/xml/docbook/stylesheet/nwalsh"</literal>
</itemizedlist> </itemizedlist>
<para> <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 encounters the inscruitable <quote>Incomplete
\ifmmode</quote> error, a fall-back strategy is to start \ifmmode</quote> error, a fall-back strategy is to start
commenting out parts of the XML document (regardless of what commenting out parts of the XML document (regardless of what
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment