<sect1 id="docdepend">
  <title>Documentation Dependencies</title>
  
  <para>
    The following packages are used to build &app;'s documentation.
  </para>
  
  <table frame='all' id="docdeps">
    <title>Documentation Dependency Table</title>
    <tgroup cols='7' align='left' colsep='1' rowsep='1'>
      <thead>
	<row>
	  <entry>Name</entry>
	  <entry>Level</entry>
	  <entry>Version</entry>
	  <entry>Description</entry>
	  <entry>Explanation</entry>
	  <entry>apt-get package</entry>
	  <entry>RPM/Yum package</entry>
	  <entry>BSD package</entry>
	</row>
      </thead>
      
      <tbody>
	<row>
	  <entry>Docbook</entry>
	  <entry>Required</entry>
	  <entry></entry>
	  <entry>
	    <ulink type="http"
		   url="http://http://docbook.sourceforge.net/">Docbook</ulink> is
	    is an industry-standard XML format for technical
	    documentation.  You can download it from
	    <ulink type="http"
		   url="http://sourceforge.net/project/showfiles.php?group_id=21935#files">http://sourceforge.net/project/showfiles.php?group_id=21935#files</ulink>.
	  </entry>
	  <entry>
	    &app; documentation is written in Docbook.
	  </entry>
	  <entry>
	    <filename>docbook-utils</filename> and <filename>docbook-dsssl</filename>
	  </entry>
	  <entry>
	    <filename>docbook-dtd41-sgml</filename> and <filename>docbook-style-dsssl</filename>
	  </entry>
	  <entry>docbook</entry>
	</row>
	
	<row>
	  <entry>DocBook2X</entry>
	  <entry>Optional</entry>
	  <entry></entry>
	  <entry>
	    This software package converts Docbook documents to
	    the traditional man page format, GNU Texinfo
	    format, and HTML (via Texinfo) format.  
	    It is available at <ulink type="http" 
	    url="http://docbook2x.sourceforge.net/">http://docbook2x.sourceforge.net/</ulink>.
	  </entry>
	  <entry>
	    DocBook2X is required to produce HTML and Texinfo
	    formats.
	  </entry>
	  <entry><filename>docbook2x</filename></entry>
	  <entry><filename>docbook2x</filename></entry>
	  <entry><filename>docbook2x</filename></entry>
	</row>
	
	<row>
	  <entry>DocBook-utils</entry>
	  <entry>Optional</entry>
	  <entry></entry>
	  <entry>
	    This software package converts Docbook documents to
	    the traditional man page format, GNU Texinfo
	    format, and HTML (via Texinfo) format.  
	  </entry>
	  <entry>
	    DocBook-utils is required to produce HTML and Texinfo
	    formats.
	  </entry>
	  <entry><filename>docbook-utils</filename></entry>
	  <entry><filename>docbook-utils</filename></entry>
	  <entry><filename>docbook-utils</filename></entry>
	</row>
	
	<row>
	  <entry>Texinfo</entry>
	  <entry>Possibly Required</entry>
	  <entry></entry>
	  <entry>
	    Texinfo can be used to convert DocBook2X output
	    into GNU info pages.  You can download it from
	    <ulink type="http"
		   url="http://ftp.gnu.org/gnu/texinfo/">http://ftp.gnu.org/gnu/texinfo/</ulink>.
	  </entry>
	  <entry>
	    Texinfo is required if you wish to produce GNU info
	    pages.
	  </entry>
	  <entry><filename>texinfo</filename></entry>
	  <entry><filename>texinfo</filename></entry>
	  <entry><filename>texinfo</filename></entry>
	</row>
	
	<row>
	  <entry>FOP</entry>
	  <entry>Optional</entry>
	  <entry>0.20.5</entry>
	  <entry>
	    Formatting Objects Processor is a print formatter
	    driven by XSL formatting objects.  It is a Java
	    application which can output PDF, PCL, PS, SVG, XML,
	    Print, AWT, MIF, and Text.  It is available at
	    <ulink url="http://xmlgraphics.apache.org/fop/"
		   type="http">http://xmlgraphics.apache.org/fop/</ulink>.
	  </entry>
	  <entry>
	    FOP is required for PDF output.
	  </entry>
	  <entry><filename>fop</filename></entry>
	  <entry><filename>fop</filename></entry>
	  <entry><filename>fop</filename></entry>
	</row>
	
	<row>
	  <entry>Java (j2re)</entry>
	  <entry>Possibly Required</entry>
	  <entry></entry>
	  <entry>
	    FOP requires Sun's Java runtime (GCJ does not work with
	    FOP).  You can download it from
	    <ulink url="http://java.sun.com" type="http">http://java.sun.com</ulink>.
	  </entry>
	  <entry>
	    Sun's Java runtime (j2re) is required to use FOP.  
	  </entry>
	  <entry>
	    Download the package from <ulink type="http"
	    url="http://java.sun.com">Sun</ulink>.
	  </entry>
	  <entry>
	    Download the package from <ulink type="http"
	    url="http://java.sun.com">Sun</ulink>.
	  </entry>
	  <entry></entry>
	</row>
	
	<row>
	  <entry>JAI</entry>
	  <entry>Possibly Required</entry>
	  <entry></entry>
	  <entry>
	    Sun's Java Advanced Imaging API can be downloaded from
	    <ulink type="http" url="http://java.sun.com/products/java-media/jai/iio.html">http://java.sun.com/products/java-media/jai/iio.html</ulink>.
	  </entry>
	  <entry>
	    JAI is required
	    if you wish to include graphics in a PDF file being
	    generated with FOP.
	  </entry>
	  <entry>
	    Download the package from <ulink
	    url="http://java.sun.com/products/java-media/jai/iio.html"
	    type="http">Sun</ulink>.
	  </entry>
	  <entry>
	    Download the package from <ulink
	    url="http://java.sun.com/products/java-media/jai/iio.html"
	    type="http">Sun</ulink>.
	  </entry>
	  <entry></entry>
	</row>
	
      </tbody>
    </tgroup>
  </table>
  
  <para>
    If you install j2re, set the <emphasis>JAVA_HOME</emphasis>
    environment variable to the top directory of the j2re
    installation.  If you encounter problems with the Java
    installation, you may also need to add this path to the
    <emphasis>CLASSPATH</emphasis> environment variable.
  </para>
</sect1>
