<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Java API Reference Specialization</title>
</head>
<body><div><h1>Java API Reference Specialization</h1>
<p><strong>Purpose:</strong>
The Java API Reference specialization provides a basis for documenting
Java class libraries.
The specialization can be used or examined as an example of how to
extend the base API Reference specialization.
</p>
<p><strong>Prerequisite:</strong>
API Reference specialization.
</p>
<p>You can view the <a href="doc/frameset.html">reference
documentation</a> for the Java API Reference specialization.</p>
<div><h2>Building</h2>
<p>The Java API Reference specialization provides the conductor.xml file
to extend the base Ant targets with the following build targets:</p>
<dl>
<dt>javaref2xhtml</dt>
<dd>Build the Java API map for a sample Java package to XHTML.</dd>
</dl>
<p>The run-ant.xml file executes this build targets on the sample
content.</p>
<p>You should run the sample Ant build from the base directory for the DITA
Open Toolkit, using a relative path to the Java API Reference specialization:</p>
<pre>ant -f demo\javaapiref\install_plugin.xml
ant -f demo\javaapiref\run_ant.xml <i>optionalTarget</i></pre>
<p>You need only execute the install_plugin.xml file after initial
installation or update of any plugin.</p>
</div>
<div><h2>Contents</h2><p>The specialization includes subdirectories
with the following contents:</p><dl>
<dt>doc</dt>
<dd>The source files and output for the documentation.</dd>
<dt>dtd</dt>
<dd>DTDs for the document type for the API Reference specialization.</dd>
<dt>out</dt>
<dd>Formatted sample output files from the Ant build.</dd>
<dt>sample</dt>
<dd>Source files for an example of package content.</dd>
<dt>xsd</dt>
<dd>XML Schemas for the document type for the API Reference specialization.</dd>
<dt>xsl</dt>
<dd>Transforms for producing the output of the Ant build.</dd>
</dl></div>
<div><h2>Contributors</h2><p>Erik Hennum, Dennis Grace, Mariana Alupului,
Michael Priestley, Michelle C Carey, Nigel Hopper, Rob Pierce, and
Robert D Anderson</p>
</div>
</div>
</body>
</html>