add a note, that mod_alias and mod_userdir are forced

to be run before mod_vhost_alias

Reviewed by: Joshua Slive

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

diff --git a/docs/manual/mod/mod_vhost_alias.html.en b/docs/manual/mod/mod_vhost_alias.html.en
index 30a432ee660650dba06b68f1481ada81eb5380d3..da51f6b0264d8f5f8c9ba2b736af198ae44c8ccc 100644 (file)
--- a/docs/manual/mod/mod_vhost_alias.html.en
+++ b/docs/manual/mod/mod_vhost_alias.html.en
@@ -10,16 +10,27 @@ hosting</td></tr><tr><th><a href="module-dict.html#Status">Status:
                   </a></th><td>Extension</td></tr><tr><th><a href="module-dict.html#ModuleIdentifier">Module Identifier:
                   </a></th><td>vhost_alias_module</td></tr><tr><th><a href="module-dict.html#SourceFile">Source File:
                   </a></th><td>mod_vhost_alias.c</td></tr></table><h3>Summary</h3>
-
     <p>This module creates dynamically configured virtual hosts, by
     allowing the IP address and/or the <code>Host:</code> header of
     the HTTP request to be used as part of the pathname to
     determine what files to serve. This allows for easy use of a
     huge number of virtual hosts with similar configurations.</p>
-
-
+    
+    <div class="note"><h3>Note</h3>
+      <p>If <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> or <code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code> are
+      used for translating URIs to filenames, they will override the
+      directives of <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code> described below. For
+      example, the following configuration will map <code>
+      /cgi-bin/script.pl</code> to <code>
+      /usr/local/apache2/cgi-bin/script.pl</code> in all cases:</p>
+
+      <div class="example"><p><code>
+        ScriptAlias /cgi-bin/ /usr/local/apache2/cgi-bin/<br />
+        VirtualScriptAlias /never/found/%0/cgi-bin/
+      </code></p></div>
+    </div>
 </div><div id="quickview"><h3 class="directives">Directives</h3><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#virtualdocumentroot">VirtualDocumentRoot</a></li><li><img alt="" src="../images/down.gif" /> <a href="#virtualdocumentrootip">VirtualDocumentRootIP</a></li><li><img alt="" src="../images/down.gif" /> <a href="#virtualscriptalias">VirtualScriptAlias</a></li><li><img alt="" src="../images/down.gif" /> <a href="#virtualscriptaliasip">VirtualScriptAliasIP</a></li></ul><h3>Topics</h3><ul id="topics"><li><img alt="" src="../images/down.gif" /> <a href="#interpol">Directory Name Interpolation</a></li><li><img alt="" src="../images/down.gif" /> <a href="#examples">Examples</a></li></ul><h3>See also</h3><ul class="seealso"><li><code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code></li><li><a href="../vhosts/mass.html">Dynamically configured mass 
-virtual hosting</a></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="section"><h2><a name="interpol" id="interpol">Directory Name Interpolation</a></h2>
+    virtual hosting</a></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="section"><h2><a name="interpol" id="interpol">Directory Name Interpolation</a></h2>
     
 
     <p>All the directives in this module interpolate a string into

diff --git a/docs/manual/mod/mod_vhost_alias.xml b/docs/manual/mod/mod_vhost_alias.xml
index c2b91159be3ed4658d0841fbfbcff46d5d421258..2aa0f27d39b14780b4e8c891d9186b8cbc6471a4 100644 (file)
--- a/docs/manual/mod/mod_vhost_alias.xml
+++ b/docs/manual/mod/mod_vhost_alias.xml
@@ -11,19 +11,30 @@ hosting</description>
 <identifier>vhost_alias_module</identifier>
 
 <summary>
-
     <p>This module creates dynamically configured virtual hosts, by
     allowing the IP address and/or the <code>Host:</code> header of
     the HTTP request to be used as part of the pathname to
     determine what files to serve. This allows for easy use of a
     huge number of virtual hosts with similar configurations.</p>
-
-
+    
+    <note><title>Note</title>
+      <p>If <module>mod_alias</module> or <module>mod_userdir</module> are
+      used for translating URIs to filenames, they will override the
+      directives of <module>mod_vhost_alias</module> described below. For
+      example, the following configuration will map <code>
+      /cgi-bin/script.pl</code> to <code>
+      /usr/local/apache2/cgi-bin/script.pl</code> in all cases:</p>
+
+      <example>
+        ScriptAlias /cgi-bin/ /usr/local/apache2/cgi-bin/<br />
+        VirtualScriptAlias /never/found/%0/cgi-bin/
+      </example>
+    </note>
 </summary>
-    <seealso><directive
-    module="core">UseCanonicalName</directive></seealso>
-    <seealso><a href="../vhosts/mass.html">Dynamically configured mass 
-virtual hosting</a></seealso>
+
+<seealso><directive module="core">UseCanonicalName</directive></seealso>
+<seealso><a href="../vhosts/mass.html">Dynamically configured mass 
+    virtual hosting</a></seealso>
 
 <section id="interpol">
     <title>Directory Name Interpolation</title>