From 46412b0490d60e19c908261d3b683d691c6cec49 Mon Sep 17 00:00:00 2001
From: teastep <teastep@fbd18981-670d-0410-9b5c-8dc0c1a9a2bb>
Date: Wed, 19 Nov 2008 17:20:40 +0000
Subject: [PATCH] Add warnings about using 'restart -C'

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

diff --git a/manpages/shorewall.xml b/manpages/shorewall.xml
index a292a7d26..ad2ea2756 100644
--- a/manpages/shorewall.xml
+++ b/manpages/shorewall.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <refentry>
   <refmeta>
     <refentrytitle>shorewall</refentrytitle>
@@ -1068,13 +1070,23 @@
 
           <para>The <option>-f</option> option suppresses the compilation step
           and simply reused the compiled script which last started/restarted
-          Shorewall. </para>
+          Shorewall.</para>
 
           <para>The <option>-C</option> option determines the compiler to use
           (Shorewall-shell or Shorewall-perl). If not specified, the
           SHOREWALL_COMPILER setting in <ulink
           url="shorewall.conf.html">shorewall.conf</ulink>(5) determines the
           compiler to use.</para>
+
+          <warning>
+            <para>If you use Shorewall's multi-ISP feature, you are stronly
+            advised against using the -C option of the
+            <command>restart</command> command when switching between
+            Shorewall-shell and Shorewall-perl. The only supported way to
+            switch compilers is to <command>shorewall stop</command> followed
+            by <command>shorewall start -C</command>
+            <replaceable>compiler</replaceable></para>
+          </warning>
         </listitem>
       </varlistentry>
 
@@ -1113,6 +1125,16 @@
           SHOREWALL_COMPILER setting in <ulink
           url="shorewall.conf.html">shorewall.conf</ulink>(5) determines the
           compiler to use.</para>
+
+          <warning>
+            <para>If you use Shorewall's multi-ISP feature, you are stronly
+            advised against using the -C option of the
+            <command>safe-restart</command> command when switching between
+            Shorewall-shell and Shorewall-perl. The only supported way to
+            switch compilers is to <command>shorewall stop</command> followed
+            by <command>shorewall safe-start -C</command>
+            <replaceable>compiler</replaceable></para>
+          </warning>
         </listitem>
       </varlistentry>