From 06c79adc54b7a15635137b550d1b45970d3b55f8 Mon Sep 17 00:00:00 2001
From: teastep <teastep@fbd18981-670d-0410-9b5c-8dc0c1a9a2bb>
Date: Fri, 1 Dec 2006 17:46:00 +0000
Subject: [PATCH] Document better 'try' command

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

diff --git a/docs/starting_and_stopping_shorewall.xml b/docs/starting_and_stopping_shorewall.xml
index 972ca4fbb..37d632425 100644
--- a/docs/starting_and_stopping_shorewall.xml
+++ b/docs/starting_and_stopping_shorewall.xml
@@ -1359,6 +1359,29 @@ gateway:~ #</programlisting>
           <ulink
           url="Documentation.htm#Conf">/etc/shorewall/shorewall.conf</ulink>)
           exists. then that script is used.</para>
+
+          <para>The <command>try</command> command is deprecated. A better
+          approach to testing new configurations is:</para>
+
+          <blockquote>
+            <para><command>shorewall save</command></para>
+
+            <para><command>shorewall restart
+            &lt;configuration-directory&gt;</command> [ <command>&amp;&amp;
+            sleep &lt;timeout&gt; &amp;&amp; shorewall restore</command>
+            ]</para>
+
+            <para><emphasis>fix problems</emphasis></para>
+
+            <para><command>shorewall restart
+            &lt;configuration-directory&gt;</command> [ <command>&amp;&amp;
+            sleep &lt;timeout&gt; &amp;&amp; shorewall restore</command>
+            ]</para>
+
+            <para><emphasis>fix problems</emphasis></para>
+
+            <para>…</para>
+          </blockquote>
         </listitem>
       </varlistentry>