From d9c8cd638da8a5e7497f96bb642f71fd57adbfbc Mon Sep 17 00:00:00 2001
From: Tony Stevenson <pctony@apache.org>
Date: Thu, 16 Oct 2008 01:48:14 +0000
Subject: [PATCH] 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
---
 docs/manual/mod/mod_alias.html.en | 12 ++++++++++++
 docs/manual/mod/mod_alias.xml     | 12 ++++++++++++
 2 files changed, 24 insertions(+)

diff --git a/docs/manual/mod/mod_alias.html.en b/docs/manual/mod/mod_alias.html.en
index 115882aad6..cbb24d78e6 100644
--- 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 1afe5856ea..c4ade09655 100644
--- 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
-- 
2.50.1