svn commit: r1933734 - httpd/httpd/trunk/docs/manual/mod

[rb...@apache.org]

Author: rbowen
Date: Sat May  2 20:51:27 2026
New Revision: 1933734

Log:
Bug 66648: Document AddOutputFilterByType context merging behavior (additive within context, replaces across contexts)

Modified:
   httpd/httpd/trunk/docs/manual/mod/mod_filter.xml

Modified: httpd/httpd/trunk/docs/manual/mod/mod_filter.xml
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_filter.xml	Sat May  2 20:43:19 2026	(r1933733)
+++ httpd/httpd/trunk/docs/manual/mod/mod_filter.xml	Sat May  2 20:51:27 2026	(r1933734)
@@ -294,6 +294,26 @@ being moved to <module>mod_filter</modul
 &lt;/Location&gt;
     </highlight>
 
+    <p>Note that <directive>AddOutputFilterByType</directive> directives
+    within the same context are additive, but a definition in a more
+    specific context (such as a
+    <directive type="section" module="core">VirtualHost</directive>,
+    <directive type="section" module="core">Directory</directive>, or
+    <directive type="section" module="core">Location</directive> section)
+    will replace — not add to — any definitions inherited from a
+    broader context. This is the same behavior as
+    <directive module="mod_mime">AddOutputFilter</directive>.</p>
+
+    <highlight language="config">
+# Server context: compress text/html and text/plain
+AddOutputFilterByType DEFLATE text/html text/plain
+&lt;VirtualHost *:80&gt;
+    # Replaces the server-level definition for this vhost;
+    # only text/css will be compressed here:
+    AddOutputFilterByType DEFLATE text/css
+&lt;/VirtualHost&gt;
+    </highlight>
+
 </usage>
 
 <seealso><directive module="mod_mime">AddOutputFilter</directive></seealso>