From 1f49d49464da2852d720da08e3e8970f09ad25c0 Mon Sep 17 00:00:00 2001
From: Tom Eastep <teastep@shorewall.net>
Date: Tue, 5 Jan 2010 07:40:18 -0800
Subject: [PATCH] Update Build Document

- Copyright
- Add additional options to build44
- Add warning about xmlto
- Correct a couple of typos

Signed-off-by: Tom Eastep <teastep@shorewall.net>
---
 docs/Build.xml | 39 +++++++++++++++++++++++++++------------
 1 file changed, 27 insertions(+), 12 deletions(-)

diff --git a/docs/Build.xml b/docs/Build.xml
index 109fa17c7..5c0598052 100644
--- a/docs/Build.xml
+++ b/docs/Build.xml
@@ -20,6 +20,8 @@
     <copyright>
       <year>2009</year>
 
+      <year>2010</year>
+
       <holder>Thomas M. Eastep</holder>
     </copyright>
 
@@ -201,7 +203,12 @@
           <term>xmlto (I use version 0.0.18-182.27)</term>
 
           <listitem>
-            <para>Required to convert the XML manpages to manpages.</para>
+            <para>Required to convert the XML manpages to manpages. Note that
+            not all versions of xmlto will work (those released by Debian and
+            Ubuntu, for example, do <emphasis>not</emphasis> work). If you
+            find that xmlto fails, install
+            tools<filename>/build/xmlto</filename> in <filename
+            class="directory">/usr/local/bin</filename>.</para>
           </listitem>
         </varlistentry>
       </variablelist>
@@ -249,14 +256,6 @@
           </listitem>
         </varlistentry>
 
-        <varlistentry>
-          <term>GPG</term>
-
-          <listitem>
-            <para>Command to be used for signing your packages</para>
-          </listitem>
-        </varlistentry>
-
         <varlistentry>
           <term>GIT</term>
 
@@ -336,6 +335,22 @@
                   <para>Build the shorewall6-lite package.</para>
                 </listitem>
               </varlistentry>
+
+              <varlistentry>
+                <term>h</term>
+
+                <listitem>
+                  <para>Build the html document package.</para>
+                </listitem>
+              </varlistentry>
+
+              <varlistentry>
+                <term>x</term>
+
+                <listitem>
+                  <para>Build the xml document package.</para>
+                </listitem>
+              </varlistentry>
             </variablelist>
           </listitem>
         </varlistentry>
@@ -437,7 +452,7 @@
           <term><emphasis>release</emphasis></term>
 
           <listitem>
-            <para>The version number of the release to update.</para>
+            <para>The version number of the release to upload.</para>
           </listitem>
         </varlistentry>
       </variablelist>
@@ -445,13 +460,13 @@
       <para>Example 1 - Upload release 4.3.7:</para>
 
       <blockquote>
-        <para><command>upload 4.3.7</command></para>
+        <para><command>upload44 4.3.7</command></para>
       </blockquote>
 
       <para>Example 2 - Upload shorewall-perl-4.3.7.3:</para>
 
       <blockquote>
-        <para><command>upload -p 4.3.7.3</command></para>
+        <para><command>upload44 -p 4.3.7.3</command></para>
       </blockquote>
     </section>
   </section>