From: Graham Leggett <minfrin@apache.org>
Date: Thu, 22 Dec 2011 21:54:55 +0000 (+0000)
Subject: Clarify how the filters are merged when defined using the AddOuputFilter
X-Git-Tag: 2.5.0-alpha~7633
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=5fa6dd935d06086ef19c197711adf3ee60b24ae6;p=apache

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 7edfe134fe..4a65ed213b 100644
--- 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>