Changeset 3156

Timestamp:

Mar 5, 2007, 1:47:18 PM (16 years ago)

Author:

Nicklas Nordborg

Message:

Added info about how to build the docbook documentation.
Clean up files before building documentation.

Location:

trunk

Files:

• build.xml (modified) (2 diffs)
• doc/development/build.html (modified) (1 diff)

trunk/build.xml

@@ -122 +122 @@
       <fileset dir="www/WEB-INF" includes="web.xml" defaultexcludes="no" />
       <fileset dir="doc/api" defaultexcludes="no" />
+      <fileset dir="doc/docbook" defaultexcludes="no" />
       <fileset file="doc/development/plugins/exampleplugins.tar.gz" />
     </delete>
@@ -1005 +1006 @@
     <mkdir dir="${doc}/docbook" />
     <mkdir dir="${build}/docbook" />
-    <delete dir="${build}/docbook" includes="**/*.*" />
+    <delete description="Delete existing documents">
+      <fileset dir="${build}/docbook" defaultexcludes="no" />
+      <fileset dir="${doc}/docbook" defaultexcludes="no" />
+    </delete>
     <ant antfile="${lib}/docbook/ant-build-docbook.xml" inheritall="false" target="html.chunked">
       <property name="ant.docbook.styler.dir" location="${lib}/docbook" />

trunk/doc/development/build.html

@@ -245 +245 @@
     Generate documentation for local use.
   </dd>
+  
+  <dt>ant docbook</dt>
+  <dd>
+    Temporary target for generating the docbook-based user documentation.
+    In the future this will be included in the 'ant doc' target. Note!
+    Docbook will work with pure Java but performance is a lot better if
+    <a href="http://xmlsoft.org/XSLT/">XSLTPROC</a> is installed. The 
+    documentation is generated in the directory 'doc/docbook'.
+  </dd>
   </dl>