add documentation of RewriteOptions MaxRedirects

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

diff --git a/docs/manual/mod/mod_rewrite.xml b/docs/manual/mod/mod_rewrite.xml
index be975d73595903be66bfd6302cee30205528e4c8..2af171ff59d82b3e45393a7fe1ce3d781ef92ed7 100644 (file)
--- a/docs/manual/mod/mod_rewrite.xml
+++ b/docs/manual/mod/mod_rewrite.xml
@@ -308,10 +308,13 @@ SCRIPT_URI=http://en1.engelschall.com/u/rse/
 <directivesynopsis>
 <name>RewriteOptions</name>
 <description>Sets some special options for the rewrite engine</description>
-<syntax>RewriteOptions <em>Options</em></syntax>
+<syntax>RewriteOptions <var>Options</var></syntax>
+<default>RewriteOptions MaxRedirects=10</default>
 <contextlist><context>server config</context><context>virtual host</context>
 <context>directory</context><context>.htaccess</context></contextlist>
 <override>FileInfo</override>
+<compatibility><code>MaxRedirects</code> is available in Apache 2.1 and
+later</compatibility>
 <usage>
 
       <p>The <directive>RewriteOptions</directive> directive sets some
@@ -319,15 +322,24 @@ SCRIPT_URI=http://en1.engelschall.com/u/rse/
       configuration. The <em>Option</em> strings can be one of the
       following:</p>
 
-      <ul>
-        <li>'<strong><code>inherit</code></strong>'<br />
-         This forces the current configuration to inherit the
-        configuration of the parent. In per-virtual-server context
-        this means that the maps, conditions and rules of the main
-        server are inherited. In per-directory context this means
-        that conditions and rules of the parent directory's
-        <code>.htaccess</code> configuration are inherited.</li>
-      </ul>
+      <dl>
+      <dt><code>inherit</code></dt>
+      <dd>This forces the current configuration to inherit the
+      configuration of the parent. In per-virtual-server context
+      this means that the maps, conditions and rules of the main
+      server are inherited. In per-directory context this means
+      that conditions and rules of the parent directory's
+      <code>.htaccess</code> configuration are inherited.</dd>
+
+      <dt><code>MaxRedirects=<var>number</var></code></dt>
+      <dd>In order to prevent endless loops of internal redirects
+      issued by per-directory <directive module="mod_rewrite"
+      >RewriteRule</directive>s, <module>mod_rewrite</module> aborts
+      the request after reaching a maximum number of such redirects and
+      responds with an 500 Internal Server Error. If you really need
+      more internal redirects than 10 per request, you may increase
+      the default to the desired value.</dd>
+      </dl>
 </usage>
 
 </directivesynopsis>