diff --git a/docs/Macros.xml b/docs/Macros.xml
index b6eb671dc..38c36d0a5 100644
--- a/docs/Macros.xml
+++ b/docs/Macros.xml
@@ -241,7 +241,7 @@ ACCEPT           fw       loc             tcp      135,139,445</programlisting>
       </varlistentry>
     </variablelist>
 
-    <para>One remaining restriction must be mentioned: macros that are invoked
+    <para>One remaining restriction should be noted: macros that are invoked
     from actions cannot themselves invoke other actions.</para>
   </section>
 
@@ -599,4 +599,4 @@ bar:debug</programlisting>
       </listitem>
     </orderedlist>
   </section>
-</article>
\ No newline at end of file
+</article>
diff --git a/docs/shorewall_extension_scripts.xml b/docs/shorewall_extension_scripts.xml
index bfd789ca0..670c146d0 100644
--- a/docs/shorewall_extension_scripts.xml
+++ b/docs/shorewall_extension_scripts.xml
@@ -174,7 +174,7 @@
         <listitem>
           <para>Rate Limit (if passed as "" then $LOGLIMIT is assumed — see
           the LOGLIMIT option in <ulink
-          url="manpages/shorewall.conf.html">/etc/shorewall/shorewall.conf</ulink>)</para>
+          url="Documentation.htm#Conf">/etc/shorewall/shorewall.conf</ulink>)</para>
         </listitem>
 
         <listitem>
@@ -483,7 +483,8 @@
       by:<programlisting>my $chainref = $chain_table{&lt;table&gt;}{&lt;chain name&gt;};</programlisting>Example:<programlisting>my $chainref = $chain_table{filter}{INPUT};</programlisting></para>
 
       <para>You can also use the hash references $filter_table, $mangle_table
-      and $nat_table to access chain references.</para>
+      and $nat_table to access chain references in the three main
+      tables.</para>
 
       <para>Example:</para>