changeset 676:6d6aa03e43fa

Actually added gunzip module documentation files.
author Vladimir Homutov <vl@nginx.com>
date Wed, 12 Sep 2012 09:36:37 +0000
parents 08140f6b7964
children 934fd358c944
files xml/en/docs/http/ngx_http_gunzip_module.xml xml/ru/docs/http/ngx_http_gunzip_module.xml
diffstat 2 files changed, 162 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/xml/en/docs/http/ngx_http_gunzip_module.xml	Wed Sep 12 09:36:37 2012 +0000
@@ -0,0 +1,80 @@
+<?xml version="1.0"?>
+
+<!--
+  Copyright (C) Maxim Dounin
+  Copyright (C) Nginx, Inc.
+  -->
+
+<!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
+
+<module name="Module ngx_http_gunzip_module"
+        link="/en/docs/http/ngx_http_gunzip_module.html"
+        lang="en"
+        rev="1">
+
+<section id="summary">
+
+<para>
+The <literal>ngx_http_gunzip_module</literal> module is a filter that
+decompresses responses returned with the
+“<literal>Content-Encoding: gzip</literal>” for clients that don’t support it.
+It may be useful if it is preferred to store the data compressed
+(to save space or disk/network IO), but it is undesirable
+to penalize clients without the gzip support.
+</para>
+
+<para>
+This module is not built by default, it should be enabled with the
+<literal>--with-http_gunzip_module</literal>
+configuration parameter.
+</para>
+
+</section>
+
+
+<section id="example" name="Example Configuration">
+
+<para>
+<example>
+location /storage/ {
+    gunzip on;
+    ...
+}
+</example>
+</para>
+
+</section>
+
+
+<section id="directives" name="Directives">
+
+<directive name="gunzip">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>off</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Enables or disables decompression of gzipped responses.
+</para>
+
+</directive>
+
+
+<directive name="gunzip_buffers">
+<syntax><value>number</value> <value>size</value></syntax>
+<default>32 4k|16 8k</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Specifies the number and size of buffers available for decompression.
+</para>
+
+</directive>
+
+</section>
+
+</module>
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/xml/ru/docs/http/ngx_http_gunzip_module.xml	Wed Sep 12 09:36:37 2012 +0000
@@ -0,0 +1,82 @@
+<?xml version="1.0"?>
+
+<!--
+  Copyright (C) Maxim Dounin
+  Copyright (C) Nginx, Inc.
+  -->
+
+<!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
+
+<module name="Модуль ngx_http_gunzip_module"
+        link="/ru/docs/http/ngx_http_gunzip_module.html"
+        lang="ru"
+        rev="1">
+
+<section id="summary">
+
+<para>
+Модуль <literal>ngx_http_gunzip_module</literal> это фильтр, распаковывающий
+ответы, возвращаемые с “<literal>Content-Encoding: gzip</literal>”,
+для тех клиентов, которые не поддерживают данный метод.
+Это может быть полезно, если предпочтительно хранить данные сжатыми
+(чтобы сэкономить пространство или дисковые/сетевые операции
+ввода/вывода), но при этом нежелательно причинять неудобства клиентам,
+которые не поддерживают сжатие методом gzip.
+</para>
+
+<para>
+По умолчанию этот модуль не собирается, его сборку необходимо
+разрешить с помощью конфигурационного параметра
+<literal>--with-http_gunzip_module</literal>.
+</para>
+
+</section>
+
+
+<section id="example" name="Пример конфигурации">
+
+<para>
+<example>
+location /storage/ {
+    gunzip on;
+    ...
+}
+</example>
+</para>
+
+</section>
+
+
+<section id="directives" name="Директивы">
+
+<directive name="gunzip">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>off</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Разрешает или запрещает распаковку ответов, сжатых методом
+<literal>“gzip”</literal>.
+</para>
+
+</directive>
+
+
+<directive name="gunzip_buffers">
+<syntax><value>число</value> <value>размер</value></syntax>
+<default>32 4k|16 8k</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Задаёт число и размер буферов, доступных для распаковки.
+</para>
+
+</directive>
+
+</section>
+
+</module>