svn commit: r1790870 - /httpd/httpd/trunk/docs/manual/mod/mod_brotli.xml

[ko...@apache.org]

Author: kotkov
Date: Mon Apr 10 16:04:19 2017
New Revision: 1790870

URL: http://svn.apache.org/viewvc?rev=1790870&view=rev
Log:
mod_brotli: Tweak the descriptions of the directives provided by mod_brotli
in the documentation (BrotliCompressionQuality, BrotliCompressionWindow,
BrotliCompressionMaxInputBlock, BrotliAlterETag).

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

Modified: httpd/httpd/trunk/docs/manual/mod/mod_brotli.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_brotli.xml?rev=1790870&r1=1790869&r2=1790870&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_brotli.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_brotli.xml Mon Apr 10 16:04:19 2017
@@ -239,9 +239,8 @@ CustomLog "logs/brotli_log" brotli
 
 <usage>
     <p>The <directive>BrotliCompressionQuality</directive> directive specifies
-    the compression quality performed (a value between 0 and 11). Higher
-    quality values result in better compression but also slower compression
-    as well.
+    the compression quality (a value between 0 and 11). Higher quality values
+    result in better, but also slower compression.
   </p>
 </usage>
 </directivesynopsis>
@@ -256,9 +255,8 @@ CustomLog "logs/brotli_log" brotli
 
 <usage>
     <p>The <directive>BrotliCompressionWindow</directive> directive specifies the
-    brotli sliding compression window size (a value between 10 and 24). Generally, the
-    higher the window size, the higher can the compression ratio be expected
-    but requires more memory.</p>
+    brotli sliding compression window size (a value between 10 and 24). Larger
+    window sizes can improve compression quality, but require more memory.</p>
 </usage>
 </directivesynopsis>
 
@@ -267,7 +265,7 @@ CustomLog "logs/brotli_log" brotli
 <name>BrotliCompressionMaxInputBlock</name>
 <description>Maximum input block size</description>
 <syntax>BrotliCompressionMaxInputBlock <var>value</var></syntax>
-<default>BrotliCompressionMaxInputBlock 0</default>
+<default>(automatic)</default>
 <contextlist><context>server config</context><context>virtual host</context>
 </contextlist>
 
@@ -293,12 +291,14 @@ CustomLog "logs/brotli_log" brotli
     <dt>AddSuffix</dt>
     <dd><p>Append the compression method onto the end of the ETag, causing
         compressed and uncompressed representations to have unique ETags.
-        This has been the default since 2.4.0, but prevents serving
-        "HTTP Not Modified" (304) responses to conditional requests for
-        compressed content.</p></dd>
+        In another dynamic compression module, mod_deflate, this has been
+        the default since 2.4.0. This setting prevents serving "HTTP Not
+        Modified" (304) responses to conditional requests for compressed
+        content.</p></dd>
     <dt>NoChange</dt>
-    <dd><p>Don't change the ETag on a compressed response. This was the default
-        prior to 2.4.0, but does not satisfy the HTTP/1.1 property that all
+    <dd><p>Don't change the ETag on a compressed response. In another dynamic
+        compression module, mod_deflate, this has been the default prior to
+        2.4.0. This setting does not satisfy the HTTP/1.1 property that all
         representations of the same resource have unique ETags. </p></dd>
     <dt>Remove</dt>
     <dd><p>Remove the ETag header from compressed responses. This prevents