changeset 840:9dab69f2b71d

Documented nginx 1.2.7 changes. - variables support in the "auth_basic" directive; - new generic variables $pipe, $request_length, $time_iso8601, and $time_local; - IPv6 support in ngx_http_geo_module and ngx_http_geoip_module; - "gzip" and "flush" parameters of the "access_log" directive.
author Ruslan Ermilov <ru@nginx.com>
date Tue, 12 Feb 2013 16:45:45 +0400
parents 1a917e32c1da
children 73f1827f0f68
files xml/en/docs/http/ngx_http_auth_basic_module.xml xml/en/docs/http/ngx_http_core_module.xml xml/en/docs/http/ngx_http_geo_module.xml xml/en/docs/http/ngx_http_geoip_module.xml xml/en/docs/http/ngx_http_log_module.xml xml/ru/docs/http/ngx_http_auth_basic_module.xml xml/ru/docs/http/ngx_http_core_module.xml xml/ru/docs/http/ngx_http_geo_module.xml xml/ru/docs/http/ngx_http_geoip_module.xml xml/ru/docs/http/ngx_http_log_module.xml
diffstat 10 files changed, 39 insertions(+), 36 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_auth_basic_module.xml
+++ b/xml/en/docs/http/ngx_http_auth_basic_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_auth_basic_module"
         link="/en/docs/http/ngx_http_auth_basic_module.html"
         lang="en"
-        rev="4">
+        rev="5">
 
 <section id="summary">
 
@@ -58,7 +58,7 @@ location / {
 Enables validation of user name and password using the
 “HTTP Basic Authentication” protocol.
 The specified parameter is used as a <value>realm</value>.
-Value of the parameter can contain variables (1.3.10).
+Value of the parameter can contain variables (1.3.10, 1.2.7).
 The special value <literal>off</literal> allows to cancel the effect
 of the <literal>auth_basic</literal> directive
 inherited from the previous configuration level.
--- a/xml/en/docs/http/ngx_http_core_module.xml
+++ b/xml/en/docs/http/ngx_http_core_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_core_module"
         link="/en/docs/http/ngx_http_core_module.html"
         lang="en"
-        rev="16">
+        rev="17">
 
 <section id="directives" name="Directives">
 
@@ -2808,7 +2808,7 @@ PID of the worker process
 <tag-name id="var_pipe"><var>$pipe</var></tag-name>
 <tag-desc>
 “<literal>p</literal>” if request was pipelined, “<literal>.</literal>”
-otherwise (1.3.12)
+otherwise (1.3.12, 1.2.7)
 </tag-desc>
 
 <tag-name id="var_query_string"><var>$query_string</var></tag-name>
@@ -2891,7 +2891,8 @@ directives, and the request URI
 
 <tag-name id="var_request_length"><var>$request_length</var></tag-name>
 <tag-desc>
-request length (including request line, header, and request body) (1.3.12)
+request length (including request line, header, and request body)
+(1.3.12, 1.2.7)
 </tag-desc>
 
 <tag-name id="var_request_method"><var>$request_method</var></tag-name>
@@ -2970,12 +2971,12 @@ that support the <c-def>TCP_INFO</c-def>
 
 <tag-name id="var_time_iso8601"><var>$time_iso8601</var></tag-name>
 <tag-desc>
-local time in the ISO 8601 standard format (1.3.12)
+local time in the ISO 8601 standard format (1.3.12, 1.2.7)
 </tag-desc>
 
 <tag-name id="var_time_local"><var>$time_local</var></tag-name>
 <tag-desc>
-local time in the Common Log Format (1.3.12)
+local time in the Common Log Format (1.3.12, 1.2.7)
 </tag-desc>
 
 <tag-name id="var_uri"><var>$uri</var></tag-name>
--- a/xml/en/docs/http/ngx_http_geo_module.xml
+++ b/xml/en/docs/http/ngx_http_geo_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_geo_module"
         link="/en/docs/http/ngx_http_geo_module.html"
         lang="en"
-        rev="4">
+        rev="5">
 
 <section id="summary">
 
@@ -78,7 +78,7 @@ then the “<literal>255.255.255.255</literal>” address is used.
 Addresses are specified either as prefixes in CIDR notation
 (including individual addresses) or as ranges (0.7.23).
 <note>
-IPv6 prefixes are supported starting from version 1.3.10.
+IPv6 prefixes are supported starting from versions 1.3.10 and 1.2.7.
 </note>
 </para>
 
--- a/xml/en/docs/http/ngx_http_geoip_module.xml
+++ b/xml/en/docs/http/ngx_http_geoip_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_geoip_module"
         link="/en/docs/http/ngx_http_geoip_module.html"
         lang="en"
-        rev="3">
+        rev="4">
 
 <section id="summary">
 
@@ -21,7 +21,7 @@ whose values depend on the client IP add
 </para>
 
 <para>
-When using IPv6 databases (1.3.12),
+When using IPv6 databases (1.3.12, 1.2.7),
 IPv4 addresses are looked up as IPv4-mapped IPv6 addresses.
 </para>
 
--- a/xml/en/docs/http/ngx_http_log_module.xml
+++ b/xml/en/docs/http/ngx_http_log_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_log_module"
         link="/en/docs/http/ngx_http_log_module.html"
         lang="en"
-        rev="8">
+        rev="9">
 
 <section id="summary">
 
@@ -76,7 +76,8 @@ If format is not specified then the pred
 </para>
 
 <para>
-If either the <literal>buffer</literal> or <literal>gzip</literal> (1.3.10)
+If either the <literal>buffer</literal> or <literal>gzip</literal>
+(1.3.10, 1.2.7)
 parameter is used, writes to log will be buffered.
 <note>
 The buffer size must not exceed the size of the atomic write to a disk file.
@@ -94,7 +95,7 @@ if the next log line does not fit into t
 
 <listitem>
 if the buffered data is older than specified by the <literal>flush</literal>
-parameter (1.3.10);
+parameter (1.3.10, 1.2.7);
 </listitem>
 
 <listitem>
@@ -262,14 +263,14 @@ In modern versions of nginx variables
 <link doc="ngx_http_core_module.xml" id="var_request_time">$request_time</link>
 (1.3.9, 1.2.6),
 <link doc="ngx_http_core_module.xml" id="var_pipe">$pipe</link>
-(1.3.12),
+(1.3.12, 1.2.7),
 <link doc="ngx_http_core_module.xml" id="var_request_length">$request_length</link>
-(1.3.12),
+(1.3.12, 1.2.7),
 <link doc="ngx_http_core_module.xml" id="var_time_iso8601">$time_iso8601</link>
-(1.3.12),
+(1.3.12, 1.2.7),
 and
 <link doc="ngx_http_core_module.xml" id="var_time_local">$time_local</link>
-(1.3.12)
+(1.3.12, 1.2.7)
 are also available as common variables.
 </note>
 
--- a/xml/ru/docs/http/ngx_http_auth_basic_module.xml
+++ b/xml/ru/docs/http/ngx_http_auth_basic_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_auth_basic_module"
         link="/ru/docs/http/ngx_http_auth_basic_module.html"
         lang="ru"
-        rev="4">
+        rev="5">
 
 <section id="summary">
 
@@ -58,7 +58,7 @@ location / {
 Включает проверку имени и пароля пользователя по протоколу
 “HTTP Basic Authentication”.
 Заданный параметр используется в качестве <value>realm</value>.
-В значении параметра допустимо использование переменных (1.3.10).
+В значении параметра допустимо использование переменных (1.3.10, 1.2.7).
 Специальное значение <literal>off</literal> позволяет отменить действие
 унаследованной с предыдущего уровня конфигурации
 директивы <literal>auth_basic</literal>.
--- a/xml/ru/docs/http/ngx_http_core_module.xml
+++ b/xml/ru/docs/http/ngx_http_core_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_core_module"
         link="/ru/docs/http/ngx_http_core_module.html"
         lang="ru"
-        rev="16">
+        rev="17">
 
 <section id="directives" name="Директивы">
 
@@ -2795,7 +2795,7 @@ cookie <value>имя</value>
 <tag-name id="var_pipe"><var>$pipe</var></tag-name>
 <tag-desc>
 “<literal>p</literal>” если запрос был pipelined, иначе “<literal>.</literal>”
-(1.3.12)
+(1.3.12, 1.2.7)
 </tag-desc>
 
 <tag-name id="var_query_string"><var>$query_string</var></tag-name>
@@ -2876,7 +2876,8 @@ fastcgi_pass_request_body off</link>
 
 <tag-name id="var_request_length"><var>$request_length</var></tag-name>
 <tag-desc>
-длина запроса (включая строку запроса, заголовок и тело запроса) (1.3.12)
+длина запроса (включая строку запроса, заголовок и тело запроса)
+(1.3.12, 1.2.7)
 </tag-desc>
 
 <tag-name id="var_request_method"><var>$request_method</var></tag-name>
@@ -2944,12 +2945,12 @@ fastcgi_pass_request_body off</link>
 
 <tag-name id="var_time_iso8601"><var>$time_iso8601</var></tag-name>
 <tag-desc>
-локальное время в формате по стандарту ISO 8601 (1.3.12)
+локальное время в формате по стандарту ISO 8601 (1.3.12, 1.2.7)
 </tag-desc>
 
 <tag-name id="var_time_local"><var>$time_local</var></tag-name>
 <tag-desc>
-локальное время в Common Log Format (1.3.12)
+локальное время в Common Log Format (1.3.12, 1.2.7)
 </tag-desc>
 
 <tag-name id="var_tcpinfo_">
--- a/xml/ru/docs/http/ngx_http_geo_module.xml
+++ b/xml/ru/docs/http/ngx_http_geo_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_geo_module"
         link="/ru/docs/http/ngx_http_geo_module.html"
         lang="ru"
-        rev="4">
+        rev="5">
 
 <section id="summary">
 
@@ -79,7 +79,7 @@ geo $arg_remote_addr $geo {
 Адреса задаются либо префиксами в формате CIDR
 (включая одиночные адреса), либо в виде диапазонов (0.7.23).
 <note>
-IPv6-префиксы поддерживаются начиная с версии 1.3.10.
+IPv6-префиксы поддерживаются начиная с версий 1.3.10 и 1.2.7.
 </note>
 </para>
 
--- a/xml/ru/docs/http/ngx_http_geoip_module.xml
+++ b/xml/ru/docs/http/ngx_http_geoip_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_geoip_module"
         link="/ru/docs/http/ngx_http_geoip_module.html"
         lang="ru"
-        rev="3">
+        rev="4">
 
 <section id="summary">
 
@@ -21,7 +21,7 @@
 </para>
 
 <para>
-При использовании баз данных с поддержкой IPv6 (1.3.12)
+При использовании баз данных с поддержкой IPv6 (1.3.12, 1.2.7)
 IPv4-адреса ищутся отображёнными на IPv6.
 </para>
 
--- a/xml/ru/docs/http/ngx_http_log_module.xml
+++ b/xml/ru/docs/http/ngx_http_log_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_log_module"
         link="/ru/docs/http/ngx_http_log_module.html"
         lang="ru"
-        rev="8">
+        rev="9">
 
 <section id="summary">
 
@@ -78,7 +78,7 @@ access_log /spool/logs/nginx-access.log 
 
 <para>
 Если задан размер буфера с помощью параметра <literal>buffer</literal> или
-указан параметр <literal>gzip</literal> (1.3.10), то запись будет
+указан параметр <literal>gzip</literal> (1.3.10, 1.2.7), то запись будет
 буферизованной.
 <note>
 Размер буфера должен быть не больше размера атомарной записи в дисковый файл.
@@ -96,7 +96,7 @@ access_log /spool/logs/nginx-access.log 
 
 <listitem>
 если данные в буфере находятся дольше интервала времени, заданного
-параметром <literal>flush</literal> (1.3.10);
+параметром <literal>flush</literal> (1.3.10, 1.2.7);
 </listitem>
 
 <listitem>
@@ -259,14 +259,14 @@ server {
 <link doc="ngx_http_core_module.xml" id="var_request_time">$request_time</link>
 (1.3.9, 1.2.6),
 <link doc="ngx_http_core_module.xml" id="var_pipe">$pipe</link>
-(1.3.12),
+(1.3.12, 1.2.7),
 <link doc="ngx_http_core_module.xml" id="var_request_length">$request_length</link>
-(1.3.12),
+(1.3.12, 1.2.7),
 <link doc="ngx_http_core_module.xml" id="var_time_iso8601">$time_iso8601</link>
-(1.3.12)
+(1.3.12, 1.2.7)
 и
 <link doc="ngx_http_core_module.xml" id="var_time_local">$time_local</link>
-(1.3.12)
+(1.3.12, 1.2.7)
 также доступны как общие переменные.
 </note>