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: r194456
This commit is contained in:
Benjamin Kosnik 2012-12-12 22:17:29 +00:00 committed by Benjamin Kosnik
parent 5c21de3e60
commit 1910224ffb
2 changed files with 18 additions and 2 deletions

View File

@ -1,3 +1,7 @@
2012-12-12 Benjamin Kosnik <bkoz@redhat.com>
* doc/xml/manual/documentation_hacking.xml: Fix validation issue.
2012-12-10 Benjamin Kosnik <bkoz@redhat.com>
* doc/Makefile.am (xml_sources_manual): Add

View File

@ -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