changeset 2598:361a28cca097

Rephrased "off" parameter of proxy_cookie_domain/path/redirect.
author Yaroslav Zhuravlev <yar@nginx.com>
date Fri, 24 Jul 2020 13:43:21 +0100
parents c9545c331582
children 5c5a36560f97
files xml/en/docs/http/ngx_http_proxy_module.xml xml/ru/docs/http/ngx_http_proxy_module.xml
diffstat 2 files changed, 32 insertions(+), 73 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_proxy_module.xml
+++ b/xml/en/docs/http/ngx_http_proxy_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_proxy_module"
         link="/en/docs/http/ngx_http_proxy_module.html"
         lang="en"
-        rev="67">
+        rev="68">
 
 <section id="summary">
 
@@ -861,21 +861,15 @@ proxy_cookie_domain ~\.(?P&lt;sl_domain&
 </para>
 
 <para>
-There could be several <literal>proxy_cookie_domain</literal> directives:
+Several <literal>proxy_cookie_domain</literal> directives
+can be specified on the same level:
 <example>
 proxy_cookie_domain localhost example.org;
 proxy_cookie_domain ~\.([a-z]+\.[a-z]+)$ $1;
 </example>
-</para>
-
-<para>
-The <literal>off</literal> parameter cancels the effect of all
-<literal>proxy_cookie_domain</literal> directives on the current level:
-<example>
-proxy_cookie_domain off;
-proxy_cookie_domain localhost example.org;
-proxy_cookie_domain www.example.org example.org;
-</example>
+The <literal>off</literal> parameter cancels the effect
+of the <literal>proxy_cookie_domain</literal> directives
+inherited from the previous configuration level.
 </para>
 
 </directive>
@@ -927,21 +921,15 @@ proxy_cookie_path ~*^/user/([^/]+) /u/$1
 </para>
 
 <para>
-There could be several <literal>proxy_cookie_path</literal> directives:
+Several <literal>proxy_cookie_path</literal> directives
+can be specified on the same level:
 <example>
 proxy_cookie_path /one/ /;
 proxy_cookie_path / /two/;
 </example>
-</para>
-
-<para>
-The <literal>off</literal> parameter cancels the effect of all
-<literal>proxy_cookie_path</literal> directives on the current level:
-<example>
-proxy_cookie_path off;
-proxy_cookie_path /two/ /;
-proxy_cookie_path ~*^/user/([^/]+) /u/$1;
-</example>
+The <literal>off</literal> parameter cancels the effect
+of the <literal>proxy_cookie_path</literal> directives
+inherited from the previous configuration level.
 </para>
 
 </directive>
@@ -1657,23 +1645,16 @@ proxy_redirect ~*/user/([^/]+)/(.+)$    
 </para>
 
 <para>
-There could be several <literal>proxy_redirect</literal> directives:
+Several <literal>proxy_redirect</literal> directives
+can be specified on the same level:
 <example>
 proxy_redirect default;
 proxy_redirect http://localhost:8000/  /;
 proxy_redirect http://www.example.com/ /;
 </example>
-</para>
-
-<para>
-The <literal>off</literal> parameter cancels the effect of all
-<literal>proxy_redirect</literal> directives on the current level:
-<example>
-proxy_redirect off;
-proxy_redirect default;
-proxy_redirect http://localhost:8000/  /;
-proxy_redirect http://www.example.com/ /;
-</example>
+The <literal>off</literal> parameter cancels the effect
+of the <literal>proxy_redirect</literal> directives
+inherited from the previous configuration level.
 </para>
 
 <para>
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_proxy_module"
         link="/ru/docs/http/ngx_http_proxy_module.html"
         lang="ru"
-        rev="67">
+        rev="68">
 
 <section id="summary">
 
@@ -863,22 +863,15 @@ proxy_cookie_domain ~\.(?P&lt;sl_domain&
 </para>
 
 <para>
-Директив <literal>proxy_cookie_domain</literal> может быть несколько:
+На одном уровне может быть указано
+несколько директив <literal>proxy_cookie_domain</literal>:
 <example>
 proxy_cookie_domain localhost example.org;
 proxy_cookie_domain ~\.([a-z]+\.[a-z]+)$ $1;
 </example>
-</para>
-
-<para>
-Параметр <literal>off</literal> отменяет действие всех директив
-<literal>proxy_cookie_domain</literal>
-на данном уровне:
-<example>
-proxy_cookie_domain off;
-proxy_cookie_domain localhost example.org;
-proxy_cookie_domain www.example.org example.org;
-</example>
+Параметр <literal>off</literal> отменяет действие
+унаследованных с предыдущего уровня конфигурации
+директив <literal>proxy_cookie_domain</literal>.
 </para>
 
 </directive>
@@ -929,22 +922,15 @@ proxy_cookie_path ~*^/user/([^/]+) /u/$1
 </para>
 
 <para>
-Директив <literal>proxy_cookie_path</literal> может быть несколько:
+На одном уровне может быть указано
+несколько директив <literal>proxy_cookie_path</literal>:
 <example>
 proxy_cookie_path /one/ /;
 proxy_cookie_path / /two/;
 </example>
-</para>
-
-<para>
-Параметр <literal>off</literal> отменяет действие всех директив
-<literal>proxy_cookie_path</literal>
-на данном уровне:
-<example>
-proxy_cookie_path off;
-proxy_cookie_path /two/ /;
-proxy_cookie_path ~*^/user/([^/]+) /u/$1;
-</example>
+Параметр <literal>off</literal> отменяет действие
+унаследованных с предыдущего уровня конфигурации
+директив <literal>proxy_cookie_path</literal>.
 </para>
 
 </directive>
@@ -1662,24 +1648,16 @@ proxy_redirect ~*/user/([^/]+)/(.+)$    
 </para>
 
 <para>
-Директив <literal>proxy_redirect</literal> может быть несколько:
+На одном уровне может быть указано
+несколько директив <literal>proxy_redirect</literal>:
 <example>
 proxy_redirect default;
 proxy_redirect http://localhost:8000/  /;
 proxy_redirect http://www.example.com/ /;
 </example>
-</para>
-
-<para>
-Параметр <literal>off</literal> запрещает все директивы
-<literal>proxy_redirect</literal>
-на данном уровне:
-<example>
-proxy_redirect off;
-proxy_redirect default;
-proxy_redirect http://localhost:8000/  /;
-proxy_redirect http://www.example.com/ /;
-</example>
+Параметр <literal>off</literal> отменяет действие
+унаследованных с предыдущего уровня конфигурации
+директив <literal>proxy_redirect</literal>.
 </para>
 
 <para>