# HG changeset patch
# User Vladimir Homutov <vl@nginx.com>
# Date 1350372986 0
# Node ID f62328124e5bfbb51703a70ba5d4a901f3795f9b
# Parent  76e876c58dc0c2efde817220e96d4764aee698cb
Documented $upstream_cache_status and $upstream_response_length variables.

diff -r 76e876c58dc0 -r f62328124e5b xml/en/docs/http/ngx_http_upstream_module.xml
--- a/xml/en/docs/http/ngx_http_upstream_module.xml	Mon Oct 15 09:20:33 2012 +0000
+++ b/xml/en/docs/http/ngx_http_upstream_module.xml	Tue Oct 16 07:36:26 2012 +0000
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_upstream_module"
         link="/en/docs/http/ngx_http_upstream_module.html"
         lang="en"
-        rev="1">
+        rev="2">
 
 <section id="summary">
 
@@ -391,16 +391,36 @@
 “<literal>192.168.1.1:80, 192.168.1.2:80, unix:/tmp/sock : 192.168.10.1:80, 192.168.10.2:80</literal>”.
 </tag-desc>
 
+<tag-name><var>$upstream_cache_status</var></tag-name>
+<tag-desc>
+keeps status of accessing a response cache (0.8.3).
+The status can be one of “<literal>MISS</literal>”, 
+“<literal>BYPASS</literal>”, “<literal>EXPIRED</literal>”,
+“<literal>STALE</literal>”, “<literal>UPDATING</literal>” or
+“<literal>HIT</literal>”.
+</tag-desc>
+
+<tag-name><var>$upstream_response_length</var></tag-name>
+<tag-desc>
+keeps lengths of responses obtained from upstream servers (0.7.27);
+lengths are kept in bytes.
+Several responses are separated by commas and colons
+like in the <var>$upstream_addr</var> variable.
+</tag-desc>
+
 <tag-name><var>$upstream_response_time</var></tag-name>
 <tag-desc>
-keeps servers response times in seconds with a milliseconds resolution.
-Several responses are also separated by commas and colons.
+keeps times of responses obtained from upstream servers;
+times are kept in seconds with a milliseconds resolution.
+Several responses are separated by commas and colons
+like in the <var>$upstream_addr</var> variable.
 </tag-desc>
 
 <tag-name><var>$upstream_status</var></tag-name>
 <tag-desc>
-keeps servers response codes.
-Several responses are also separated by commas and colons.
+keeps codes of responses obtained from upstream servers.
+Several responses are separated by commas and colons
+like in the <var>$upstream_addr</var> variable.
 </tag-desc>
 
 <tag-name><var>$upstream_http_...</var></tag-name>
@@ -408,7 +428,10 @@
 keep server response header fields.
 For example, the <header>Server</header> response header field
 is made available through the <var>$upstream_http_server</var> variable.
-Note that only the last server’s response header fields are saved.
+The rules of converting header field names to variable names are the same
+as for variables starting with the
+“<link doc="ngx_http_core_module.xml" id="variables">$http_</link>” prefix.
+Only the last server’s response header fields are saved.
 </tag-desc>
 
 </list>
diff -r 76e876c58dc0 -r f62328124e5b xml/ru/docs/http/ngx_http_upstream_module.xml
--- a/xml/ru/docs/http/ngx_http_upstream_module.xml	Mon Oct 15 09:20:33 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_upstream_module.xml	Tue Oct 16 07:36:26 2012 +0000
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_upstream_module"
         link="/ru/docs/http/ngx_http_upstream_module.html"
         lang="ru"
-        rev="1">
+        rev="2">
 
 <section id="summary">
 
@@ -392,16 +392,36 @@
 “<literal>192.168.1.1:80, 192.168.1.2:80, unix:/tmp/sock : 192.168.10.1:80, 192.168.10.2:80</literal>”.
 </tag-desc>
 
+<tag-name><var>$upstream_cache_status</var></tag-name>
+<tag-desc>
+хранит статус доступа к кэшу ответов (0.8.3).
+Статус может быть одним из “<literal>MISS</literal>”, 
+“<literal>BYPASS</literal>”, “<literal>EXPIRED</literal>”,
+“<literal>STALE</literal>”, “<literal>UPDATING</literal>” или
+“<literal>HIT</literal>”.
+</tag-desc>
+
+<tag-name><var>$upstream_response_length</var></tag-name>
+<tag-desc>
+хранит длины ответов, полученных от серверов группы (0.7.27);
+длины хранятся в байтах.
+Несколько ответов разделяются запятыми и двоеточиями,
+подобно переменной <var>$upstream_addr</var>.
+</tag-desc>
+
 <tag-name><var>$upstream_response_time</var></tag-name>
 <tag-desc>
-хранит времена ответов серверов в секундах с точностью до миллисекунд.
-Несколько ответов также разделяются запятыми и двоеточиями.
+хранит времена ответов, полученных от серверов группы;
+времена хранятся в секундах с точностью до миллисекунд.
+Несколько ответов разделяются запятыми и двоеточиями,
+подобно переменной <var>$upstream_addr</var>.
 </tag-desc>
 
 <tag-name><var>$upstream_status</var></tag-name>
 <tag-desc>
-хранит коды ответов серверов.
-Несколько ответов также разделяются запятыми и двоеточиями.
+хранит коды ответов, полученных от серверов группы.
+Несколько ответов разделяются запятыми и двоеточиями,
+подобно переменной <var>$upstream_addr</var>.
 </tag-desc>
 
 <tag-name><var>$upstream_http_...</var></tag-name>
@@ -409,6 +429,9 @@
 хранят поля заголовка ответа сервера.
 Например, поле заголовка ответа <header>Server</header>
 доступно в переменной <var>$upstream_http_server</var>.
+Правила преобразования имён полей заголовка ответа в имена переменных
+такие же, как для переменных с префиксом
+“<link doc="ngx_http_core_module.xml" id="variables">$http_</link>”.
 Необходимо иметь в виду, что запоминаются только поля заголовка ответа
 последнего сервера.
 </tag-desc>