diff --git a/docs/configuration_file_basics.xml b/docs/configuration_file_basics.xml
index a03dd4302..0b7eb556b 100644
--- a/docs/configuration_file_basics.xml
+++ b/docs/configuration_file_basics.xml
@@ -709,6 +709,15 @@ DNAT       net        loc:192.168.1.3 tcp       4000:4100</programlisting>
         <para>The names of any functions or variables declared should begin
         with an upper case letter.</para>
       </listitem>
+
+      <listitem>
+        <para>Beginning with Shorewall version 3.2.9, the
+        <filename>/etc/shorewall/params</filename> file is pre-processed in
+        such a way that extra white-space is compressed from the file as it is
+        being copied into the generated compiler output. So the code in
+        /etc/shorewall/params should not depend on precise white-space,
+        including whitespace within quoted strings.</para>
+      </listitem>
     </orderedlist>
 
     <para>One possible use of this feature is to compensate for recent Linux
diff --git a/docs/shorewall_extension_scripts.xml b/docs/shorewall_extension_scripts.xml
index 3c3e1044b..7e3971e88 100644
--- a/docs/shorewall_extension_scripts.xml
+++ b/docs/shorewall_extension_scripts.xml
@@ -137,7 +137,8 @@
       <command>run_iptables</command> instead. <command>run_iptables</command>
       will run the iptables utility passing the arguments to
       <command>run_iptables</command> and if the command fails, the firewall
-      will be stopped.</para>
+      will be stopped (or restored from the last <command>save</command>
+      command, if any).</para>
     </listitem>
 
     <listitem>