# HG changeset patch
# User Yaroslav Zhuravlev <yar@nginx.com>
# Date 1418902844 -10800
# Node ID 6e54b85dfb86160d71d6fb8b6a44ddd87b86504c
# Parent  ab0ebdd7ddac5fa31631ffcdd23b6c5bbd68a161
Documented the "proxy_cache_lock_age" directive.

diff --git a/xml/en/docs/http/ngx_http_proxy_module.xml b/xml/en/docs/http/ngx_http_proxy_module.xml
--- 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="32">
+        rev="33">
 
 <section id="summary">
 
@@ -239,6 +239,24 @@ this element to be released, up to the t
 </directive>
 
 
+<directive name="proxy_cache_lock_age">
+<syntax><value>time</value></syntax>
+<default>5s</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.7.8</appeared-in>
+
+<para>
+If the last request passed to the proxied server
+for populating a new cache element
+has not completed for the specified <value>time</value>,
+one more request may be passed to the proxied server.
+</para>
+
+</directive>
+
+
 <directive name="proxy_cache_lock_timeout">
 <syntax><value>time</value></syntax>
 <default>5s</default>
@@ -249,6 +267,12 @@ this element to be released, up to the t
 
 <para>
 Sets a timeout for <link id="proxy_cache_lock"/>.
+When the <value>time</value> expires,
+the request will be passed to the proxied server,
+however, the response will not be cached.
+<note>
+Before 1.7.8, the response could be cached.
+</note>
 </para>
 
 </directive>
diff --git a/xml/ru/docs/http/ngx_http_proxy_module.xml b/xml/ru/docs/http/ngx_http_proxy_module.xml
--- 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="32">
+        rev="33">
 
 <section id="summary">
 
@@ -238,6 +238,24 @@ proxy_cache_key $scheme$proxy_host$uri$i
 </directive>
 
 
+<directive name="proxy_cache_lock_age">
+<syntax><value>время</value></syntax>
+<default>5s</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.7.8</appeared-in>
+
+<para>
+Если последний запрос, переданный на проксируемый сервер
+для заполнения нового элемента кэша,
+не завершился за указанное <value>время</value>,
+на проксируемый сервер может быть передан ещё один запрос.
+</para>
+
+</directive>
+
+
 <directive name="proxy_cache_lock_timeout">
 <syntax><value>время</value></syntax>
 <default>5s</default>
@@ -248,6 +266,12 @@ proxy_cache_key $scheme$proxy_host$uri$i
 
 <para>
 Задаёт таймаут для <link id="proxy_cache_lock"/>.
+По истечении указанного <value>времени</value>
+запрос будет передан на проксируемый сервер,
+однако ответ не будет закэширован.
+<note>
+До версии 1.7.8 такой ответ мог быть закэширован.
+</note>
 </para>
 
 </directive>