diff --git a/docs/shorewall_extension_scripts.xml b/docs/shorewall_extension_scripts.xml
index 8d8884238..c4d9e4fc7 100644
--- a/docs/shorewall_extension_scripts.xml
+++ b/docs/shorewall_extension_scripts.xml
@@ -5,7 +5,7 @@
   <!--$Id$-->
 
   <articleinfo>
-    <title>Extension Scripts</title>
+    <title>Extension Scripts (User Exits)</title>
 
     <authorgroup>
       <author>
@@ -45,9 +45,9 @@
     <title>Extension Scripts</title>
 
     <para>Extension scripts are user-provided scripts that are invoked at
-    various points during firewall start, restart, stop and clear. The scripts
-    are placed in /etc/shorewall and are processed using the Bourne shell
-    <quote>source</quote> mechanism.</para>
+    various points during firewall start, restart, stop and clear. For each
+    script, the Shorewall compiler creates a Bourne Shell function with the
+    extension script as its body and calls the function at runtime.</para>
 
     <caution>
       <orderedlist>