Clarify how the filters are merged when defined using the AddOuputFilter

directive.

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

diff --git a/docs/manual/mod/mod_mime.xml b/docs/manual/mod/mod_mime.xml
index 7edfe134fe466ea88dc04fb530a6e3c93d1961d3..4a65ed213b82e571a8a67fe49551135c8a0b5227 100644 (file)
--- a/docs/manual/mod/mod_mime.xml
+++ b/docs/manual/mod/mod_mime.xml
@@ -507,6 +507,41 @@ later.</compatibility>
     href="#multipleext">multiple extensions</a> and the
     <var>extension</var> argument will be compared against each of
     them.</p>
+
+    <p>Note that when defining a set of filters using the
+    <directive module="mod_mime">AddOuputFilter</directive> directive,
+    any definition made will replace any previous definition made by
+    the <directive module="mod_mime">AddOuputFilter</directive>
+    directive.</p>
+
+    <example>
+    # Effective filter "DEFLATE"<br />
+    AddOutputFilter DEFLATE shtml<br />
+    &lt;Location /foo&gt;<br />
+      <indent>
+      # Effective filter "INCLUDES", replacing "DEFLATE"<br />
+      AddOutputFilter INCLUDES shtml<br />
+      </indent>
+    &lt;/Location&gt;<br />
+    &lt;Location /bar&gt;<br />
+      <indent>
+      # Effective filter "INCLUDES;DEFLATE", replacing "DEFLATE"<br />
+      AddOutputFilter INCLUDES;DEFLATE shtml<br />
+      </indent>
+    &lt;/Location&gt;<br />
+    &lt;Location /bar/baz&gt;<br />
+      <indent>
+      # Effective filter "BUFFER", replacing "INCLUDES;DEFLATE"<br />
+      AddOutputFilter BUFFER shtml<br />
+      </indent>
+    &lt;/Location&gt;<br />
+    &lt;Location /bar/baz/buz&gt;<br />
+      <indent>
+      # No effective filter, replacing "BUFFER"<br />
+      RemoveOutputFilter shtml<br />
+      </indent>
+    &lt;/Location&gt;
+    </example>
 </usage>
 <seealso><directive module="mod_mime">RemoveOutputFilter</directive></seealso>
 <seealso><directive module="core">SetOutputFilter</directive></seealso>