Document the 3rd argument of 'RewriteMap'

(r1664575 in trunk)

Compatibility note will be added in the next commit.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1827600 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/mod/mod_rewrite.xml b/docs/manual/mod/mod_rewrite.xml
index e96a583f8d19476939e2ce94ba5c193771d32205..7c5a2b5c9e4c9164b4b9190393aa2bb6230d82b6 100644 (file)
--- a/docs/manual/mod/mod_rewrite.xml
+++ b/docs/manual/mod/mod_rewrite.xml
@@ -300,6 +300,7 @@ LogLevel alert rewrite:trace3
 <name>RewriteMap</name>
 <description>Defines a mapping function for key-lookup</description>
 <syntax>RewriteMap <em>MapName</em> <em>MapType</em>:<em>MapSource</em>
+    <em>MapTypeOptions</em>
 </syntax>
 <contextlist><context>server config</context><context>virtual host</context>
 </contextlist>
@@ -347,6 +348,11 @@ RewriteMap examplemap "txt:/path/to/file/map.txt"
 RewriteRule "^/ex/(.*)" "${examplemap:$1}"
       </highlight>
 
+      <p>The meaning of the <em>MapTypeOptions</em> argument depends on
+      particular <em>MapType</em>. See the
+      <a href="../rewrite/rewritemap.html">Using RewriteMap</a> for
+      more information.</p>
+
       <p>The following combinations for <em>MapType</em> and
       <em>MapSource</em> can be used:</p>
 

diff --git a/docs/manual/rewrite/rewritemap.xml b/docs/manual/rewrite/rewritemap.xml
index 94a1935a5cd41421331139389e76af64538e52a3..b3bba5f25f51635309dd08c4979acd86b2f84fbe 100644 (file)
--- a/docs/manual/rewrite/rewritemap.xml
+++ b/docs/manual/rewrite/rewritemap.xml
@@ -366,10 +366,11 @@ by many requests.
     module="mod_rewrite">RewriteEngine</directive> set to
     <code>on</code>.</p>
 
-    <p>By default, external rewriting programs are started as root.
-    This can be changed on UNIX systems by passing user name and
-    group name as third argument to <directive module="mod_rewrite">
-    RewriteMap</directive> in the <code>username:groupname</code> format.</p>
+    <p>By default, external rewriting programs are run as the
+    user:group who started httpd. This can be changed on UNIX systems
+    by passing user name and group name as third argument to
+    <directive module="mod_rewrite">RewriteMap</directive> in the
+    <code>username:groupname</code> format.</p>
 
     <p>This feature utilizes the <code>rewrite-map</code> mutex,
     which is required for reliable communication with the program.