diff options
| author | Benjamin Kosnik <bkoz@redhat.com> | 2012-12-12 22:15:30 +0000 |
|---|---|---|
| committer | Benjamin Kosnik <bkoz@gcc.gnu.org> | 2012-12-12 22:15:30 +0000 |
| commit | f52f03c86c7daba3035aaba86f6de8141c30285b (patch) | |
| tree | 251d825ae180a6d4b025b94adb978586193b1b36 | |
| parent | 71c753d013e39fa69eacaade2a853d3102414fd3 (diff) | |
| download | gcc-f52f03c86c7daba3035aaba86f6de8141c30285b.zip gcc-f52f03c86c7daba3035aaba86f6de8141c30285b.tar.gz gcc-f52f03c86c7daba3035aaba86f6de8141c30285b.tar.bz2 | |
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
| -rw-r--r-- | libstdc++-v3/ChangeLog | 4 | ||||
| -rw-r--r-- | libstdc++-v3/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 324ef51..bde1123 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 91d16dd..05c05a6 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 |