From b1e7ffb46e1b3fcfea1bc83ea0577e122fc3a089 Mon Sep 17 00:00:00 2001
From: William Victor Mote <vmote@apache.org>
Date: Mon, 7 Jul 2003 02:09:24 +0000
Subject: [PATCH] Place RTFLib into its own group for purposes of javadoc
 generation. Add package.html files for the RTFLib packages.

git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@196630 13f79535-47bb-0310-9956-ffa450edef68
---
 build.xml                                     | 30 +++++++++++--------
 .../fop/rtf/rtflib/exceptions/package.html    |  6 ++++
 .../fop/rtf/rtflib/interfaces/package.html    |  6 ++++
 .../org/apache/fop/rtf/rtflib/package.html    |  7 +++++
 .../apache/fop/rtf/rtflib/rtfdoc/package.html |  7 +++++
 .../fop/rtf/rtflib/testdocs/package.html      |  8 +++++
 .../apache/fop/rtf/rtflib/tools/package.html  |  6 ++++
 7 files changed, 57 insertions(+), 13 deletions(-)
 create mode 100644 src/java/org/apache/fop/rtf/rtflib/exceptions/package.html
 create mode 100644 src/java/org/apache/fop/rtf/rtflib/interfaces/package.html
 create mode 100644 src/java/org/apache/fop/rtf/rtflib/package.html
 create mode 100644 src/java/org/apache/fop/rtf/rtflib/rtfdoc/package.html
 create mode 100644 src/java/org/apache/fop/rtf/rtflib/testdocs/package.html
 create mode 100644 src/java/org/apache/fop/rtf/rtflib/tools/package.html

diff --git a/build.xml b/build.xml
index 923b9bf7c..fa32e5f35 100644
--- a/build.xml
+++ b/build.xml
@@ -40,8 +40,8 @@ list of possible build targets.
   <!-- build-local.properties is not stored in CVS and overrides values from build.properties -->
   <property file="${basedir}/build-local.properties"/>
   <property file="${basedir}/build.properties"/>
-  
-  <property name="optional.lib.dir" value="${basedir}/lib"/>  
+
+  <property name="optional.lib.dir" value="${basedir}/lib"/>
 
   <fileset dir="${basedir}" id="dist.bin">
     <include name="conf/**"/>
@@ -135,11 +135,11 @@ list of possible build targets.
     <include name="**/*.java"/>
     <exclude name="**/*${ignore_this}"/>
   </patternset>
-  
+
   <patternset id="graphics-configuration-source">
     <include name="org/apache/fop/svg/GraphicsConfiguration.java"/>
   </patternset>
-  
+
 
   <!-- =================================================================== -->
   <!-- Initialization target                                               -->
@@ -244,7 +244,7 @@ list of possible build targets.
 
   <target name="init-avail">
     <echo message="${ant.version}"/>
-    
+
     <available property="jimi.present" classname="com.sun.jimi.core.Jimi"
         classpathref="libs-build-classpath"/>
     <condition property="jimi.message" value="Jimi Support PRESENT">
@@ -256,7 +256,7 @@ list of possible build targets.
       </not>
     </condition>
     <echo message="${jimi.message}"/>
-    
+
     <available property="jai.present" classname="javax.media.jai.JAI"
         classpathref="libs-build-classpath"/>
     <condition property="jai.message" value="JAI Support PRESENT">
@@ -268,7 +268,7 @@ list of possible build targets.
       </not>
     </condition>
     <echo message="${jai.message}"/>
-    
+
     <available property="jce.present" classname="javax.crypto.Cipher"
         classpathref="libs-build-classpath"/>
     <condition property="jce.message" value="JCE Support PRESENT">
@@ -280,9 +280,9 @@ list of possible build targets.
       </not>
     </condition>
     <echo message="${jce.message}"/>
-    
+
     <available property="jdk14.present" classname="java.lang.CharSequence"/>
-    
+
     <available property="junit.present" classname="junit.framework.TestCase"
         classpathref="libs-build-classpath"/>
     <condition property="junit.message" value="JUnit Support PRESENT">
@@ -640,7 +640,7 @@ list of possible build targets.
 -->
   </target>
   <target name="junit" depends="package, transcoder-pkg" description="Runs FOP's JUnit tests" if="junit.present">
-    <mkdir dir="${build.dir}/test-classes"/> 
+    <mkdir dir="${build.dir}/test-classes"/>
     <javac destdir="${build.dir}/test-classes" debug="${debug}" deprecation="${deprecation}" optimize="${optimize}">
       <src path="${basedir}/test/java"/>
       <classpath>
@@ -651,7 +651,7 @@ list of possible build targets.
       </classpath>
     </javac>
     <echo message="Running basic functionality tests for fop-transcoder.jar"/>
-    <mkdir dir="${build.dir}/test-reports/fop-transcoder"/> 
+    <mkdir dir="${build.dir}/test-reports/fop-transcoder"/>
     <junit>
       <sysproperty key="basedir" value="${basedir}"/>
       <formatter type="plain"/>
@@ -669,7 +669,7 @@ list of possible build targets.
       </batchtest>
     </junit>
     <echo message="Running basic functionality tests for fop-transcoder-allinone.jar"/>
-    <mkdir dir="${build.dir}/test-reports/fop-transcoder-allinone"/> 
+    <mkdir dir="${build.dir}/test-reports/fop-transcoder-allinone"/>
     <junit>
       <sysproperty key="basedir" value="${basedir}"/>
       <formatter type="plain"/>
@@ -689,7 +689,7 @@ list of possible build targets.
       </batchtest>
     </junit>
     <echo message="Running basic functionality tests for fop.jar"/>
-    <mkdir dir="${build.dir}/test-reports/fop"/> 
+    <mkdir dir="${build.dir}/test-reports/fop"/>
     <junit>
       <sysproperty key="basedir" value="${basedir}"/>
       <formatter type="plain"/>
@@ -781,6 +781,10 @@ list of possible build targets.
         <package name="org.apache.fop.fonts.*"/>
         <package name="org.apache.fop.util"/>
       </group>
+      <group title="RTFLib (formerly JFor) Subpackage Candidate">
+        <package name="org.apache.fop.rtf.rtflib"/>
+        <package name="org.apache.fop.rtf.rtflib.*"/>
+      </group>
     </javadoc>
   </target>
 
diff --git a/src/java/org/apache/fop/rtf/rtflib/exceptions/package.html b/src/java/org/apache/fop/rtf/rtflib/exceptions/package.html
new file mode 100644
index 000000000..cc91506e8
--- /dev/null
+++ b/src/java/org/apache/fop/rtf/rtflib/exceptions/package.html
@@ -0,0 +1,6 @@
+<HTML>
+<TITLE>org.apache.fop.rtf.rtflib.exceptions</TITLE>
+<BODY>
+<P>Classes handling specialized exceptions that arise during RTF creation.</P>
+</BODY>
+</HTML>
\ No newline at end of file
diff --git a/src/java/org/apache/fop/rtf/rtflib/interfaces/package.html b/src/java/org/apache/fop/rtf/rtflib/interfaces/package.html
new file mode 100644
index 000000000..dce8dd0c9
--- /dev/null
+++ b/src/java/org/apache/fop/rtf/rtflib/interfaces/package.html
@@ -0,0 +1,6 @@
+<HTML>
+<TITLE>org.apache.fop.rtf.rtflib.interfaces</TITLE>
+<BODY>
+<P>Interfaces used to build RTF documents.</P>
+</BODY>
+</HTML>
\ No newline at end of file
diff --git a/src/java/org/apache/fop/rtf/rtflib/package.html b/src/java/org/apache/fop/rtf/rtflib/package.html
new file mode 100644
index 000000000..6b77e6078
--- /dev/null
+++ b/src/java/org/apache/fop/rtf/rtflib/package.html
@@ -0,0 +1,7 @@
+<HTML>
+<TITLE>org.apache.fop.rtf.rtflib</TITLE>
+<BODY>
+<P>Classes used to build RTF documents in a generic way, i.e. they are usable by
+systems other than FOP.</P>
+</BODY>
+</HTML>
\ No newline at end of file
diff --git a/src/java/org/apache/fop/rtf/rtflib/rtfdoc/package.html b/src/java/org/apache/fop/rtf/rtflib/rtfdoc/package.html
new file mode 100644
index 000000000..55f3ce488
--- /dev/null
+++ b/src/java/org/apache/fop/rtf/rtflib/rtfdoc/package.html
@@ -0,0 +1,7 @@
+<HTML>
+<TITLE>org.apache.fop.rtf.rtflib.rtfdoc</TITLE>
+<BODY>
+<P>Independent subsystem (not specific to FOP) classes that are used to build
+RTF documents.</P>
+</BODY>
+</HTML>
\ No newline at end of file
diff --git a/src/java/org/apache/fop/rtf/rtflib/testdocs/package.html b/src/java/org/apache/fop/rtf/rtflib/testdocs/package.html
new file mode 100644
index 000000000..54da43c68
--- /dev/null
+++ b/src/java/org/apache/fop/rtf/rtflib/testdocs/package.html
@@ -0,0 +1,8 @@
+<HTML>
+<TITLE>org.apache.fop.rtf.rtflib.testdocs</TITLE>
+<BODY>
+<P>Classes used to test/demonstrate RTFLib capabilities by generating sample
+RTF documents.
+systems other than FOP.</P>
+</BODY>
+</HTML>
\ No newline at end of file
diff --git a/src/java/org/apache/fop/rtf/rtflib/tools/package.html b/src/java/org/apache/fop/rtf/rtflib/tools/package.html
new file mode 100644
index 000000000..d53e21bcc
--- /dev/null
+++ b/src/java/org/apache/fop/rtf/rtflib/tools/package.html
@@ -0,0 +1,6 @@
+<HTML>
+<TITLE>org.apache.fop.rtf.rtflib.tools</TITLE>
+<BODY>
+<P>Utility classes used in RTF file generation.</P>
+</BODY>
+</HTML>
\ No newline at end of file
-- 
2.39.5