# HG changeset patch
# User Yaroslav Zhuravlev <yar@nginx.com>
# Date 1482248673 -10800
# Node ID 33f74203215587c63dd6402ef768bfa6b50291c0
# Parent  2f851f71ff0816783b76200403cfb172ebbcc883
Documented support for json escaping in log_format.

diff --git a/xml/en/docs/http/ngx_http_log_module.xml b/xml/en/docs/http/ngx_http_log_module.xml
--- 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="15">
+        rev="16">
 
 <section id="summary">
 
@@ -194,6 +194,7 @@ access_log /path/to/access.log combined 
 <directive name="log_format">
 <syntax>
     <value>name</value>
+    [<literal>escape</literal>=<value>default</value>|<value>json</value>]
     <value>string</value> ...</syntax>
 <default>combined "..."</default>
 <context>http</context>
@@ -202,6 +203,12 @@ access_log /path/to/access.log combined 
 Specifies log format.
 </para>
 
+<para id="log_format_escape">
+The <literal>escape</literal> parameter (1.11.8) allows setting
+<value>json</value> or <value>default</value> characters escaping in variables,
+by default, <value>default</value> escaping is used.
+</para>
+
 <para>
 The log format can contain common variables, and variables that
 exist only at the time of a log write:
diff --git a/xml/en/docs/stream/ngx_stream_log_module.xml b/xml/en/docs/stream/ngx_stream_log_module.xml
--- 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="3">
+        rev="4">
 
 <section id="summary">
 
@@ -155,6 +155,7 @@ or an empty string.
 <directive name="log_format">
 <syntax>
     <value>name</value>
+    [<literal>escape</literal>=<value>default</value>|<value>json</value>]
     <value>string</value> ...</syntax>
 <default></default>
 <context>stream</context>
@@ -169,6 +170,12 @@ log_format proxy '$remote_addr [$time_lo
 </example>
 </para>
 
+<para id="log_format_escape">
+The <literal>escape</literal> parameter (1.11.8) allows setting
+<value>json</value> or <value>default</value> characters escaping in variables,
+by default, <value>default</value> escaping is used.
+</para>
+
 </directive>
 
 
diff --git a/xml/ru/docs/http/ngx_http_log_module.xml b/xml/ru/docs/http/ngx_http_log_module.xml
--- 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="15">
+        rev="16">
 
 <section id="summary">
 
@@ -192,6 +192,7 @@ access_log /path/to/access.log combined 
 <directive name="log_format">
 <syntax>
     <value>название</value>
+    [<literal>escape</literal>=<value>default</value>|<value>json</value>]
     <value>строка</value> ...</syntax>
 <default>combined "..."</default>
 <context>http</context>
@@ -200,6 +201,13 @@ access_log /path/to/access.log combined 
 Задаёт формат лога.
 </para>
 
+<para id="log_format_escape">
+Параметр <literal>escape</literal> (1.11.8) позволяет задать
+экранирование символов <value>json</value> или <value>default</value>
+в переменных,
+по умолчанию используется <value>default</value>.
+</para>
+
 <para>
 Кроме общих переменных в формате можно использовать переменные,
 существующие только на момент записи в лог:
diff --git a/xml/ru/docs/stream/ngx_stream_log_module.xml b/xml/ru/docs/stream/ngx_stream_log_module.xml
--- 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="3">
+        rev="4">
 
 <section id="summary">
 
@@ -155,6 +155,7 @@ access_log /path/to/log.gz basic gzip fl
 <directive name="log_format">
 <syntax>
     <value>название</value>
+    [<literal>escape</literal>=<value>default</value>|<value>json</value>]
     <value>строка</value> ...</syntax>
 <default></default>
 <context>stream</context>
@@ -169,6 +170,13 @@ log_format proxy '$remote_addr [$time_lo
 </example>
 </para>
 
+<para id="log_format_escape">
+Параметр <literal>escape</literal> (1.11.8) позволяет задать
+экранирование символов <value>json</value> или <value>default</value>
+в переменных,
+по умолчанию используется <value>default</value>.
+</para>
+
 </directive>