]> source.dussan.org Git - xmlgraphics-fop.git/commitdiff
Add API doc.
authorWilliam Victor Mote <vmote@apache.org>
Mon, 5 May 2003 18:57:02 +0000 (18:57 +0000)
committerWilliam Victor Mote <vmote@apache.org>
Mon, 5 May 2003 18:57:02 +0000 (18:57 +0000)
git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@196400 13f79535-47bb-0310-9956-ffa450edef68

src/documentation/content/xdocs/dev/api-doc.xml [new file with mode: 0644]
src/documentation/content/xdocs/dev/book.xml

diff --git a/src/documentation/content/xdocs/dev/api-doc.xml b/src/documentation/content/xdocs/dev/api-doc.xml
new file mode 100644 (file)
index 0000000..4c06c0a
--- /dev/null
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN"
+    "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/resources/schema/dtd/document-v11.dtd">
+<document>
+  <header>
+    <title>FOP API Documentation (javadocs)</title>
+  </header>
+  <body>
+    <section id="gump">
+      <title>On-line Access (through Gump)</title>
+      <p>FOP (and many other Apache projects) use <link href="http://jakarta.apache.org/gump">Apache Gump</link> to do a test build several times each day. One of the useful byproducts of this process is that javadocs can be created and made available.</p>
+      <p>First, determine which line of development code you wish to see. If you don't know, you probably want the "Maintenance Branch", which is the line that currently produces FOP releases. See <link href="index.html#lines">Development Lines</link> for more details.</p>
+      <warning>Javadocs for both development lines are made from current CVS code, and are not tied to any particular release. Both the documentation and the API may be different, even if you are working with the correct branch. Currently, the only way to obtain API documentation for a specific release is to <link href="#self-built">build it yourself</link>.</warning>
+      <ul>
+        <li><link href="http://nagoya.apache.org/gump/javadoc/xml-fop-maintenance/build/javadocs/index.html">Javadocs for Maintenance Branch</link></li>
+        <li><link href="http://nagoya.apache.org/gump/javadoc/xml-fop/build/javadocs/index.html">Javadocs for Trunk (Redesign)</link></li>
+      </ul>
+      <note>If the links return an "Object not found!" message or otherwise do not work properly, it is probably because of a build error. Please raise a question on the <link href="../resources.html#mailing-lists-fop-user">fop-user mailing list</link> so that any problems can be fixed before the next build.</note>
+    </section>
+    <section id="self-built">
+      <title>Building them Yourself</title>
+      <p>See <link href="../download.html#source">Source Download</link> for instructions on obtaining the source code. Then see "Building FOP" for instructions on running the build process. The Ant build target that you will use to generate the API documentation is "javadocs", and the results will be stored in xml-fop/build/javadocs.</p>
+    </section>
+  </body>
+</document>
index 46825bf59d774096fc0d5eec0821741e1d9f79c2..7d0935549dd1e939ad91ae4f5a9c3aecb66c4eaa 100644 (file)
@@ -18,6 +18,7 @@
       <menu-item label="Extensions" href="extensions.html"/>
     </menu>
     <menu label="Develop">
+      <menu-item label="API Doc" href="api-doc.html"></menu-item>
       <menu-item label="Walk-Thru" href="implement.html"/>
       <external label="Patch queue" href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;email1=&amp;emailtype1=substring&amp;emailassigned_to1=1&amp;email2=&amp;emailtype2=substring&amp;emailreporter2=1&amp;bugidtype=include&amp;bug_id=&amp;changedin=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;product=Fop&amp;short_desc=%5BPATCH%5D&amp;short_desc_type=allwordssubstr&amp;long_desc=&amp;long_desc_type=allwordssubstr&amp;bug_file_loc=&amp;bug_file_loc_type=allwordssubstr&amp;keywords=&amp;keywords_type=anywords&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=&amp;namedcmd=Fop+all&amp;newqueryname=fop+patch+queue&amp;tofooter=1&amp;order=Reuse+same+sort+as+last+time"/>
     </menu>