# HG changeset patch
# User Yaroslav Zhuravlev <yar@nginx.com>
# Date 1487701433 -10800
# Node ID ec4af97e4403971c66556d88c85336474dcc26a1
# Parent  f024ac0ec5c770d2d6752121b37a6f77de5b4f17
Split off header options from parameters in proxy_cache_use_stale and friends.

diff -r f024ac0ec5c7 -r ec4af97e4403 xml/en/docs/http/ngx_http_fastcgi_module.xml
--- a/xml/en/docs/http/ngx_http_fastcgi_module.xml	Fri Feb 17 17:58:53 2017 +0300
+++ b/xml/en/docs/http/ngx_http_fastcgi_module.xml	Tue Feb 21 21:23:53 2017 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_fastcgi_module"
         link="/en/docs/http/ngx_http_fastcgi_module.html"
         lang="en"
-        rev="42">
+        rev="43">
 
 <section id="summary">
 
@@ -631,11 +631,6 @@
 The <literal>error</literal> parameter also permits
 using a stale cached response if a FastCGI server to process a request
 cannot be selected.
-The same behavior can be enabled with the
-“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>”
-extension of the <header>Cache-Control</header> response header field (1.11.10)
-for a specified number of seconds after the response became stale,
-however, this has lower priority than using the directive parameter.
 </para>
 
 <para id="fastcgi_cache_use_stale_updating">
@@ -643,11 +638,30 @@
 using a stale cached response if it is currently being updated.
 This allows minimizing the number of accesses to FastCGI servers
 when updating cached data.
-The same behavior can be enabled with the
+</para>
+
+<para>
+Using a stale cached response
+can also be enabled directly in the response header
+for a specified number of seconds after the response became stale (1.11.10).
+This has lower priority than using the directive parameters.
+<list type="bullet" compact="no">
+
+<listitem>
+The
 “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>”
-extension of the <header>Cache-Control</header> response header field (1.11.10)
-for a specified number of seconds after the response became stale,
-however, this has lower priority than using the directive parameter.
+extension of the <header>Cache-Control</header> header field permits
+using a stale cached response if it is currently being updated.
+</listitem>
+
+<listitem>
+The
+“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>”
+extension of the <header>Cache-Control</header> header field permits
+using a stale cached response in case of an error.
+</listitem>
+
+</list>
 </para>
 
 <para>
diff -r f024ac0ec5c7 -r ec4af97e4403 xml/en/docs/http/ngx_http_proxy_module.xml
--- a/xml/en/docs/http/ngx_http_proxy_module.xml	Fri Feb 17 17:58:53 2017 +0300
+++ b/xml/en/docs/http/ngx_http_proxy_module.xml	Tue Feb 21 21:23:53 2017 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_proxy_module"
         link="/en/docs/http/ngx_http_proxy_module.html"
         lang="en"
-        rev="56">
+        rev="57">
 
 <section id="summary">
 
@@ -649,11 +649,6 @@
 The <literal>error</literal> parameter also permits
 using a stale cached response if a proxied server to process a request
 cannot be selected.
-The same behavior can be enabled with the
-“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>”
-extension of the <header>Cache-Control</header> response header field (1.11.10)
-for a specified number of seconds after the response became stale,
-however, this has lower priority than using the directive parameter.
 </para>
 
 <para id="proxy_cache_use_stale_updating">
@@ -661,11 +656,30 @@
 using a stale cached response if it is currently being updated.
 This allows minimizing the number of accesses to proxied servers
 when updating cached data.
-The same behavior can be enabled with the
+</para>
+
+<para>
+Using a stale cached response
+can also be enabled directly in the response header
+for a specified number of seconds after the response became stale (1.11.10).
+This has lower priority than using the directive parameters.
+<list type="bullet" compact="no">
+
+<listitem>
+The
 “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>”
-extension of the <header>Cache-Control</header> response header field (1.11.10)
-for a specified number of seconds after the response became stale,
-however, this has lower priority than using the directive parameter.
+extension of the <header>Cache-Control</header> header field permits
+using a stale cached response if it is currently being updated.
+</listitem>
+
+<listitem>
+The
+“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>”
+extension of the <header>Cache-Control</header> header field permits
+using a stale cached response in case of an error.
+</listitem>
+
+</list>
 </para>
 
 <para>
diff -r f024ac0ec5c7 -r ec4af97e4403 xml/en/docs/http/ngx_http_scgi_module.xml
--- a/xml/en/docs/http/ngx_http_scgi_module.xml	Fri Feb 17 17:58:53 2017 +0300
+++ b/xml/en/docs/http/ngx_http_scgi_module.xml	Tue Feb 21 21:23:53 2017 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_scgi_module"
         link="/en/docs/http/ngx_http_scgi_module.html"
         lang="en"
-        rev="31">
+        rev="32">
 
 <section id="summary">
 
@@ -622,11 +622,6 @@
 The <literal>error</literal> parameter also permits
 using a stale cached response if an SCGI server to process a request
 cannot be selected.
-The same behavior can be enabled with the
-“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>”
-extension of the <header>Cache-Control</header> response header field (1.11.10)
-for a specified number of seconds after the response became stale,
-however, this has lower priority than using the directive parameter.
 </para>
 
 <para id="scgi_cache_use_stale_updating">
@@ -634,11 +629,30 @@
 using a stale cached response if it is currently being updated.
 This allows minimizing the number of accesses to SCGI servers
 when updating cached data.
-The same behavior can be enabled with the
+</para>
+
+<para>
+Using a stale cached response
+can also be enabled directly in the response header
+for a specified number of seconds after the response became stale (1.11.10).
+This has lower priority than using the directive parameters.
+<list type="bullet" compact="no">
+
+<listitem>
+The
 “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>”
-extension of the <header>Cache-Control</header> response header field (1.11.10)
-for a specified number of seconds after the response became stale,
-however, this has lower priority than using the directive parameter.
+extension of the <header>Cache-Control</header> header field permits
+using a stale cached response if it is currently being updated.
+</listitem>
+
+<listitem>
+The
+“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>”
+extension of the <header>Cache-Control</header> header field permits
+using a stale cached response in case of an error.
+</listitem>
+
+</list>
 </para>
 
 <para>
diff -r f024ac0ec5c7 -r ec4af97e4403 xml/en/docs/http/ngx_http_uwsgi_module.xml
--- a/xml/en/docs/http/ngx_http_uwsgi_module.xml	Fri Feb 17 17:58:53 2017 +0300
+++ b/xml/en/docs/http/ngx_http_uwsgi_module.xml	Tue Feb 21 21:23:53 2017 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_uwsgi_module"
         link="/en/docs/http/ngx_http_uwsgi_module.html"
         lang="en"
-        rev="34">
+        rev="35">
 
 <section id="summary">
 
@@ -622,11 +622,6 @@
 The <literal>error</literal> parameter also permits
 using a stale cached response if a uwsgi server to process a request
 cannot be selected.
-The same behavior can be enabled with the
-“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>”
-extension of the <header>Cache-Control</header> response header field (1.11.10)
-for a specified number of seconds after the response became stale,
-however, this has lower priority than using the directive parameter.
 </para>
 
 <para id="uwsgi_cache_use_stale_updating">
@@ -634,11 +629,30 @@
 using a stale cached response if it is currently being updated.
 This allows minimizing the number of accesses to uwsgi servers
 when updating cached data.
-The same behavior can be enabled with the
+</para>
+
+<para>
+Using a stale cached response
+can also be enabled directly in the response header
+for a specified number of seconds after the response became stale (1.11.10).
+This has lower priority than using the directive parameters.
+<list type="bullet" compact="no">
+
+<listitem>
+The
 “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>”
-extension of the <header>Cache-Control</header> response header field (1.11.10)
-for a specified number of seconds after the response became stale,
-however, this has lower priority than using the directive parameter.
+extension of the <header>Cache-Control</header> header field permits
+using a stale cached response if it is currently being updated.
+</listitem>
+
+<listitem>
+The
+“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>”
+extension of the <header>Cache-Control</header> header field permits
+using a stale cached response in case of an error.
+</listitem>
+
+</list>
 </para>
 
 <para>
diff -r f024ac0ec5c7 -r ec4af97e4403 xml/ru/docs/http/ngx_http_fastcgi_module.xml
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Fri Feb 17 17:58:53 2017 +0300
+++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Tue Feb 21 21:23:53 2017 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_fastcgi_module"
         link="/ru/docs/http/ngx_http_fastcgi_module.html"
         lang="ru"
-        rev="42">
+        rev="43">
 
 <section id="summary">
 
@@ -629,11 +629,6 @@
 Параметр <literal>error</literal> также позволяет использовать
 устаревший закэшированный ответ при невозможности выбора
 FastCGI-сервера для обработки запроса.
-Подобное поведение может быть также задано при помощи расширения
-“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>”
-поля <header>Cache-Control</header> заголовка ответа (1.11.10)
-на определённое количество секунд после того, как ответ стал устаревшим,
-но такой способ имеет меньший приоритет, чем задание параметра директивы.
 </para>
 
 <para id="fastcgi_cache_use_stale_updating">
@@ -642,11 +637,31 @@
 если на данный момент он уже обновляется.
 Это позволяет минимизировать число обращений к FastCGI-серверам
 при обновлении закэшированных данных.
-Подобное поведение может быть также задано при помощи расширения
+</para>
+
+<para>
+Использование устаревшего закэшированного ответа
+может также быть разрешено непосредственно в заголовке ответа
+на определённое количество секунд после того, как ответ устарел (1.11.10).
+Такой способ менее приоритетен, чем задание параметров директивы.
+<list type="bullet" compact="no">
+
+<listitem>
+Расширение
 “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>”
-поля <header>Cache-Control</header> заголовка ответа (1.11.10)
-на определённое количество секунд после того, как ответ стал устаревшим,
-но такой способ имеет меньший приоритет, чем задание параметра директивы.
+поля заголовка <header>Cache-Control</header> разрешает
+использовать устаревший закэшированный ответ,
+если на данный момент он уже обновляется.
+</listitem>
+
+<listitem>
+Расширение
+“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>”
+поля заголовка <header>Cache-Control</header> разрешает
+использовать устаревший закэшированный ответ в случае ошибки.
+</listitem>
+
+</list>
 </para>
 
 <para>
diff -r f024ac0ec5c7 -r ec4af97e4403 xml/ru/docs/http/ngx_http_proxy_module.xml
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml	Fri Feb 17 17:58:53 2017 +0300
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml	Tue Feb 21 21:23:53 2017 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_proxy_module"
         link="/ru/docs/http/ngx_http_proxy_module.html"
         lang="ru"
-        rev="56">
+        rev="57">
 
 <section id="summary">
 
@@ -649,11 +649,6 @@
 Параметр <literal>error</literal> также позволяет использовать
 устаревший закэшированный ответ при невозможности выбора
 проксированного сервера для обработки запроса.
-Подобное поведение может быть также задано при помощи расширения
-“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>”
-поля <header>Cache-Control</header> заголовка ответа (1.11.10)
-на определённое количество секунд после того, как ответ стал устаревшим,
-но такой способ имеет меньший приоритет, чем задание параметра директивы.
 </para>
 
 <para id="proxy_cache_use_stale_updating">
@@ -662,11 +657,31 @@
 если на данный момент он уже обновляется.
 Это позволяет минимизировать число обращений к проксированным серверам
 при обновлении закэшированных данных.
-Подобное поведение может быть также задано при помощи расширения
+</para>
+
+<para>
+Использование устаревшего закэшированного ответа
+может также быть разрешено непосредственно в заголовке ответа
+на определённое количество секунд после того, как ответ устарел (1.11.10).
+Такой способ менее приоритетен, чем задание параметров директивы.
+<list type="bullet" compact="no">
+
+<listitem>
+Расширение
 “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>”
-поля <header>Cache-Control</header> заголовка ответа (1.11.10)
-на определённое количество секунд после того, как ответ стал устаревшим,
-но такой способ имеет меньший приоритет, чем задание параметра директивы.
+поля заголовка <header>Cache-Control</header> разрешает
+использовать устаревший закэшированный ответ,
+если на данный момент он уже обновляется.
+</listitem>
+
+<listitem>
+Расширение
+“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>”
+поля заголовка <header>Cache-Control</header> разрешает
+использовать устаревший закэшированный ответ в случае ошибки.
+</listitem>
+
+</list>
 </para>
 
 <para>
diff -r f024ac0ec5c7 -r ec4af97e4403 xml/ru/docs/http/ngx_http_scgi_module.xml
--- a/xml/ru/docs/http/ngx_http_scgi_module.xml	Fri Feb 17 17:58:53 2017 +0300
+++ b/xml/ru/docs/http/ngx_http_scgi_module.xml	Tue Feb 21 21:23:53 2017 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_scgi_module"
         link="/ru/docs/http/ngx_http_scgi_module.html"
         lang="ru"
-        rev="31">
+        rev="32">
 
 <section id="summary">
 
@@ -620,11 +620,6 @@
 Параметр <literal>error</literal> также позволяет использовать
 устаревший закэшированный ответ при невозможности выбора
 SCGI-сервера для обработки запроса.
-Подобное поведение может быть также задано при помощи расширения
-“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>”
-поля <header>Cache-Control</header> заголовка ответа (1.11.10)
-на определённое количество секунд после того, как ответ стал устаревшим,
-но такой способ имеет меньший приоритет, чем задание параметра директивы.
 </para>
 
 <para id="scgi_cache_use_stale_updating">
@@ -633,11 +628,31 @@
 если на данный момент он уже обновляется.
 Это позволяет минимизировать число обращений к SCGI-серверам
 при обновлении закэшированных данных.
-Подобное поведение может быть также задано при помощи расширения
+</para>
+
+<para>
+Использование устаревшего закэшированного ответа
+может также быть разрешено непосредственно в заголовке ответа
+на определённое количество секунд после того, как ответ устарел (1.11.10).
+Такой способ менее приоритетен, чем задание параметров директивы.
+<list type="bullet" compact="no">
+
+<listitem>
+Расширение
 “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>”
-поля <header>Cache-Control</header> заголовка ответа (1.11.10)
-на определённое количество секунд после того, как ответ стал устаревшим,
-но такой способ имеет меньший приоритет, чем задание параметра директивы.
+поля заголовка <header>Cache-Control</header> разрешает
+использовать устаревший закэшированный ответ,
+если на данный момент он уже обновляется.
+</listitem>
+
+<listitem>
+Расширение
+“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>”
+поля заголовка <header>Cache-Control</header> разрешает
+использовать устаревший закэшированный ответ в случае ошибки.
+</listitem>
+
+</list>
 </para>
 
 <para>
diff -r f024ac0ec5c7 -r ec4af97e4403 xml/ru/docs/http/ngx_http_uwsgi_module.xml
--- a/xml/ru/docs/http/ngx_http_uwsgi_module.xml	Fri Feb 17 17:58:53 2017 +0300
+++ b/xml/ru/docs/http/ngx_http_uwsgi_module.xml	Tue Feb 21 21:23:53 2017 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_uwsgi_module"
         link="/ru/docs/http/ngx_http_uwsgi_module.html"
         lang="ru"
-        rev="34">
+        rev="35">
 
 <section id="summary">
 
@@ -619,11 +619,6 @@
 Параметр <literal>error</literal> также позволяет использовать
 устаревший закэшированный ответ при невозможности выбора
 uwsgi-сервера для обработки запроса.
-Подобное поведение может быть также задано при помощи расширения
-“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>”
-поля <header>Cache-Control</header> заголовка ответа (1.11.10)
-на определённое количество секунд после того, как ответ стал устаревшим,
-но такой способ имеет меньший приоритет, чем задание параметра директивы.
 </para>
 
 <para id="uwsgi_cache_use_stale_updating">
@@ -632,11 +627,31 @@
 если на данный момент он уже обновляется.
 Это позволяет минимизировать число обращений к uwsgi-серверам
 при обновлении закэшированных данных.
-Подобное поведение может быть также задано при помощи расширения
+</para>
+
+<para>
+Использование устаревшего закэшированного ответа
+может также быть разрешено непосредственно в заголовке ответа
+на определённое количество секунд после того, как ответ устарел (1.11.10).
+Такой способ менее приоритетен, чем задание параметров директивы.
+<list type="bullet" compact="no">
+
+<listitem>
+Расширение
 “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>”
-поля <header>Cache-Control</header> заголовка ответа (1.11.10)
-на определённое количество секунд после того, как ответ стал устаревшим,
-но такой способ имеет меньший приоритет, чем задание параметра директивы.
+поля заголовка <header>Cache-Control</header> разрешает
+использовать устаревший закэшированный ответ,
+если на данный момент он уже обновляется.
+</listitem>
+
+<listitem>
+Расширение
+“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>”
+поля заголовка <header>Cache-Control</header> разрешает
+использовать устаревший закэшированный ответ в случае ошибки.
+</listitem>
+
+</list>
 </para>
 
 <para>