leave a hint about some non-intuitive startup behavior for RewriteMap programs

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

2 files changed, 18 insertions, 0 deletions

diff --git a/docs/manual/mod/mod_rewrite.html.en b/docs/manual/mod/mod_rewrite.html.en
index 7fe2e39977..258946b16b 100644
--- a/docs/manual/mod/mod_rewrite.html.en
+++ b/docs/manual/mod/mod_rewrite.html.en
@@ -674,6 +674,11 @@ RewriteRule  ^/$                 /homepage.std.html  [L]
       <code>RewriteEngine on</code> directive for each virtual host
       in which you wish to use rewrite rules.</p>
 
+      <p><code class="directive">RewriteMap</code> directives of the type <code>prg</code>
+      are not started during server initialization if they're defined in a
+      context that does not have <code class="directive">RewriteEngine</code>  set to
+      <code>on</code></p>
+
 </div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="directive-section"><h2><a name="RewriteLock" id="RewriteLock">RewriteLock</a> <a name="rewritelock" id="rewritelock">Directive</a></h2>
@@ -960,6 +965,10 @@ $ httxt2dbm -i mapfile.txt -o mapfile.map
           program which will implement a 1:1 map (<em>i.e.</em>,
           key == value) could be:</p>
 
+          <p>External rewriting programs are not started they're defined in a
+          context that does not have <code class="directive">RewriteEngine</code> set to
+          <code>on</code></p>.
+
 <div class="example"><pre>
 #!/usr/bin/perl
 $| = 1;
diff --git a/docs/manual/mod/mod_rewrite.xml b/docs/manual/mod/mod_rewrite.xml
index baa6038dca..905a13b388 100644
--- a/docs/manual/mod/mod_rewrite.xml
+++ b/docs/manual/mod/mod_rewrite.xml
@@ -146,6 +146,11 @@ SCRIPT_URI=http://en1.engelschall.com/u/rse/
       inherited by virtual hosts. This means that you need to have a
       <code>RewriteEngine on</code> directive for each virtual host
       in which you wish to use rewrite rules.</p>
+
+      <p><directive>RewriteMap</directive> directives of the type <code>prg</code>
+      are not started during server initialization if they're defined in a
+      context that does not have <directive>RewriteEngine</directive>  set to
+      <code>on</code></p>
 </usage>
 
 </directivesynopsis>
@@ -472,6 +477,10 @@ $ httxt2dbm -i mapfile.txt -o mapfile.map
           program which will implement a 1:1 map (<em>i.e.</em>,
           key == value) could be:</p>
 
+          <p>External rewriting programs are not started they're defined in a
+          context that does not have <directive>RewriteEngine</directive> set to
+          <code>on</code></p>.
+
 <example>
 <pre>
 #!/usr/bin/perl