<?php
  include "corefunctions.php";
?>

<?php pageHeader("Documentation"); ?>

<body>

<div id="pagewrapper">

	<?php pageMenu("documentation"); ?>

	<div id="contentwrapper">
		<div id="leftside">
			<h3>PLplot Documentation</h3>
			<ul class="arrowlist">
	      <li> <a href="docbook-manual/@BASE_HTML@">Browse the latest on-line documentation</a> </li>
	      <li> <a href="docbook-manual/@BASE@.ps.gz">PostScript form of documentation (<?php $size = number_format((filesize("docbook-manual/@BASE@.ps.gz")/1024/1024),2); echo $size;?> MB)</a> </li>
	      <li> <a href="docbook-manual/@BASE@.pdf">PDF form of documentation (<?php $size = number_format((filesize("docbook-manual/@BASE@.pdf")/1024/1024),2); echo $size;?> MB)</a> </li>
	      <li> <a href="docbook-manual/@BASE@.dvi">DVI form of documentation (<?php $size = number_format((filesize("docbook-manual/@BASE@.dvi")/1024/1024),2); echo $size;?> MB)</a> </li>
	      <li> <a href="docbook-manual/@BASE_INFO@.tar.gz">Info documentation tarball (<?php $size = number_format((filesize("docbook-manual/@BASE_INFO@.tar.gz")/1024/1024),2); echo $size;?> MB)</a> </li>
	      <li> <a href="docbook-manual/@BASE_MAN@.tar.gz">Man pages tarball (API chapter in nroff format) (<?php $size = number_format((filesize("docbook-manual/@BASE_MAN@.tar.gz")/1024/1024),2); echo $size;?> MB)</a> </li>
	      <li> <a href="docbook-manual/@BASE_HTML@.tar.gz">HTML results tarball (<?php $size = number_format((filesize("docbook-manual/@BASE_HTML@.tar.gz")/1024/1024),2); echo $size;?> MB)</a> </li>
			</ul>
<p>
The documentation results above have been generated from our DocBook/XML source files in doc/docbook/src using a variety of DocBook backend tools.  The documentation build happens automatically (only on Linux since the required tools are only available for that O/S) with our CMake-based build system if you specify the cmake option -DBUILD_DOC=ON.  For more details about building this documentation and testing it, please look at the file doc/docbook/README.developers in the source tree.
</p>
<p>
For those wishing to make some contribution to PLplot, helping out with the documentation is a good place to start.  DocBook/XML syntax is quite straightforward to understand if you simply follow the form of what is already done in the files in the doc/docbook/src subdirectory of the source tree. However, if you want to dig a little deeper into DocBook, then this on-line book, <a href="http://www.docbook.org/tdg/en/html/docbook.html">"DocBook: The Definitive Guide"</a>, is an excellent reference.
</p>
		</div>

		<?php pageSidebar(1); ?>

		<div id="spacer"></div>
	</div>

	<?php pageFooter(); ?>
</div>

</body>
</html>
