From: Luca Toscano <elukey@apache.org>
Date: Mon, 25 Jan 2016 06:25:59 +0000 (+0000)
Subject: Added important info for the DeflateBufferSize directive (mod_deflate).
X-Git-Tag: 2.5.0-alpha~2284
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=da47b63de322e58bf680d2b1c22b2e04f0d94f84;p=thirdparty%2Fapache%2Fhttpd.git

Added important info for the DeflateBufferSize directive (mod_deflate).
Bug: 33454



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

diff --git a/docs/manual/mod/mod_deflate.xml b/docs/manual/mod/mod_deflate.xml
index a4a4c32d376..81a8782f6db 100644
--- a/docs/manual/mod/mod_deflate.xml
+++ b/docs/manual/mod/mod_deflate.xml
@@ -296,7 +296,14 @@ CustomLog "logs/deflate_log" deflate
 <usage>
     <p>The <directive>DeflateBufferSize</directive> directive specifies
     the size in bytes of the fragments that zlib should compress at one
-    time.</p>
+    time. If the compressed response size is bigger than the one specified
+    by this directive then httpd will switch to chunked encoding 
+    (HTTP header <code>Transfer-Encoding</code> set to <code>Chunked</code>), with the
+    side effect of not setting any <code>Content-Length</code> HTTP header. This is particularly 
+    important when httpd works behind reverse caching proxies like Varnish or when httpd is configured with 
+    <module>mod_cache</module> and <module>mod_cache_disk</module> because
+    HTTP responses without any <code>Content-Length</code> header might not be cached.
+  </p>
 </usage>
 </directivesynopsis>