changeset 675:08140f6b7964

Documented gunzip module and corresponding changes.
author Vladimir Homutov <vl@nginx.com>
date Wed, 12 Sep 2012 09:35:47 +0000
parents c48c0936b4df
children 6d6aa03e43fa
files xml/en/GNUmakefile xml/en/docs/http/ngx_http_gzip_static_module.xml xml/en/docs/http/ngx_http_memcached_module.xml xml/en/docs/index.xml xml/ru/GNUmakefile xml/ru/docs/http/ngx_http_gzip_static_module.xml xml/ru/docs/http/ngx_http_memcached_module.xml xml/ru/docs/index.xml
diffstat 8 files changed, 74 insertions(+), 4 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/GNUmakefile
+++ b/xml/en/GNUmakefile
@@ -47,6 +47,7 @@ REFS =									\
 		http/ngx_http_flv_module				\
 		http/ngx_http_geo_module				\
 		http/ngx_http_geoip_module				\
+		http/ngx_http_gunzip_module				\
 		http/ngx_http_gzip_module				\
 		http/ngx_http_gzip_static_module			\
 		http/ngx_http_headers_module				\
--- a/xml/en/docs/http/ngx_http_gzip_static_module.xml
+++ b/xml/en/docs/http/ngx_http_gzip_static_module.xml
@@ -44,14 +44,18 @@ gzip_proxied expired no-cache no-store p
 <section id="directives" name="Directives">
 
 <directive name="gzip_static">
-<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<syntax>
+    <literal>on</literal> |
+    <literal>off</literal> |
+    <literal>always</literal></syntax>
 <default>off</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 
 <para>
-Enables or disables checking the existence of precompressed files.
+Enables (“<literal>on</literal>”) or disables (“<literal>off</literal>”)
+checking the existence of precompressed files.
 The following directives are also taken into account:
 <link doc="ngx_http_gzip_module.xml" id="gzip_http_version"/>,
 <link doc="ngx_http_gzip_module.xml" id="gzip_proxied"/>,
@@ -60,6 +64,14 @@ and <link doc="ngx_http_gzip_module.xml"
 </para>
 
 <para>
+With the “<literal>always</literal>” value (1.3.6), gzipped file is used
+in all cases, without checking if the client supports it.
+It is useful if there are no uncompressed files on the disk anyway
+or the <link doc="ngx_http_gunzip_module.xml">ngx_http_gunzip_module</link>
+is used.
+</para>
+
+<para>
 The files can be compressed using the <command>gzip</command> command,
 or any other compatible.
 It is recommended that the modification date and time of original and
--- a/xml/en/docs/http/ngx_http_memcached_module.xml
+++ b/xml/en/docs/http/ngx_http_memcached_module.xml
@@ -79,6 +79,24 @@ It should be noted that this timeout can
 </directive>
 
 
+<directive name="memcached_gzip_flag">
+<syntax><value>flag</value></syntax>
+<default></default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.3.6</appeared-in>
+
+<para>
+Enables the test for the <value>flag</value> presence in the memcached
+server response and sets the request header field
+“<literal>Content-Encoding</literal>” to “<literal>gzip</literal>”
+if the flag is set.
+</para>
+
+</directive>
+
+
 <directive name="memcached_next_upstream">
 <syntax>
     <literal>error</literal> |
--- a/xml/en/docs/index.xml
+++ b/xml/en/docs/index.xml
@@ -173,6 +173,11 @@ ngx_http_geoip_module</link>
 </listitem>
 
 <listitem>
+<link doc="http/ngx_http_gunzip_module.xml">
+ngx_http_gunzip_module</link>
+</listitem>
+
+<listitem>
 <link doc="http/ngx_http_gzip_module.xml">
 ngx_http_gzip_module</link>
 </listitem>
--- a/xml/ru/GNUmakefile
+++ b/xml/ru/GNUmakefile
@@ -40,6 +40,7 @@ REFS =									\
 		http/ngx_http_flv_module				\
 		http/ngx_http_geo_module				\
 		http/ngx_http_geoip_module				\
+		http/ngx_http_gunzip_module				\
 		http/ngx_http_gzip_module				\
 		http/ngx_http_gzip_static_module			\
 		http/ngx_http_headers_module				\
--- a/xml/ru/docs/http/ngx_http_gzip_static_module.xml
+++ b/xml/ru/docs/http/ngx_http_gzip_static_module.xml
@@ -44,14 +44,18 @@ gzip_proxied expired no-cache no-store p
 <section id="directives" name="Директивы">
 
 <directive name="gzip_static">
-<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<syntax>
+    <literal>on</literal> |
+    <literal>off</literal> |
+    <literal>always</literal></syntax>
 <default>off</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 
 <para>
-Разрешает или запрещает проверку готового сжатого файла.
+Разрешает (“<literal>on</literal>”) или запрещает (“<literal>off</literal>”)
+проверку готового сжатого файла.
 При использовании также учитываются директивы
 <link doc="ngx_http_gzip_module.xml" id="gzip_http_version"/>,
 <link doc="ngx_http_gzip_module.xml" id="gzip_proxied"/>,
@@ -60,6 +64,13 @@ gzip_proxied expired no-cache no-store p
 </para>
 
 <para>
+Со значением “<literal>always</literal>” (1.3.6) во всех случаях будет
+использоваться сжатый файл, без проверки поддержки на стороне клиента.
+Это полезно, если на диске всё равно нет несжатых файлов, или используется
+модуль <link doc="ngx_http_gunzip_module.xml">ngx_http_gunzip_module</link>.
+</para>
+
+<para>
 Сжимать файлы можно с помощью программы <command>gzip</command>
 или совместимой с ней.
 Желательно, чтобы дата и время модификации исходного и сжатого файлов совпадали.
--- a/xml/ru/docs/http/ngx_http_memcached_module.xml
+++ b/xml/ru/docs/http/ngx_http_memcached_module.xml
@@ -79,6 +79,23 @@ server {
 </directive>
 
 
+<directive name="memcached_gzip_flag">
+<syntax><value>флаг</value></syntax>
+<default></default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.3.6</appeared-in>
+
+<para>
+Включает проверку  указанного <value>флага</value> в ответе
+сервера memcached и установку поля “<literal>Content-Encoding</literal>”
+заголовка ответа в “<literal>gzip</literal>”, если этот флаг установлен.
+</para>
+
+</directive>
+
+
 <directive name="memcached_next_upstream">
 <syntax>
     <literal>error</literal> |
--- a/xml/ru/docs/index.xml
+++ b/xml/ru/docs/index.xml
@@ -162,6 +162,11 @@ ngx_http_geoip_module</link>
 </listitem>
 
 <listitem>
+<link doc="http/ngx_http_gunzip_module.xml">
+ngx_http_gunzip_module</link>
+</listitem>
+
+<listitem>
 <link doc="http/ngx_http_gzip_module.xml">
 ngx_http_gzip_module</link>
 </listitem>