Add example and comments when using ScriptAlias with a file.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@705117 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/mod/mod_alias.html.en b/docs/manual/mod/mod_alias.html.en
index 115882aad6b76d8a01a0ffcc10ec30d2938fd9ce..cbb24d78e68f195c314c5ba27c3ebdde9b16f322 100644 (file)
--- a/docs/manual/mod/mod_alias.html.en
+++ b/docs/manual/mod/mod_alias.html.en
@@ -379,6 +379,18 @@ target as a CGI script</td></tr>
       &lt;/Location&gt;
     </code></p></div>
 
+       <p><code class="directive">ScriptAlias</code> can also be used in conjunction with
+       a script or handler you have. For example:</p>
+       
+       <div class="example"><p><code>
+         ScriptAlias /cgi-bin/ /web/cgi-handler.pl
+    </code></p></div>
+    
+    <p>In this scenario all files requested in <code>/cgi-bin/</code> will be
+    handled by the file you have configured, this allows you to use your own custom 
+    handler.  You may want to use this as a wrapper for CGI so that you can add 
+    content, or some other bespoke action.</p>
+
     <div class="warning">It is safer to avoid placing CGI scripts under the
     <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> in order to
     avoid accidentally revealing their source code if the

diff --git a/docs/manual/mod/mod_alias.xml b/docs/manual/mod/mod_alias.xml
index 1afe5856ea246e4816a2610208eb56525324927e..c4ade0965582c19c85c76a34c515357576560ff1 100644 (file)
--- a/docs/manual/mod/mod_alias.xml
+++ b/docs/manual/mod/mod_alias.xml
@@ -373,6 +373,18 @@ target as a CGI script</description>
       &lt;/Location&gt;
     </example>
 
+       <p><directive>ScriptAlias</directive> can also be used in conjunction with
+       a script or handler you have. For example:</p>
+       
+       <example>
+         ScriptAlias /cgi-bin/ /web/cgi-handler.pl
+    </example>
+    
+    <p>In this scenario all files requested in <code>/cgi-bin/</code> will be
+    handled by the file you have configured, this allows you to use your own custom 
+    handler.  You may want to use this as a wrapper for CGI so that you can add 
+    content, or some other bespoke action.</p>
+
     <note type="warning">It is safer to avoid placing CGI scripts under the
     <directive module="core">DocumentRoot</directive> in order to
     avoid accidentally revealing their source code if the