diff --git a/docs/XenMyWay-Routed.xml b/docs/XenMyWay-Routed.xml
index 71c1137bd..1f6b5b466 100644
--- a/docs/XenMyWay-Routed.xml
+++ b/docs/XenMyWay-Routed.xml
@@ -495,11 +495,12 @@ OMAK=<IP address at our second home>
 
         <programlisting>echo 1 &gt; /proc/sys/net/ipv4/netfilter/ip_conntrack_tcp_be_liberal</programlisting>
 
-        <para><filename>/etc/shorewall/interfaces</filename>:</para>
+        <para><filename>/etc/shorewall/interfaces</filename> (don't specify
+        the BROADCAST addresses if you are using Shorewall-perl):</para>
 
         <programlisting>#ZONE   INTERFACE       BROADCAST               OPTIONS
 net     $EXT_IF         206.124.146.255         dhcp,norfc1918,logmartians,blacklist,tcpflags,nosmurfs
-dmz     $DMZ_IF         192.168.0.255           logmartians
+dmz     $DMZ_IF         206.124.146.255         logmartians
 loc     $INT_IF         192.168.1.255           dhcp,routeback,logmartians
 loc     $TEST_IF        -
 wifi    $WIFI_IF        192.168.3.255           dhcp,maclist
@@ -521,7 +522,7 @@ vpn     tun+            -
         rule before the SNAT rules generated by entries in
         <filename>/etc/shorewall/nat</filename> above.</para>
 
-        <programlisting>#INTERFACE              SUBNET          ADDRESS         PROTO   PORT(S) IPSEC
+        <programlisting>#INTERFACE              SOURCE          ADDRESS         PROTO   PORT(S) IPSEC
 +$EXT_IF:192.168.1.1    0.0.0.0/0       192.168.1.254
 $EXT_IF                 192.168.0.0/22  206.124.146.179
 #LAST LINE -- ADD YOUR ENTRIES ABOVE THIS LINE -- DO NOT REMOVE</programlisting>
diff --git a/manpages/shorewall-tos.xml b/manpages/shorewall-tos.xml
index 764411ba0..d0b0fa5ac 100644
--- a/manpages/shorewall-tos.xml
+++ b/manpages/shorewall-tos.xml
@@ -28,13 +28,13 @@
     <variablelist>
       <varlistentry>
         <term><emphasis role="bold">SOURCE</emphasis> -
-        {<emphasis>all</emphasis>[<emphasis
+        {<emphasis>zone</emphasis>[<emphasis
         role="bold">:</emphasis><emphasis>address</emphasis>]|<emphasis
         role="bold">all</emphasis>|<emphasis role="bold">$FW</emphasis>}
         (Shorewall-shell)</term>
 
         <listitem>
-          <para>Name of a zone declared in <ulink
+          <para>Name of a <replaceable>zone</replaceable> declared in <ulink
           url="shorewall-zones.html">shorewall-zones</ulink>(5), <emphasis
           role="bold">all</emphasis> or <emphasis
           role="bold">$FW</emphasis>.</para>