# HG changeset patch
# User Yaroslav Zhuravlev <yar@nginx.com>
# Date 1443628134 -10800
# Node ID 8973c7b3785465dfc735f22ac6073afd5ec56219
# Parent  201bf8fa69e5bb822e7b881ac9b4baa8d1a0370c
Updated commercial docs.

details:   http://hg.nginx.com/nginx.org-se/rev/23bf3610377f
branches:  se
changeset: 1814:23bf3610377f
user:      Yaroslav Zhuravlev <yar@nginx.com>
description:
Added purge parameters to proxy_cache_path and friends.
diffstat:

 xml/en/docs/http/ngx_http_fastcgi_module.xml |  60 +++++++++++++++++++++++++++-
 xml/en/docs/http/ngx_http_proxy_module.xml   |  60 +++++++++++++++++++++++++++-
 xml/en/docs/http/ngx_http_scgi_module.xml    |  60 +++++++++++++++++++++++++++-
 xml/en/docs/http/ngx_http_uwsgi_module.xml   |  60 +++++++++++++++++++++++++++-
 xml/ru/docs/http/ngx_http_fastcgi_module.xml |  60 +++++++++++++++++++++++++++-
 xml/ru/docs/http/ngx_http_proxy_module.xml   |  60 +++++++++++++++++++++++++++-
 xml/ru/docs/http/ngx_http_scgi_module.xml    |  60 +++++++++++++++++++++++++++-
 xml/ru/docs/http/ngx_http_uwsgi_module.xml   |  60 +++++++++++++++++++++++++++-
 8 files changed, 472 insertions(+), 8 deletions(-)

diffs (truncated from 672 to 500 lines):

diff -r 201bf8fa69e5 -r 8973c7b37854 xml/en/docs/http/ngx_http_fastcgi_module.xml
--- a/xml/en/docs/http/ngx_http_fastcgi_module.xml	Tue Oct 06 13:07:58 2015 +0300
+++ b/xml/en/docs/http/ngx_http_fastcgi_module.xml	Wed Sep 30 18:48:54 2015 +0300
@@ -329,7 +329,11 @@
     [<literal>max_size</literal>=<value>size</value>]
     [<literal>loader_files</literal>=<value>number</value>]
     [<literal>loader_sleep</literal>=<value>time</value>]
-    [<literal>loader_threshold</literal>=<value>time</value>]</syntax>
+    [<literal>loader_threshold</literal>=<value>time</value>]
+    [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>]
+    [<literal>purger_files</literal>=<value>number</value>]
+    [<literal>purger_sleep</literal>=<value>time</value>]
+    [<literal>purger_threshold</literal>=<value>time</value>]</syntax>
 <default/>
 <context>http</context>
 
@@ -402,6 +406,56 @@
 parameter (by default, 50 milliseconds) is made.
 </para>
 
+<para>
+Additionally,
+the following parameters are available as part of our
+<commercial_version>commercial subscription</commercial_version>:
+</para>
+
+<para>
+<list type="tag">
+
+<tag-name id="purger">
+<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>
+</tag-name>
+<tag-desc>
+Instructs whether cache entries that match a
+<link id="fastcgi_cache_purge">wildcard key</link>
+will be removed from the disk by the cache purger (1.7.12).
+Setting the parameter to <literal>on</literal>
+(default is <literal>off</literal>)
+will activate the “cache purger” process that
+permanently iterates through all cache entries
+and deletes the entries that match the wildcard key.
+</tag-desc>
+
+<tag-name id="purger_files">
+<literal>purger_files</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets the number of items that will be scanned during one iteration (1.7.12).
+By default, <literal>purger_files</literal> is set to 10.
+</tag-desc>
+
+<tag-name id="purger_threshold">
+<literal>purger_threshold</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets the duration of one iteration (1.7.12).
+By default, <literal>purger_threshold</literal> is set to 50 milliseconds.
+</tag-desc>
+
+<tag-name id="purger_sleep">
+<literal>purger_sleep</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets a pause between iterations (1.7.12).
+By default, <literal>purger_sleep</literal> is set to 50 milliseconds.
+</tag-desc>
+
+</list>
+</para>
+
 </directive>
 
 
@@ -427,6 +481,10 @@
 If the <link id="fastcgi_cache_key">cache key</link> of a purge request ends
 with an asterisk (“<literal>*</literal>”), all cache entries matching the
 wildcard key will be removed from the cache.
+However, these entries will remain on the disk until they are deleted
+for either <link id="fastcgi_cache_path">inactivity</link>,
+or processed by the <link id="purger">cache purger</link> (1.7.12),
+or a client attempts to access them.
 </para>
 
 <para>
diff -r 201bf8fa69e5 -r 8973c7b37854 xml/en/docs/http/ngx_http_proxy_module.xml
--- a/xml/en/docs/http/ngx_http_proxy_module.xml	Tue Oct 06 13:07:58 2015 +0300
+++ b/xml/en/docs/http/ngx_http_proxy_module.xml	Wed Sep 30 18:48:54 2015 +0300
@@ -327,7 +327,11 @@
     [<literal>max_size</literal>=<value>size</value>]
     [<literal>loader_files</literal>=<value>number</value>]
     [<literal>loader_sleep</literal>=<value>time</value>]
-    [<literal>loader_threshold</literal>=<value>time</value>]</syntax>
+    [<literal>loader_threshold</literal>=<value>time</value>]
+    [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>]
+    [<literal>purger_files</literal>=<value>number</value>]
+    [<literal>purger_sleep</literal>=<value>time</value>]
+    [<literal>purger_threshold</literal>=<value>time</value>]</syntax>
 <default/>
 <context>http</context>
 
@@ -400,6 +404,56 @@
 parameter (by default, 50 milliseconds) is made.
 </para>
 
+<para>
+Additionally,
+the following parameters are available as part of our
+<commercial_version>commercial subscription</commercial_version>:
+</para>
+
+<para>
+<list type="tag">
+
+<tag-name id="purger">
+<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>
+</tag-name>
+<tag-desc>
+Instructs whether cache entries that match a
+<link id="proxy_cache_purge">wildcard key</link>
+will be removed from the disk by the cache purger (1.7.12).
+Setting the parameter to <literal>on</literal>
+(default is <literal>off</literal>)
+will activate the “cache purger” process that
+permanently iterates through all cache entries
+and deletes the entries that match the wildcard key.
+</tag-desc>
+
+<tag-name id="purger_files">
+<literal>purger_files</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets the number of items that will be scanned during one iteration (1.7.12).
+By default, <literal>purger_files</literal> is set to 10.
+</tag-desc>
+
+<tag-name id="purger_threshold">
+<literal>purger_threshold</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets the duration of one iteration (1.7.12).
+By default, <literal>purger_threshold</literal> is set to 50 milliseconds.
+</tag-desc>
+
+<tag-name id="purger_sleep">
+<literal>purger_sleep</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets a pause between iterations (1.7.12).
+By default, <literal>purger_sleep</literal> is set to 50 milliseconds.
+</tag-desc>
+
+</list>
+</para>
+
 </directive>
 
 
@@ -425,6 +479,10 @@
 If the <link id="proxy_cache_key">cache key</link> of a purge request ends
 with an asterisk (“<literal>*</literal>”), all cache entries matching the
 wildcard key will be removed from the cache.
+However, these entries will remain on the disk until they are deleted
+for either <link id="proxy_cache_path">inactivity</link>,
+or processed by the <link id="purger">cache purger</link> (1.7.12),
+or a client attempts to access them.
 </para>
 
 <para>
diff -r 201bf8fa69e5 -r 8973c7b37854 xml/en/docs/http/ngx_http_scgi_module.xml
--- a/xml/en/docs/http/ngx_http_scgi_module.xml	Tue Oct 06 13:07:58 2015 +0300
+++ b/xml/en/docs/http/ngx_http_scgi_module.xml	Wed Sep 30 18:48:54 2015 +0300
@@ -320,7 +320,11 @@
     [<literal>max_size</literal>=<value>size</value>]
     [<literal>loader_files</literal>=<value>number</value>]
     [<literal>loader_sleep</literal>=<value>time</value>]
-    [<literal>loader_threshold</literal>=<value>time</value>]</syntax>
+    [<literal>loader_threshold</literal>=<value>time</value>]
+    [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>]
+    [<literal>purger_files</literal>=<value>number</value>]
+    [<literal>purger_sleep</literal>=<value>time</value>]
+    [<literal>purger_threshold</literal>=<value>time</value>]</syntax>
 <default/>
 <context>http</context>
 
@@ -393,6 +397,56 @@
 parameter (by default, 50 milliseconds) is made.
 </para>
 
+<para>
+Additionally,
+the following parameters are available as part of our
+<commercial_version>commercial subscription</commercial_version>:
+</para>
+
+<para>
+<list type="tag">
+
+<tag-name id="purger">
+<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>
+</tag-name>
+<tag-desc>
+Instructs whether cache entries that match a
+<link id="scgi_cache_purge">wildcard key</link>
+will be removed from the disk by the cache purger (1.7.12).
+Setting the parameter to <literal>on</literal>
+(default is <literal>off</literal>)
+will activate the “cache purger” process that
+permanently iterates through all cache entries
+and deletes the entries that match the wildcard key.
+</tag-desc>
+
+<tag-name id="purger_files">
+<literal>purger_files</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets the number of items that will be scanned during one iteration (1.7.12).
+By default, <literal>purger_files</literal> is set to 10.
+</tag-desc>
+
+<tag-name id="purger_threshold">
+<literal>purger_threshold</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets the duration of one iteration (1.7.12).
+By default, <literal>purger_threshold</literal> is set to 50 milliseconds.
+</tag-desc>
+
+<tag-name id="purger_sleep">
+<literal>purger_sleep</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets a pause between iterations (1.7.12).
+By default, <literal>purger_sleep</literal> is set to 50 milliseconds.
+</tag-desc>
+
+</list>
+</para>
+
 </directive>
 
 
@@ -418,6 +472,10 @@
 If the <link id="scgi_cache_key">cache key</link> of a purge request ends
 with an asterisk (“<literal>*</literal>”), all cache entries matching the
 wildcard key will be removed from the cache.
+However, these entries will remain on the disk until they are deleted
+for either <link id="scgi_cache_path">inactivity</link>,
+or processed by the <link id="purger">cache purger</link> (1.7.12),
+or a client attempts to access them.
 </para>
 
 <para>
diff -r 201bf8fa69e5 -r 8973c7b37854 xml/en/docs/http/ngx_http_uwsgi_module.xml
--- a/xml/en/docs/http/ngx_http_uwsgi_module.xml	Tue Oct 06 13:07:58 2015 +0300
+++ b/xml/en/docs/http/ngx_http_uwsgi_module.xml	Wed Sep 30 18:48:54 2015 +0300
@@ -320,7 +320,11 @@
     [<literal>max_size</literal>=<value>size</value>]
     [<literal>loader_files</literal>=<value>number</value>]
     [<literal>loader_sleep</literal>=<value>time</value>]
-    [<literal>loader_threshold</literal>=<value>time</value>]</syntax>
+    [<literal>loader_threshold</literal>=<value>time</value>]
+    [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>]
+    [<literal>purger_files</literal>=<value>number</value>]
+    [<literal>purger_sleep</literal>=<value>time</value>]
+    [<literal>purger_threshold</literal>=<value>time</value>]</syntax>
 <default/>
 <context>http</context>
 
@@ -393,6 +397,56 @@
 parameter (by default, 50 milliseconds) is made.
 </para>
 
+<para>
+Additionally,
+the following parameters are available as part of our
+<commercial_version>commercial subscription</commercial_version>:
+</para>
+
+<para>
+<list type="tag">
+
+<tag-name id="purger">
+<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>
+</tag-name>
+<tag-desc>
+Instructs whether cache entries that match a
+<link id="uwsgi_cache_purge">wildcard key</link>
+will be removed from the disk by the cache purger (1.7.12).
+Setting the parameter to <literal>on</literal>
+(default is <literal>off</literal>)
+will activate the “cache purger” process that
+permanently iterates through all cache entries
+and deletes the entries that match the wildcard key.
+</tag-desc>
+
+<tag-name id="purger_files">
+<literal>purger_files</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets the number of items that will be scanned during one iteration (1.7.12).
+By default, <literal>purger_files</literal> is set to 10.
+</tag-desc>
+
+<tag-name id="purger_threshold">
+<literal>purger_threshold</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets the duration of one iteration (1.7.12).
+By default, <literal>purger_threshold</literal> is set to 50 milliseconds.
+</tag-desc>
+
+<tag-name id="purger_sleep">
+<literal>purger_sleep</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets a pause between iterations (1.7.12).
+By default, <literal>purger_sleep</literal> is set to 50 milliseconds.
+</tag-desc>
+
+</list>
+</para>
+
 </directive>
 
 
@@ -418,6 +472,10 @@
 If the <link id="uwsgi_cache_key">cache key</link> of a purge request ends
 with an asterisk (“<literal>*</literal>”), all cache entries matching the
 wildcard key will be removed from the cache.
+However, these entries will remain on the disk until they are deleted
+for either <link id="uwsgi_cache_path">inactivity</link>,
+or processed by the <link id="purger">cache purger</link> (1.7.12),
+or a client attempts to access them.
 </para>
 
 <para>
diff -r 201bf8fa69e5 -r 8973c7b37854 xml/ru/docs/http/ngx_http_fastcgi_module.xml
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Tue Oct 06 13:07:58 2015 +0300
+++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Wed Sep 30 18:48:54 2015 +0300
@@ -328,7 +328,11 @@
     [<literal>max_size</literal>=<value>размер</value>]
     [<literal>loader_files</literal>=<value>число</value>]
     [<literal>loader_sleep</literal>=<value>время</value>]
-    [<literal>loader_threshold</literal>=<value>время</value>]</syntax>
+    [<literal>loader_threshold</literal>=<value>время</value>]
+    [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>]
+    [<literal>purger_files</literal>=<value>число</value>]
+    [<literal>purger_sleep</literal>=<value>время</value>]
+    [<literal>purger_threshold</literal>=<value>время</value>]</syntax>
 <default/>
 <context>http</context>
 
@@ -399,6 +403,56 @@
 <literal>loader_sleep</literal> (по умолчанию 50 миллисекунд).
 </para>
 
+<para>
+Кроме того,
+следующие параметры доступны как часть
+<commercial_version>коммерческой подписки</commercial_version>:
+</para>
+
+<para>
+<list type="tag">
+
+<tag-name id="purger">
+<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>
+</tag-name>
+<tag-desc>
+Указывает, будут ли записи в кэше, соответствующие
+<link id="fastcgi_cache_purge">маске</link>,
+удалены с диска при помощи процесса “cache purger” (1.7.12).
+Установка параметра в значение <value>on</value>
+(по умолчанию <value>off</value>)
+активирует процесс “cache purger”, который
+проходит по всем записям в кэше
+и удаляет записи, соответствующие этой маске.
+</tag-desc>
+
+<tag-name id="purger_files">
+<literal>purger_files</literal>=<value>число</value>
+</tag-name>
+<tag-desc>
+Задаёт число элементов, которые будут сканироваться за одну итерацию (1.7.12).
+По умолчанию <literal>purger_files</literal> равен 10.
+</tag-desc>
+
+<tag-name id="purger_threshold">
+<literal>purger_threshold</literal>=<value>время</value>
+</tag-name>
+<tag-desc>
+Задаёт продолжительность одной итерации (1.7.12).
+По умолчанию <literal>purger_threshold</literal> равен 50 миллисекундам.
+</tag-desc>
+
+<tag-name id="purger_sleep">
+<literal>purger_sleep</literal>=<value>время</value>
+</tag-name>
+<tag-desc>
+Задаёт паузу между итерациями (1.7.12).
+По умолчанию <literal>purger_sleep</literal> равен 50 миллисекундам.
+</tag-desc>
+
+</list>
+</para>
+
 </directive>
 
 
@@ -425,6 +479,10 @@
 запроса на очистку заканчивается
 звёздочкой (“<literal>*</literal>”), то все записи в кэше, соответствующие
 этой маске, будут удалены из кэша.
+Тем не менее, эти записи будут оставаться на диске или до момента удаления
+из-за <link id="fastcgi_cache_path">отсутствия обращения к данным</link>,
+или до обработки их процессом “<link id="purger">cache purger</link>” (1.7.12),
+или до попытки клиента получить к ним доступ.
 </para>
 
 <para>
diff -r 201bf8fa69e5 -r 8973c7b37854 xml/ru/docs/http/ngx_http_proxy_module.xml
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml	Tue Oct 06 13:07:58 2015 +0300
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml	Wed Sep 30 18:48:54 2015 +0300
@@ -326,7 +326,11 @@
     [<literal>max_size</literal>=<value>размер</value>]
     [<literal>loader_files</literal>=<value>число</value>]
     [<literal>loader_sleep</literal>=<value>время</value>]
-    [<literal>loader_threshold</literal>=<value>время</value>]</syntax>
+    [<literal>loader_threshold</literal>=<value>время</value>]
+    [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>]
+    [<literal>purger_files</literal>=<value>число</value>]
+    [<literal>purger_sleep</literal>=<value>время</value>]
+    [<literal>purger_threshold</literal>=<value>время</value>]</syntax>
 <default/>
 <context>http</context>
 
@@ -397,6 +401,56 @@
 <literal>loader_sleep</literal> (по умолчанию 50 миллисекунд).
 </para>
 
+<para>
+Кроме того,
+следующие параметры доступны как часть
+<commercial_version>коммерческой подписки</commercial_version>:
+</para>
+
+<para>
+<list type="tag">
+
+<tag-name id="purger">
+<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>
+</tag-name>
+<tag-desc>
+Указывает, будут ли записи в кэше, соответствующие
+<link id="proxy_cache_purge">маске</link>,
+удалены с диска при помощи процесса “cache purger” (1.7.12).
+Установка параметра в значение <value>on</value>
+(по умолчанию <value>off</value>)
+активирует процесс “cache purger”, который
+проходит по всем записям в кэше
+и удаляет записи, соответствующие этой маске.
+</tag-desc>
+
+<tag-name id="purger_files">
+<literal>purger_files</literal>=<value>число</value>
+</tag-name>
+<tag-desc>
+Задаёт число элементов, которые будут сканироваться за одну итерацию (1.7.12).
+По умолчанию <literal>purger_files</literal> равен 10.
+</tag-desc>
+
+<tag-name id="purger_threshold">
+<literal>purger_threshold</literal>=<value>время</value>
+</tag-name>
+<tag-desc>
+Задаёт продолжительность одной итерации (1.7.12).
+По умолчанию <literal>purger_threshold</literal> равен 50 миллисекундам.
+</tag-desc>
+
+<tag-name id="purger_sleep">
+<literal>purger_sleep</literal>=<value>время</value>
+</tag-name>
+<tag-desc>
+Задаёт паузу между итерациями (1.7.12).
+По умолчанию <literal>purger_sleep</literal> равен 50 миллисекундам.
+</tag-desc>
+
+</list>
+</para>
+
 </directive>
 
 
@@ -423,6 +477,10 @@
 запроса на очистку заканчивается
 звёздочкой (“<literal>*</literal>”), то все записи в кэше, соответствующие
 этой маске, будут удалены из кэша.
+Тем не менее, эти записи будут оставаться на диске или до момента удаления
+из-за <link id="proxy_cache_path">отсутствия обращения к данным</link>,
+или до обработки их процессом “<link id="purger">cache purger</link>” (1.7.12),
+или до попытки клиента получить к ним доступ.
 </para>
 
 <para>
diff -r 201bf8fa69e5 -r 8973c7b37854 xml/ru/docs/http/ngx_http_scgi_module.xml
--- a/xml/ru/docs/http/ngx_http_scgi_module.xml	Tue Oct 06 13:07:58 2015 +0300
+++ b/xml/ru/docs/http/ngx_http_scgi_module.xml	Wed Sep 30 18:48:54 2015 +0300
@@ -319,7 +319,11 @@
     [<literal>max_size</literal>=<value>размер</value>]
     [<literal>loader_files</literal>=<value>число</value>]
     [<literal>loader_sleep</literal>=<value>время</value>]
-    [<literal>loader_threshold</literal>=<value>время</value>]</syntax>
+    [<literal>loader_threshold</literal>=<value>время</value>]
+    [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>]
+    [<literal>purger_files</literal>=<value>число</value>]
+    [<literal>purger_sleep</literal>=<value>время</value>]
+    [<literal>purger_threshold</literal>=<value>время</value>]</syntax>
 <default/>
 <context>http</context>
 
@@ -390,6 +394,56 @@
 <literal>loader_sleep</literal> (по умолчанию 50 миллисекунд).
 </para>
 
+<para>
+Кроме того,
+следующие параметры доступны как часть
+<commercial_version>коммерческой подписки</commercial_version>:
+</para>
+
+<para>
+<list type="tag">
+
+<tag-name id="purger">
+<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>
+</tag-name>
+<tag-desc>
+Указывает, будут ли записи в кэше, соответствующие
+<link id="scgi_cache_purge">маске</link>,
+удалены с диска при помощи процесса “cache purger” (1.7.12).
+Установка параметра в значение <value>on</value>
+(по умолчанию <value>off</value>)
+активирует процесс “cache purger”, который
+проходит по всем записям в кэше
+и удаляет записи, соответствующие этой маске.
+</tag-desc>
+
+<tag-name id="purger_files">
+<literal>purger_files</literal>=<value>число</value>
+</tag-name>
+<tag-desc>
+Задаёт число элементов, которые будут сканироваться за одну итерацию (1.7.12).
+По умолчанию <literal>purger_files</literal> равен 10.
+</tag-desc>
+
+<tag-name id="purger_threshold">
+<literal>purger_threshold</literal>=<value>время</value>
+</tag-name>
+<tag-desc>
+Задаёт продолжительность одной итерации (1.7.12).
+По умолчанию <literal>purger_threshold</literal> равен 50 миллисекундам.
+</tag-desc>
+
+<tag-name id="purger_sleep">
+<literal>purger_sleep</literal>=<value>время</value>
+</tag-name>
+<tag-desc>
+Задаёт паузу между итерациями (1.7.12).
+По умолчанию <literal>purger_sleep</literal> равен 50 миллисекундам.
+</tag-desc>
+
+</list>
+</para>
+
 </directive>
 
 
@@ -416,6 +470,10 @@
 запроса на очистку заканчивается
 звёздочкой (“<literal>*</literal>”), то все записи в кэше, соответствующие
 этой маске, будут удалены из кэша.
+Тем не менее, эти записи будут оставаться на диске или до момента удаления
+из-за <link id="scgi_cache_path">отсутствия обращения к данным</link>,
+или до обработки их процессом “<link id="purger">cache purger</link>” (1.7.12),
+или до попытки клиента получить к ним доступ.
 </para>
 
 <para>
diff -r 201bf8fa69e5 -r 8973c7b37854 xml/ru/docs/http/ngx_http_uwsgi_module.xml
--- a/xml/ru/docs/http/ngx_http_uwsgi_module.xml	Tue Oct 06 13:07:58 2015 +0300
+++ b/xml/ru/docs/http/ngx_http_uwsgi_module.xml	Wed Sep 30 18:48:54 2015 +0300
@@ -318,7 +318,11 @@
     [<literal>max_size</literal>=<value>размер</value>]
     [<literal>loader_files</literal>=<value>число</value>]
     [<literal>loader_sleep</literal>=<value>время</value>]
-    [<literal>loader_threshold</literal>=<value>время</value>]</syntax>
+    [<literal>loader_threshold</literal>=<value>время</value>]
+    [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>]
+    [<literal>purger_files</literal>=<value>число</value>]
+    [<literal>purger_sleep</literal>=<value>время</value>]
+    [<literal>purger_threshold</literal>=<value>время</value>]</syntax>
 <default/>
 <context>http</context>
 
@@ -389,6 +393,56 @@
 <literal>loader_sleep</literal> (по умолчанию 50 миллисекунд).
 </para>
 
+<para>
+Кроме того,
+следующие параметры доступны как часть
+<commercial_version>коммерческой подписки</commercial_version>:
+</para>
+
+<para>
+<list type="tag">
+
+<tag-name id="purger">
+<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>
+</tag-name>
+<tag-desc>
+Указывает, будут ли записи в кэше, соответствующие
+<link id="uwsgi_cache_purge">маске</link>,
+удалены с диска при помощи процесса “cache purger” (1.7.12).
+Установка параметра в значение <value>on</value>
+(по умолчанию <value>off</value>)
+активирует процесс “cache purger”, который
+проходит по всем записям в кэше
+и удаляет записи, соответствующие этой маске.
+</tag-desc>
+
+<tag-name id="purger_files">
+<literal>purger_files</literal>=<value>число</value>
+</tag-name>
+<tag-desc>
+Задаёт число элементов, которые будут сканироваться за одну итерацию (1.7.12).
+По умолчанию <literal>purger_files</literal> равен 10.
+</tag-desc>
+
+<tag-name id="purger_threshold">
+<literal>purger_threshold</literal>=<value>время</value>
+</tag-name>
+<tag-desc>
+Задаёт продолжительность одной итерации (1.7.12).
+По умолчанию <literal>purger_threshold</literal> равен 50 миллисекундам.
+</tag-desc>
+
+<tag-name id="purger_sleep">
+<literal>purger_sleep</literal>=<value>время</value>
+</tag-name>
+<tag-desc>
+Задаёт паузу между итерациями (1.7.12).
+По умолчанию <literal>purger_sleep</literal> равен 50 миллисекундам.
+</tag-desc>
+
+</list>
+</para>
+
 </directive>
 
 
@@ -415,6 +469,10 @@
 запроса на очистку заканчивается
 звёздочкой (“<literal>*</literal>”), то все записи в кэше, соответствующие
 этой маске, будут удалены из кэша.
+Тем не менее, эти записи будут оставаться на диске или до момента удаления
+из-за <link id="uwsgi_cache_path">отсутствия обращения к данным</link>,
+или до обработки их процессом “<link id="purger">cache purger</link>” (1.7.12),
+или до попытки клиента получить к ним доступ.
 </para>
 
 <para>