# HG changeset patch
# User Maxim Dounin <mdounin@mdounin.ru>
# Date 1722439991 -10800
# Node ID ca4c8ac67c0ebb9d3c09f295b667d452ac709ede
# Parent  6cab598f14a1f4bbf2e8e4f374f6d15c18c54659
Documented Age header handling.

diff -r 6cab598f14a1 -r ca4c8ac67c0e xml/en/docs/http/ngx_http_fastcgi_module.xml
--- a/xml/en/docs/http/ngx_http_fastcgi_module.xml	Tue Jul 09 17:51:47 2024 +0300
+++ b/xml/en/docs/http/ngx_http_fastcgi_module.xml	Wed Jul 31 18:33:11 2024 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_fastcgi_module"
         link="/en/docs/http/ngx_http_fastcgi_module.html"
         lang="en"
-        rev="54">
+        rev="55">
 
 <section id="summary">
 
@@ -649,6 +649,12 @@
 taking into account the corresponding request header fields (1.7.7).
 </listitem>
 
+<listitem>
+If the header includes the <header>Age</header> field
+and caching time is set with the <header>Cache-Control</header> field,
+caching time is reduced accordingly (1.27.3).
+</listitem>
+
 </list>
 Processing of one or more of these response header fields can be disabled
 using the <link id="fastcgi_ignore_headers"/> directive.
@@ -766,7 +772,7 @@
 <header>X-Accel-Buffering</header> (1.1.6),
 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>,
 <header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44),
-and <header>Vary</header> (1.7.7).
+<header>Vary</header> (1.7.7), and <header>Age</header> (1.27.3).
 </para>
 
 <para>
@@ -777,7 +783,7 @@
 <listitem>
 <header>X-Accel-Expires</header>, <header>Expires</header>,
 <header>Cache-Control</header>, <header>Set-Cookie</header>,
-and <header>Vary</header>
+<header>Vary</header>, and <header>Age</header>
 set the parameters of response <link id="fastcgi_cache_valid">caching</link>;
 </listitem>
 
diff -r 6cab598f14a1 -r ca4c8ac67c0e xml/en/docs/http/ngx_http_proxy_module.xml
--- a/xml/en/docs/http/ngx_http_proxy_module.xml	Tue Jul 09 17:51:47 2024 +0300
+++ b/xml/en/docs/http/ngx_http_proxy_module.xml	Wed Jul 31 18:33:11 2024 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_proxy_module"
         link="/en/docs/http/ngx_http_proxy_module.html"
         lang="en"
-        rev="77">
+        rev="78">
 
 <section id="summary">
 
@@ -667,6 +667,12 @@
 taking into account the corresponding request header fields (1.7.7).
 </listitem>
 
+<listitem>
+If the header includes the <header>Age</header> field
+and caching time is set with the <header>Cache-Control</header> field,
+caching time is reduced accordingly (1.27.3).
+</listitem>
+
 </list>
 Processing of one or more of these response header fields can be disabled
 using the <link id="proxy_ignore_headers"/> directive.
@@ -1011,7 +1017,7 @@
 <header>X-Accel-Buffering</header> (1.1.6),
 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>,
 <header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44),
-and <header>Vary</header> (1.7.7).
+<header>Vary</header> (1.7.7), and <header>Age</header> (1.27.3).
 </para>
 
 <para>
@@ -1022,7 +1028,7 @@
 <listitem>
 <header>X-Accel-Expires</header>, <header>Expires</header>,
 <header>Cache-Control</header>, <header>Set-Cookie</header>,
-and <header>Vary</header>
+<header>Vary</header>, and <header>Age</header>
 set the parameters of response <link id="proxy_cache_valid">caching</link>;
 </listitem>
 
diff -r 6cab598f14a1 -r ca4c8ac67c0e xml/en/docs/http/ngx_http_scgi_module.xml
--- a/xml/en/docs/http/ngx_http_scgi_module.xml	Tue Jul 09 17:51:47 2024 +0300
+++ b/xml/en/docs/http/ngx_http_scgi_module.xml	Wed Jul 31 18:33:11 2024 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_scgi_module"
         link="/en/docs/http/ngx_http_scgi_module.html"
         lang="en"
-        rev="42">
+        rev="43">
 
 <section id="summary">
 
@@ -640,6 +640,12 @@
 taking into account the corresponding request header fields (1.7.7).
 </listitem>
 
+<listitem>
+If the header includes the <header>Age</header> field
+and caching time is set with the <header>Cache-Control</header> field,
+caching time is reduced accordingly (1.27.3).
+</listitem>
+
 </list>
 Processing of one or more of these response header fields can be disabled
 using the <link id="scgi_ignore_headers"/> directive.
@@ -731,7 +737,7 @@
 <header>X-Accel-Buffering</header> (1.1.6),
 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>,
 <header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44),
-and <header>Vary</header> (1.7.7).
+<header>Vary</header> (1.7.7), and <header>Age</header> (1.27.3).
 </para>
 
 <para>
@@ -742,7 +748,7 @@
 <listitem>
 <header>X-Accel-Expires</header>, <header>Expires</header>,
 <header>Cache-Control</header>, <header>Set-Cookie</header>,
-and <header>Vary</header>
+<header>Vary</header>, and <header>Age</header>
 set the parameters of response <link id="scgi_cache_valid">caching</link>;
 </listitem>
 
diff -r 6cab598f14a1 -r ca4c8ac67c0e xml/en/docs/http/ngx_http_upstream_module.xml
--- a/xml/en/docs/http/ngx_http_upstream_module.xml	Tue Jul 09 17:51:47 2024 +0300
+++ b/xml/en/docs/http/ngx_http_upstream_module.xml	Wed Jul 31 18:33:11 2024 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_upstream_module"
         link="/en/docs/http/ngx_http_upstream_module.html"
         lang="en"
-        rev="90">
+        rev="91">
 
 <section id="summary">
 
@@ -574,6 +574,12 @@
 <link id="var_upstream_addr">$upstream_addr</link> variable.
 </tag-desc>
 
+<tag-name id="var_upstream_cache_age"><var>$upstream_cache_age</var>
+</tag-name>
+<tag-desc>
+age of the cache item (1.27.3).
+</tag-desc>
+
 <tag-name id="var_upstream_cache_key"><var>$upstream_cache_key</var>
 </tag-name>
 <tag-desc>
diff -r 6cab598f14a1 -r ca4c8ac67c0e xml/en/docs/http/ngx_http_uwsgi_module.xml
--- a/xml/en/docs/http/ngx_http_uwsgi_module.xml	Tue Jul 09 17:51:47 2024 +0300
+++ b/xml/en/docs/http/ngx_http_uwsgi_module.xml	Wed Jul 31 18:33:11 2024 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_uwsgi_module"
         link="/en/docs/http/ngx_http_uwsgi_module.html"
         lang="en"
-        rev="51">
+        rev="52">
 
 <section id="summary">
 
@@ -640,6 +640,12 @@
 taking into account the corresponding request header fields (1.7.7).
 </listitem>
 
+<listitem>
+If the header includes the <header>Age</header> field
+and caching time is set with the <header>Cache-Control</header> field,
+caching time is reduced accordingly (1.27.3).
+</listitem>
+
 </list>
 Processing of one or more of these response header fields can be disabled
 using the <link id="uwsgi_ignore_headers"/> directive.
@@ -731,7 +737,7 @@
 <header>X-Accel-Buffering</header> (1.1.6),
 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>,
 <header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44),
-and <header>Vary</header> (1.7.7).
+<header>Vary</header> (1.7.7), and <header>Age</header> (1.27.3).
 </para>
 
 <para>
@@ -742,7 +748,7 @@
 <listitem>
 <header>X-Accel-Expires</header>, <header>Expires</header>,
 <header>Cache-Control</header>, <header>Set-Cookie</header>,
-and <header>Vary</header>
+<header>Vary</header>, and <header>Age</header>
 set the parameters of response <link id="uwsgi_cache_valid">caching</link>;
 </listitem>
 
diff -r 6cab598f14a1 -r ca4c8ac67c0e xml/ru/docs/http/ngx_http_fastcgi_module.xml
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Tue Jul 09 17:51:47 2024 +0300
+++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Wed Jul 31 18:33:11 2024 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_fastcgi_module"
         link="/ru/docs/http/ngx_http_fastcgi_module.html"
         lang="ru"
-        rev="54">
+        rev="55">
 
 <section id="summary">
 
@@ -649,6 +649,12 @@
 с учётом соответствующих полей заголовка запроса (1.7.7).
 </listitem>
 
+<listitem>
+Если в заголовке ответа есть поле <header>Age</header>
+и время кэширования определяется по полю <header>Cache-Control</header>,
+время кэширования будет соответственно уменьшено (1.27.3).
+</listitem>
+
 </list>
 Обработка одного или более из этих полей заголовка может быть отключена
 при помощи директивы <link id="fastcgi_ignore_headers"/>.
@@ -764,8 +770,8 @@
 <header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6),
 <header>X-Accel-Buffering</header> (1.1.6),
 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>,
-<header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44)
-и <header>Vary</header> (1.7.7).
+<header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44),
+<header>Vary</header> (1.7.7) и <header>Age</header> (1.27.3).
 </para>
 
 <para>
@@ -774,8 +780,8 @@
 
 <listitem>
 <header>X-Accel-Expires</header>, <header>Expires</header>,
-<header>Cache-Control</header>, <header>Set-Cookie</header>
-и <header>Vary</header>
+<header>Cache-Control</header>, <header>Set-Cookie</header>,
+<header>Vary</header> и <header>Age</header>
 задают параметры <link id="fastcgi_cache_valid">кэширования</link> ответа;
 </listitem>
 
diff -r 6cab598f14a1 -r ca4c8ac67c0e xml/ru/docs/http/ngx_http_proxy_module.xml
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml	Tue Jul 09 17:51:47 2024 +0300
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml	Wed Jul 31 18:33:11 2024 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_proxy_module"
         link="/ru/docs/http/ngx_http_proxy_module.html"
         lang="ru"
-        rev="77">
+        rev="78">
 
 <section id="summary">
 
@@ -669,6 +669,12 @@
 с учётом соответствующих полей заголовка запроса (1.7.7).
 </listitem>
 
+<listitem>
+Если в заголовке ответа есть поле <header>Age</header>
+и время кэширования определяется по полю <header>Cache-Control</header>,
+время кэширования будет соответственно уменьшено (1.27.3).
+</listitem>
+
 </list>
 Обработка одного или более из этих полей заголовка может быть отключена
 при помощи директивы <link id="proxy_ignore_headers"/>.
@@ -1010,8 +1016,8 @@
 <header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6),
 <header>X-Accel-Buffering</header> (1.1.6),
 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>,
-<header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44)
-и <header>Vary</header> (1.7.7).
+<header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44),
+<header>Vary</header> (1.7.7) и <header>Age</header> (1.27.3).
 </para>
 
 <para>
@@ -1020,8 +1026,8 @@
 
 <listitem>
 <header>X-Accel-Expires</header>, <header>Expires</header>,
-<header>Cache-Control</header>, <header>Set-Cookie</header>
-и <header>Vary</header>
+<header>Cache-Control</header>, <header>Set-Cookie</header>,
+<header>Vary</header> и <header>Age</header>
 задают параметры <link id="proxy_cache_valid">кэширования</link> ответа;
 </listitem>
 
diff -r 6cab598f14a1 -r ca4c8ac67c0e xml/ru/docs/http/ngx_http_scgi_module.xml
--- a/xml/ru/docs/http/ngx_http_scgi_module.xml	Tue Jul 09 17:51:47 2024 +0300
+++ b/xml/ru/docs/http/ngx_http_scgi_module.xml	Wed Jul 31 18:33:11 2024 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_scgi_module"
         link="/ru/docs/http/ngx_http_scgi_module.html"
         lang="ru"
-        rev="42">
+        rev="43">
 
 <section id="summary">
 
@@ -640,6 +640,12 @@
 с учётом соответствующих полей заголовка запроса (1.7.7).
 </listitem>
 
+<listitem>
+Если в заголовке ответа есть поле <header>Age</header>
+и время кэширования определяется по полю <header>Cache-Control</header>,
+время кэширования будет соответственно уменьшено (1.27.3).
+</listitem>
+
 </list>
 Обработка одного или более из этих полей заголовка может быть отключена
 при помощи директивы <link id="scgi_ignore_headers"/>.
@@ -729,8 +735,8 @@
 <header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6),
 <header>X-Accel-Buffering</header> (1.1.6),
 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>,
-<header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44)
-и <header>Vary</header> (1.7.7).
+<header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44),
+<header>Vary</header> (1.7.7) и <header>Age</header> (1.27.3).
 </para>
 
 <para>
@@ -739,8 +745,8 @@
 
 <listitem>
 <header>X-Accel-Expires</header>, <header>Expires</header>,
-<header>Cache-Control</header>, <header>Set-Cookie</header>
-и <header>Vary</header>
+<header>Cache-Control</header>, <header>Set-Cookie</header>,
+<header>Vary</header> и <header>Age</header>
 задают параметры <link id="scgi_cache_valid">кэширования</link> ответа;
 </listitem>
 
diff -r 6cab598f14a1 -r ca4c8ac67c0e xml/ru/docs/http/ngx_http_upstream_module.xml
--- a/xml/ru/docs/http/ngx_http_upstream_module.xml	Tue Jul 09 17:51:47 2024 +0300
+++ b/xml/ru/docs/http/ngx_http_upstream_module.xml	Wed Jul 31 18:33:11 2024 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_upstream_module"
         link="/ru/docs/http/ngx_http_upstream_module.html"
         lang="ru"
-        rev="90">
+        rev="91">
 
 <section id="summary">
 
@@ -581,6 +581,12 @@
 <link id="var_upstream_addr">$upstream_addr</link>.
 </tag-desc>
 
+<tag-name id="var_upstream_cache_age"><var>$upstream_cache_age</var>
+</tag-name>
+<tag-desc>
+возраст элемента кэша (1.27.3).
+</tag-desc>
+
 <tag-name id="var_upstream_cache_key"><var>$upstream_cache_key</var>
 </tag-name>
 <tag-desc>
diff -r 6cab598f14a1 -r ca4c8ac67c0e xml/ru/docs/http/ngx_http_uwsgi_module.xml
--- a/xml/ru/docs/http/ngx_http_uwsgi_module.xml	Tue Jul 09 17:51:47 2024 +0300
+++ b/xml/ru/docs/http/ngx_http_uwsgi_module.xml	Wed Jul 31 18:33:11 2024 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_uwsgi_module"
         link="/ru/docs/http/ngx_http_uwsgi_module.html"
         lang="ru"
-        rev="51">
+        rev="52">
 
 <section id="summary">
 
@@ -639,6 +639,12 @@
 с учётом соответствующих полей заголовка запроса (1.7.7).
 </listitem>
 
+<listitem>
+Если в заголовке ответа есть поле <header>Age</header>
+и время кэширования определяется по полю <header>Cache-Control</header>,
+время кэширования будет соответственно уменьшено (1.27.3).
+</listitem>
+
 </list>
 Обработка одного или более из этих полей заголовка может быть отключена
 при помощи директивы <link id="uwsgi_ignore_headers"/>.
@@ -728,8 +734,8 @@
 <header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6),
 <header>X-Accel-Buffering</header> (1.1.6),
 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>,
-<header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44)
-и <header>Vary</header> (1.7.7).
+<header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44),
+<header>Vary</header> (1.7.7) и <header>Age</header> (1.27.3).
 </para>
 
 <para>
@@ -738,8 +744,8 @@
 
 <listitem>
 <header>X-Accel-Expires</header>, <header>Expires</header>,
-<header>Cache-Control</header>, <header>Set-Cookie</header>
-и <header>Vary</header>
+<header>Cache-Control</header>, <header>Set-Cookie</header>,
+<header>Vary</header> и <header>Age</header>
 задают параметры <link id="uwsgi_cache_valid">кэширования</link> ответа;
 </listitem>