* doc/xml/manual/documentation_hacking.xml: Fix invalid attribute.

[pf3gnuchains/gcc-fork.git] / libstdc++-v3 / doc / xml / manual / documentation_hacking.xml

diff --git a/libstdc++-v3/doc/xml/manual/documentation_hacking.xml b/libstdc++-v3/doc/xml/manual/documentation_hacking.xml
index 7b2ed7c..e74f2b7 100644 (file)
--- a/libstdc++-v3/doc/xml/manual/documentation_hacking.xml
+++ b/libstdc++-v3/doc/xml/manual/documentation_hacking.xml
@@ -242,7 +242,7 @@
 
     <row>
       <entry>doxygen</entry>
-      <entry>1.7.0</entry>
+      <entry>1.7.6.1</entry>
       <entry>all</entry>
     </row>
 
@@ -280,6 +280,16 @@
        output, <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.tug.org/applications/pdftex/">
        pdflatex</link> is required.
       </para>
+
+      <para>
+       Be warned the PDF file generated via doxygen is extremely
+       large. At last count, the PDF file is over three thousand
+       pages. Generating this document taxes the underlying TeX
+       formatting system, and will require the expansion of TeX's memory
+       capacity. Specifically, the <literal>pool_size</literal>
+       variable in the configuration file <filename>texmf.cnf</filename> may
+       need to be increased by a minimum factor of two.
+      </para>
     </section>
 
     <section xml:id="doxygen.rules"><info><title>Generating the Doxygen Files</title></info>
@@ -611,6 +621,12 @@
       <entry>info output</entry>
     </row>
 
+    <row>
+      <entry>epub3 stylesheets</entry>
+      <entry>b3</entry>
+      <entry>epub output</entry>
+    </row>
+
   </tbody>
 </tgroup>
 </table>
@@ -648,7 +664,7 @@
       </para>
 
       <para>
-       For processing XML, an XML processor and some style
+       For processing XML, an XSLT processor and some style
        sheets are necessary. Defaults are <command>xsltproc</command>
        provided by <filename>libxslt</filename>.
       </para>
@@ -675,6 +691,10 @@
        For Texinfo output, something that transforms valid Docbook
        XML to Texinfo is required. The default choice is <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://docbook2x.sourceforge.net/">docbook2X</link>.
       </para>
+
+      <para>
+       For epub output, the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://sourceforge.net/projects/docbook/files/epub3/">stylesheets</link> for EPUB3 are required. These stylesheets are still in development. To validate the created file, <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://code.google.com/p/epubcheck/">epubcheck</link> is necessary.
+      </para>
     </section>
 
     <section xml:id="docbook.rules"><info><title>Generating the DocBook Files</title></info>
@@ -711,7 +731,7 @@
       <para>
        If the Docbook stylesheets are installed in a custom location,
        one can use the variable <literal>XSL_STYLE_DIR</literal> to
-       over-ride the Makefile defaults. As so:
+       override the Makefile defaults. For example:
       </para>
 
       <screen>