diff --git a/docs/6to4.xml b/docs/6to4.xml
index 7944e7094..11e7c9c84 100644
--- a/docs/6to4.xml
+++ b/docs/6to4.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
   <!--$Id$-->
 
diff --git a/docs/Accounting.xml b/docs/Accounting.xml
index 3e703a8a4..240ea46a0 100644
--- a/docs/Accounting.xml
+++ b/docs/Accounting.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
   <!--$Id$-->
 
diff --git a/docs/Actions.xml b/docs/Actions.xml
index e3601a090..eb98a94d0 100644
--- a/docs/Actions.xml
+++ b/docs/Actions.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
   <!--$Id$-->
 
diff --git a/docs/Anatomy.xml b/docs/Anatomy.xml
index fa39ae584..ea653ffe0 100644
--- a/docs/Anatomy.xml
+++ b/docs/Anatomy.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
   <!--$Id$-->
 
diff --git a/docs/Anatomy_ru.xml b/docs/Anatomy_ru.xml
index d97b3474f..7f5a2371f 100644
--- a/docs/Anatomy_ru.xml
+++ b/docs/Anatomy_ru.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
   <!--$Id$-->
 
diff --git a/docs/CompiledPrograms.xml b/docs/CompiledPrograms.xml
index 01949ef38..cd6316cba 100644
--- a/docs/CompiledPrograms.xml
+++ b/docs/CompiledPrograms.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
   <!--$Id$-->
 
diff --git a/docs/Documentation_Index.xml b/docs/Documentation_Index.xml
index 0c5ab6510..94322f311 100644
--- a/docs/Documentation_Index.xml
+++ b/docs/Documentation_Index.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
   <!--/$Id$-->
 
diff --git a/docs/ECN.xml b/docs/ECN.xml
index 5edde2888..d45b5af19 100644
--- a/docs/ECN.xml
+++ b/docs/ECN.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article id="ECN">
   <!--$Id$-->
 
diff --git a/docs/FAQ.xml b/docs/FAQ.xml
index 5dfc7879c..a803b60ec 100644
--- a/docs/FAQ.xml
+++ b/docs/FAQ.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
   <!--$Id$-->
 
@@ -611,7 +613,13 @@ DNAT       loc           loc:192.168.1.5    tcp      www         -         <emph
 
           <para>Using this technique, you will want to configure your
           DHCP/PPPoE/PPTP/… client to automatically restart Shorewall each
-          time that you get a new IP address.</para>
+          time that you get a new IP address.<note>
+              <para>If you are running Shorewall 3.2.6 on a Debian-based
+              system, the call to find_first_interface_address in
+              /etc/shorewall/params must be preceded with a load of the
+              Shorewall function library:<programlisting><command>. /usr/share/shorewall/functions</command>
+<command>ETH0_IP=`find_first_interface_address eth0`</command></programlisting></para>
+            </note></para>
         </listitem>
       </itemizedlist>
 
@@ -731,6 +739,14 @@ DNAT       loc           dmz:192.168.2.4    tcp      80          -         <emph
           save</command> and <command>shorewall[-lite]
           restore</command></ulink>.</para>
         </warning>
+
+        <note>
+          <para>If you are running Shorewall 3.2.6 on a Debian-based system,
+          the call to find_first_interface_address in /etc/shorewall/params
+          must be preceded with a load of the Shorewall function
+          library:<programlisting><command>. /usr/share/shorewall/functions</command>
+<command>ETH0_IP=`find_first_interface_address eth0`</command></programlisting></para>
+        </note>
       </section>
 
       <section id="faq2c">
diff --git a/docs/FTP.xml b/docs/FTP.xml
index 9f7e58a33..7b10e3be2 100644
--- a/docs/FTP.xml
+++ b/docs/FTP.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article id="FTP">
   <!--$Id$-->
 
diff --git a/docs/GenericTunnels.xml b/docs/GenericTunnels.xml
index 168727867..5fe5837d2 100644
--- a/docs/GenericTunnels.xml
+++ b/docs/GenericTunnels.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article id="GenericTunnels">
   <!--$Id$-->
 
diff --git a/docs/GettingStarted.xml b/docs/GettingStarted.xml
index 4d283244b..60a052d66 100644
--- a/docs/GettingStarted.xml
+++ b/docs/GettingStarted.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
   <!--$Id$-->
 
diff --git a/docs/GnuCopyright.xml b/docs/GnuCopyright.xml
index bbe317034..e5dba18c4 100644
--- a/docs/GnuCopyright.xml
+++ b/docs/GnuCopyright.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <appendix id="gfdl">
 <title>GNU Free Documentation License</title>
 <subtitle>Version 1.2, November 2002</subtitle>
diff --git a/docs/IPIP.xml b/docs/IPIP.xml
index 48deeddb1..8f06edcfc 100644
--- a/docs/IPIP.xml
+++ b/docs/IPIP.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article id="IPIP">
   <!--$Id$-->
 
diff --git a/docs/IPP2P.xml b/docs/IPP2P.xml
index bf0671e86..464b5bd6b 100644
--- a/docs/IPP2P.xml
+++ b/docs/IPP2P.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
   <!--$Id$-->
 
@@ -229,4 +229,4 @@ SAVE:F               -             -           tcp          -              -
     <para>It will work the same and will work with a <ulink
     url="MultiISP.html">Multi-ISP setup</ulink>.</para>
   </section>
-</article>
\ No newline at end of file
+</article>
diff --git a/docs/IPSEC-2.6.xml b/docs/IPSEC-2.6.xml
index 284319308..a105ab942 100644
--- a/docs/IPSEC-2.6.xml
+++ b/docs/IPSEC-2.6.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article id="IPSEC">
   <!--$Id$-->
 
@@ -1019,4 +1019,4 @@ ipip                    <emphasis role="bold">vpn</emphasis>     0.0.0.0/0</prog
     ipsec-tools source tree. It has a wide variety of sample racoon
     configuration files.</para>
   </section>
-</article>
\ No newline at end of file
+</article>
diff --git a/docs/IPSEC.xml b/docs/IPSEC.xml
index 630fcb3c1..5600ea637 100644
--- a/docs/IPSEC.xml
+++ b/docs/IPSEC.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article id="IPSEC">
   <!--$Id$-->
 
@@ -438,4 +438,4 @@ ipsec       net        0.0.0.0/0       vpn1,vpn2,vpn3</programlisting>
 
     <programlisting>/sbin/shorewall delete ipsec0:134.28.54.2 vpn2</programlisting>
   </section>
-</article>
\ No newline at end of file
+</article>
diff --git a/docs/Install.xml b/docs/Install.xml
index 262eaa0b6..e53191248 100644
--- a/docs/Install.xml
+++ b/docs/Install.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article id="Install">
   <!--$Id$-->
 
diff --git a/docs/Introduction.xml b/docs/Introduction.xml
index 6e5d4c4c4..f5ad190f1 100644
--- a/docs/Introduction.xml
+++ b/docs/Introduction.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article id="usefull_links">
   <!--$Id$-->
 
diff --git a/docs/KVM.xml b/docs/KVM.xml
index 336a9b5b5..a096f8258 100644
--- a/docs/KVM.xml
+++ b/docs/KVM.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
   <!--$Id$-->
 
@@ -93,4 +93,4 @@
     configured with the <option>routeback</option> option in <ulink
     url="manpages/shorewall-interfaces.html">shorewall-interfaces</ulink>(5).</para>
   </section>
-</article>
\ No newline at end of file
+</article>
diff --git a/docs/MAC_Validation.xml b/docs/MAC_Validation.xml
index bda3b1f58..d8054ecfe 100644
--- a/docs/MAC_Validation.xml
+++ b/docs/MAC_Validation.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article id="MAC_Validation">
   <!--$Id$-->
 
@@ -263,4 +263,4 @@ $WIFI_IF                00:1f:79:cd:fe:2e       192.168.3.6     #Work Laptop
       of the host sending the traffic.</para>
     </example>
   </section>
-</article>
\ No newline at end of file
+</article>
diff --git a/docs/Macros.xml b/docs/Macros.xml
index 255b405d1..e55c20b8a 100644
--- a/docs/Macros.xml
+++ b/docs/Macros.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article lang="en" status="">
   <!--$Id$-->
 
@@ -640,4 +640,4 @@ bar:debug</programlisting>
       </listitem>
     </orderedlist>
   </section>
-</article>
\ No newline at end of file
+</article>
diff --git a/docs/Manpages.xml b/docs/Manpages.xml
index 0819123b3..a935ee98b 100644
--- a/docs/Manpages.xml
+++ b/docs/Manpages.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
   <!--$Id: template.xml 5908 2007-04-12 23:04:36Z teastep $-->
 
@@ -180,4 +180,4 @@
       </simplelist>
     </blockquote>
   </section>
-</article>
\ No newline at end of file
+</article>
diff --git a/docs/ManualChains.xml b/docs/ManualChains.xml
index ea759d849..d7e492fe2 100644
--- a/docs/ManualChains.xml
+++ b/docs/ManualChains.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
   <!--$Id$-->
 
@@ -207,4 +207,4 @@ DNAT-            net               loc:192.168.1.5 tcp         22            -
 PERL Knock 'net', '$FW', {name =&gt; 'SSH', knocker =&gt; 1600, trap =&gt; [1599, 1601]};
 PERL Knock 'net', 'loc:192.168.1.5', {name =&gt; 'SSH', target =&gt; 22, original_dest =&gt; '206.124.136.178'};</programlisting></para>
   </section>
-</article>
\ No newline at end of file
+</article>
diff --git a/docs/blacklisting_support.xml b/docs/blacklisting_support.xml
index d36d6f595..c4eeb3d10 100644
--- a/docs/blacklisting_support.xml
+++ b/docs/blacklisting_support.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
   <!--$Id$-->
 
diff --git a/docs/blacklisting_support_ru.xml b/docs/blacklisting_support_ru.xml
index 829e95dc7..eb1ad1a47 100644
--- a/docs/blacklisting_support_ru.xml
+++ b/docs/blacklisting_support_ru.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
   <!--$Id: blacklisting_support.xml 6774 2007-07-04 00:10:35Z teastep $-->
 
diff --git a/docs/bridge-Shorewall-perl.xml b/docs/bridge-Shorewall-perl.xml
index be738e16f..f29e1c255 100644
--- a/docs/bridge-Shorewall-perl.xml
+++ b/docs/bridge-Shorewall-perl.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
   <!--$Id$-->
 
diff --git a/docs/configuration_file_basics.xml b/docs/configuration_file_basics.xml
index 665ecc42f..5db742eba 100644
--- a/docs/configuration_file_basics.xml
+++ b/docs/configuration_file_basics.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
   <!--$Id$-->
 
diff --git a/docs/dhcp.xml b/docs/dhcp.xml
index f2e6b71b0..e5ae7ee5f 100644
--- a/docs/dhcp.xml
+++ b/docs/dhcp.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
   <!--$Id$-->
 
diff --git a/docs/fallback.xml b/docs/fallback.xml
index cbc71594e..6099f6603 100644
--- a/docs/fallback.xml
+++ b/docs/fallback.xml
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
   <!--$Id$-->
 
diff --git a/docs/ipsets.xml b/docs/ipsets.xml
index f1750ff12..287eff257 100644
--- a/docs/ipsets.xml
+++ b/docs/ipsets.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
   <!--$Id$-->
 
@@ -214,4 +214,4 @@ dyn           eth3:+Dyn</programlisting>
     you're all set. You can add and delete addresses from Dyn without having
     to touch Shorewall.</para>
   </section>
-</article>
\ No newline at end of file
+</article>
diff --git a/docs/kernel.xml b/docs/kernel.xml
index c7e7f32e1..e2c849ee5 100644
--- a/docs/kernel.xml
+++ b/docs/kernel.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
   <!--$Id$-->