httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Igor Galić <i.ga...@brainsware.org>
Subject PR 49313: Using filters is a mess.
Date Thu, 03 Feb 2011 00:27:17 GMT
Hey folks,

while by far not complete, I started out to fix 49312 for mod_deflate.xml 

Index: manual/mod/mod_deflate.xml
===================================================================
--- manual/mod/mod_deflate.xml  (revision 1066631)
+++ manual/mod/mod_deflate.xml  (working copy)
@@ -38,21 +38,15 @@
 <seealso><a href="../filter.html">Filters</a></seealso>

 <section id="recommended"><title>Sample Configurations</title>
-    <p>This is a simple sample configuration for the impatient.</p>
+    <p>This is a simple sample configuration:</p>

-    <example><title>Compress only a few types</title>
-      AddOutputFilterByType DEFLATE text/html text/plain text/xml
-    </example>
-
-    <p>The following configuration, while resulting in more compressed content,
-    is also much more complicated.  Do not use this unless you fully understand
-    all the configuration details.</p>
-
-    <example><title>Compress everything except images</title>
-      &lt;Location /&gt;<br />
-      <indent>
+    <example><title>Compress all text content</title>
+        # Declare filter<br />
+        FilterDeclare COMPRESS<br />
+        FilterProvider COMPRESS DEFLATE resp=Content-Type $text/<br />
+        FilterProtocol COMPRESS change=yes;byteranges=no<br />
         # Insert filter<br />
-        SetOutputFilter DEFLATE<br />
+        FilterChain COMPRESS<br />
         <br />
         # Netscape 4.x has some problems...<br />
         BrowserMatch ^Mozilla/4         gzip-only-text/html<br />
@@ -71,7 +65,6 @@
         # Make sure proxies don't deliver the wrong content<br />
         Header append Vary User-Agent env=!dont-vary<br />
       </indent>
-      &lt;/Location&gt;
     </example>

 </section>


Now, that's an easy fix, or a good start anyway..
But what do we do with Set(In|Out)putFilter? They're defined in core.
Their counter-parts Remove(In|Out)putFilter however are part of mod_mime.

All of this is very counterintuitive, not to say confusing, especially
considering that we're recommending mod_filter over all of these.


Thoughts? 

i

-- 
Igor Galić

Tel: +43 (0) 664 886 22 883
Mail: i.galic@brainsware.org
URL: http://brainsware.org/

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Mime
View raw message