changeset 2111:dab82d534f0f

Documented the "none" escape mode of the "log_format" directive.
author Vladimir Homutov <vl@nginx.com>
date Fri, 02 Mar 2018 13:00:00 +0300
parents 26c251c8ede5
children 9f7e12cf974f
files xml/en/docs/http/ngx_http_log_module.xml xml/en/docs/stream/ngx_stream_log_module.xml xml/ru/docs/http/ngx_http_log_module.xml xml/ru/docs/stream/ngx_stream_log_module.xml
diffstat 4 files changed, 14 insertions(+), 8 deletions(-) [+]
line wrap: on
line diff
--- 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="17">
+        rev="18">
 
 <section id="summary">
 
@@ -194,7 +194,7 @@ access_log /path/to/access.log combined 
 <directive name="log_format">
 <syntax>
     <value>name</value>
-    [<literal>escape</literal>=<literal>default</literal>|<literal>json</literal>]
+    [<literal>escape</literal>=<literal>default</literal>|<literal>json</literal>|<literal>none</literal>]
     <value>string</value> ...</syntax>
 <default>combined "..."</default>
 <context>http</context>
@@ -207,6 +207,7 @@ Specifies log format.
 The <literal>escape</literal> parameter (1.11.8) allows setting
 <literal>json</literal> or <literal>default</literal> characters escaping
 in variables, by default, <literal>default</literal> escaping is used.
+The <literal>none</literal> parameter (1.13.10) disables escaping.
 </para>
 
 <para>
--- a/xml/en/docs/stream/ngx_stream_log_module.xml
+++ b/xml/en/docs/stream/ngx_stream_log_module.xml
@@ -9,7 +9,7 @@
 <module name="Module ngx_stream_log_module"
         link="/en/docs/stream/ngx_stream_log_module.html"
         lang="en"
-        rev="5">
+        rev="6">
 
 <section id="summary">
 
@@ -155,7 +155,7 @@ or an empty string.
 <directive name="log_format">
 <syntax>
     <value>name</value>
-    [<literal>escape</literal>=<literal>default</literal>|<literal>json</literal>]
+    [<literal>escape</literal>=<literal>default</literal>|<literal>json</literal>|<literal>none</literal>]
     <value>string</value> ...</syntax>
 <default></default>
 <context>stream</context>
@@ -174,6 +174,7 @@ log_format proxy '$remote_addr [$time_lo
 The <literal>escape</literal> parameter (1.11.8) allows setting
 <literal>json</literal> or <literal>default</literal> characters escaping
 in variables, by default, <literal>default</literal> escaping is used.
+The <literal>none</literal> parameter (1.13.10) disables escaping.
 </para>
 
 </directive>
--- 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="17">
+        rev="18">
 
 <section id="summary">
 
@@ -192,7 +192,7 @@ access_log /path/to/access.log combined 
 <directive name="log_format">
 <syntax>
     <value>название</value>
-    [<literal>escape</literal>=<literal>default</literal>|<literal>json</literal>]
+    [<literal>escape</literal>=<literal>default</literal>|<literal>json</literal>|<literal>none</literal>]
     <value>строка</value> ...</syntax>
 <default>combined "..."</default>
 <context>http</context>
@@ -205,6 +205,8 @@ access_log /path/to/access.log combined 
 Параметр <literal>escape</literal> (1.11.8) позволяет задать
 экранирование символов <literal>json</literal> или <literal>default</literal>
 в переменных, по умолчанию используется <literal>default</literal>.
+Параметр <literal>none</literal> (1.13.10) отключает
+экранирование символов.
 </para>
 
 <para>
--- a/xml/ru/docs/stream/ngx_stream_log_module.xml
+++ b/xml/ru/docs/stream/ngx_stream_log_module.xml
@@ -9,7 +9,7 @@
 <module name="Модуль ngx_stream_log_module"
         link="/ru/docs/stream/ngx_stream_log_module.html"
         lang="ru"
-        rev="5">
+        rev="6">
 
 <section id="summary">
 
@@ -155,7 +155,7 @@ access_log /path/to/log.gz basic gzip fl
 <directive name="log_format">
 <syntax>
     <value>название</value>
-    [<literal>escape</literal>=<literal>default</literal>|<literal>json</literal>]
+    [<literal>escape</literal>=<literal>default</literal>|<literal>json</literal>|<literal>none</literal>]
     <value>строка</value> ...</syntax>
 <default></default>
 <context>stream</context>
@@ -174,6 +174,8 @@ log_format proxy '$remote_addr [$time_lo
 Параметр <literal>escape</literal> (1.11.8) позволяет задать
 экранирование символов <literal>json</literal> или <literal>default</literal>
 в переменных, по умолчанию используется <literal>default</literal>.
+Параметр <literal>none</literal> (1.13.10) отключает
+экранирование символов.
 </para>
 
 </directive>