From 3a97d59b04a15ea189aa38743cfd01825ed60c5a Mon Sep 17 00:00:00 2001
From: teastep <teastep@fbd18981-670d-0410-9b5c-8dc0c1a9a2bb>
Date: Sat, 6 Oct 2007 16:50:20 +0000
Subject: [PATCH] Document new 'debug' feature

git-svn-id: https://shorewall.svn.sourceforge.net/svnroot/shorewall/trunk@7430 fbd18981-670d-0410-9b5c-8dc0c1a9a2bb
---
 manpages-lite/shorewall-lite.xml | 58 ++++++++++++++++++++++++++++++++
 1 file changed, 58 insertions(+)

diff --git a/manpages-lite/shorewall-lite.xml b/manpages-lite/shorewall-lite.xml
index a27e6647b..2b039a9a7 100644
--- a/manpages-lite/shorewall-lite.xml
+++ b/manpages-lite/shorewall-lite.xml
@@ -17,6 +17,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>allow</option></arg>
@@ -27,6 +29,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>clear</option></arg>
@@ -35,6 +39,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>drop</option></arg>
@@ -45,6 +51,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>dump</option></arg>
@@ -57,6 +65,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>forget</option></arg>
@@ -67,6 +77,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>help</option></arg>
@@ -75,6 +87,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>hits</option></arg>
@@ -83,6 +97,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>ipcalc</option></arg>
@@ -99,6 +115,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>iprange</option></arg>
@@ -110,6 +128,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>logdrop</option></arg>
@@ -120,6 +140,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>logwatch</option></arg>
@@ -132,6 +154,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>logreject</option></arg>
@@ -142,6 +166,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>reject</option></arg>
@@ -152,6 +178,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>restart</option></arg>
@@ -160,6 +188,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>restore</option></arg>
@@ -170,6 +200,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>save</option></arg>
@@ -180,6 +212,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>show</option></arg>
@@ -196,6 +230,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>show</option></arg>
@@ -208,6 +244,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>show</option></arg>
@@ -219,6 +257,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>show</option></arg>
@@ -231,6 +271,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>show</option></arg>
@@ -241,6 +283,10 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>show</option></arg>
@@ -253,6 +299,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>start</option></arg>
@@ -263,6 +311,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>stop</option></arg>
@@ -271,6 +321,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>status</option></arg>
@@ -279,6 +331,8 @@
     <cmdsynopsis>
       <command>shorewall-lite</command>
 
+      <arg choice="opt"><option>trace</option>|<option>debug</option></arg>
+
       <arg>-<replaceable>options</replaceable></arg>
 
       <arg choice="plain"><option>version</option></arg>
@@ -295,6 +349,10 @@
   <refsect1>
     <title>Options</title>
 
+    <para>The <option>trace</option> and <option>debug</option> options are
+    used for debugging. See <ulink
+    url="http://www.shorewall.net/starting_and_stopping.htm#Trace">http://www.shorewall.net/starting_and_stopping.htm#Trace</ulink>.</para>
+
     <para>The <emphasis>options</emphasis> control the amount of output that
     the command produces. They consist of a sequence of the letters <emphasis
     role="bold">v</emphasis> and <emphasis role="bold">q</emphasis>. If the