[master] feba493 Document gzip-enabled-later + ESI

[Kristian Lyngstøl]

commit feba4935cc0f07bb248554d1fe96fdacfbb95459
Author: Kristian Lyngstol <kristian at bohemians.org>
Date:   Mon May 23 10:46:07 2011 +0200

    Document gzip-enabled-later + ESI
    
    Closes #899

diff --git a/doc/sphinx/reference/varnishd.rst b/doc/sphinx/reference/varnishd.rst
index 1a3f2de..4036f65 100644
--- a/doc/sphinx/reference/varnishd.rst
+++ b/doc/sphinx/reference/varnishd.rst
@@ -454,6 +454,11 @@ http_gzip_support
 
 	Clients that do not support gzip will have their Accept-Encoding header removed. For more information on how gzip is implemented please see the chapter on gzip in the Varnish reference.
 
+        Note: Enabling gzip on a running Varnish instance using ESI can
+        yield content where cached, uncompressed pages have compressed ESI
+        elements. To avoid this, either ban all ESI-related elements before
+        enabling gzip, or restart Varnish.
+
 http_headers
 	- Units: header lines
 	- Default: 64