# HG changeset patch
# User Yaroslav Zhuravlev <yar@nginx.com>
# Date 1419438681 -10800
# Node ID 66ee778495633fff2f43532611b94f25452f493b
# Parent  0f63ac5c946308c0658d99360534aa23d757c6dd
Documented the use_temp_path parameter of the proxy_cache_path directive.

diff -r 0f63ac5c9463 -r 66ee77849563 xml/en/docs/http/ngx_http_fastcgi_module.xml
--- a/xml/en/docs/http/ngx_http_fastcgi_module.xml	Tue Dec 23 18:34:38 2014 +0300
+++ b/xml/en/docs/http/ngx_http_fastcgi_module.xml	Wed Dec 24 19:31:21 2014 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_fastcgi_module"
         link="/en/docs/http/ngx_http_fastcgi_module.html"
         lang="en"
-        rev="26">
+        rev="27">
 
 <section id="summary">
 
@@ -323,6 +323,7 @@
 <syntax>
     <value>path</value>
     [<literal>levels</literal>=<value>levels</value>]
+    [<literal>use_temp_path</literal>=<literal>on</literal>|<literal>off</literal>]
     <literal>keys_zone</literal>=<value>name</value>:<value>size</value>
     [<literal>inactive</literal>=<value>time</value>]
     [<literal>max_size</literal>=<value>size</value>]
@@ -357,8 +358,15 @@
 However, be aware that in this case a file is copied
 across two file systems instead of the cheap renaming operation.
 It is thus recommended that for any given location both cache and a directory
-holding temporary files, set by the <link id="fastcgi_temp_path"/> directive,
+holding temporary files
 are put on the same file system.
+A directory for temporary files is set based on
+the <literal>use_temp_path</literal> parameter (1.7.10).
+If this parameter is omitted or set to the value <literal>on</literal>,
+the directory set by the <link id="fastcgi_temp_path"/> directive
+for the given location will be used.
+If the value is set to <literal>off</literal>,
+temporary files will be put directly in the cache directory.
 </para>
 
 <para>
@@ -1350,6 +1358,11 @@
 </example>
 </para>
 
+<para>
+See also the <literal>use_temp_path</literal> parameter of the
+<link id="fastcgi_cache_path"/> directive.
+</para>
+
 </directive>
 
 </section>
diff -r 0f63ac5c9463 -r 66ee77849563 xml/en/docs/http/ngx_http_proxy_module.xml
--- a/xml/en/docs/http/ngx_http_proxy_module.xml	Tue Dec 23 18:34:38 2014 +0300
+++ b/xml/en/docs/http/ngx_http_proxy_module.xml	Wed Dec 24 19:31:21 2014 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_proxy_module"
         link="/en/docs/http/ngx_http_proxy_module.html"
         lang="en"
-        rev="34">
+        rev="35">
 
 <section id="summary">
 
@@ -321,6 +321,7 @@
 <syntax>
     <value>path</value>
     [<literal>levels</literal>=<value>levels</value>]
+    [<literal>use_temp_path</literal>=<literal>on</literal>|<literal>off</literal>]
     <literal>keys_zone</literal>=<value>name</value>:<value>size</value>
     [<literal>inactive</literal>=<value>time</value>]
     [<literal>max_size</literal>=<value>size</value>]
@@ -355,8 +356,15 @@
 However, be aware that in this case a file is copied
 across two file systems instead of the cheap renaming operation.
 It is thus recommended that for any given location both cache and a directory
-holding temporary files, set by the <link id="proxy_temp_path"/> directive,
+holding temporary files
 are put on the same file system.
+A directory for temporary files is set based on
+the <literal>use_temp_path</literal> parameter (1.7.10).
+If this parameter is omitted or set to the value <literal>on</literal>,
+the directory set by the <link id="proxy_temp_path"/> directive
+for the given location will be used.
+If the value is set to <literal>off</literal>,
+temporary files will be put directly in the cache directory.
 </para>
 
 <para>
@@ -1941,6 +1949,11 @@
 </example>
 </para>
 
+<para>
+See also the <literal>use_temp_path</literal> parameter of the
+<link id="proxy_cache_path"/> directive.
+</para>
+
 </directive>
 
 </section>
diff -r 0f63ac5c9463 -r 66ee77849563 xml/en/docs/http/ngx_http_scgi_module.xml
--- a/xml/en/docs/http/ngx_http_scgi_module.xml	Tue Dec 23 18:34:38 2014 +0300
+++ b/xml/en/docs/http/ngx_http_scgi_module.xml	Wed Dec 24 19:31:21 2014 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_scgi_module"
         link="/en/docs/http/ngx_http_scgi_module.html"
         lang="en"
-        rev="14">
+        rev="15">
 
 <section id="summary">
 
@@ -314,6 +314,7 @@
 <syntax>
     <value>path</value>
     [<literal>levels</literal>=<value>levels</value>]
+    [<literal>use_temp_path</literal>=<literal>on</literal>|<literal>off</literal>]
     <literal>keys_zone</literal>=<value>name</value>:<value>size</value>
     [<literal>inactive</literal>=<value>time</value>]
     [<literal>max_size</literal>=<value>size</value>]
@@ -348,8 +349,15 @@
 However, be aware that in this case a file is copied
 across two file systems instead of the cheap renaming operation.
 It is thus recommended that for any given location both cache and a directory
-holding temporary files, set by the <link id="scgi_temp_path"/> directive,
+holding temporary files
 are put on the same file system.
+A directory for temporary files is set based on
+the <literal>use_temp_path</literal> parameter (1.7.10).
+If this parameter is omitted or set to the value <literal>on</literal>,
+the directory set by the <link id="scgi_temp_path"/> directive
+for the given location will be used.
+If the value is set to <literal>off</literal>,
+temporary files will be put directly in the cache directory.
 </para>
 
 <para>
@@ -1198,6 +1206,11 @@
 </example>
 </para>
 
+<para>
+See also the <literal>use_temp_path</literal> parameter of the
+<link id="scgi_cache_path"/> directive.
+</para>
+
 </directive>
 
 </section>
diff -r 0f63ac5c9463 -r 66ee77849563 xml/en/docs/http/ngx_http_uwsgi_module.xml
--- a/xml/en/docs/http/ngx_http_uwsgi_module.xml	Tue Dec 23 18:34:38 2014 +0300
+++ b/xml/en/docs/http/ngx_http_uwsgi_module.xml	Wed Dec 24 19:31:21 2014 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_uwsgi_module"
         link="/en/docs/http/ngx_http_uwsgi_module.html"
         lang="en"
-        rev="16">
+        rev="17">
 
 <section id="summary">
 
@@ -314,6 +314,7 @@
 <syntax>
     <value>path</value>
     [<literal>levels</literal>=<value>levels</value>]
+    [<literal>use_temp_path</literal>=<literal>on</literal>|<literal>off</literal>]
     <literal>keys_zone</literal>=<value>name</value>:<value>size</value>
     [<literal>inactive</literal>=<value>time</value>]
     [<literal>max_size</literal>=<value>size</value>]
@@ -348,8 +349,15 @@
 However, be aware that in this case a file is copied
 across two file systems instead of the cheap renaming operation.
 It is thus recommended that for any given location both cache and a directory
-holding temporary files, set by the <link id="uwsgi_temp_path"/> directive,
+holding temporary files
 are put on the same file system.
+A directory for temporary files is set based on
+the <literal>use_temp_path</literal> parameter (1.7.10).
+If this parameter is omitted or set to the value <literal>on</literal>,
+the directory set by the <link id="uwsgi_temp_path"/> directive
+for the given location will be used.
+If the value is set to <literal>off</literal>,
+temporary files will be put directly in the cache directory.
 </para>
 
 <para>
@@ -1455,6 +1463,11 @@
 </example>
 </para>
 
+<para>
+See also the <literal>use_temp_path</literal> parameter of the
+<link id="uwsgi_cache_path"/> directive.
+</para>
+
 </directive>
 
 </section>
diff -r 0f63ac5c9463 -r 66ee77849563 xml/ru/docs/http/ngx_http_fastcgi_module.xml
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Tue Dec 23 18:34:38 2014 +0300
+++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Wed Dec 24 19:31:21 2014 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_fastcgi_module"
         link="/ru/docs/http/ngx_http_fastcgi_module.html"
         lang="ru"
-        rev="26">
+        rev="27">
 
 <section id="summary">
 
@@ -321,6 +321,7 @@
 <syntax>
     <value>путь</value>
     [<literal>levels</literal>=<value>уровни</value>]
+    [<literal>use_temp_path</literal>=<literal>on</literal>|<literal>off</literal>]
     <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
     [<literal>inactive</literal>=<value>время</value>]
     [<literal>max_size</literal>=<value>размер</value>]
@@ -355,8 +356,14 @@
 что в этом случае вместо дешёвой операции переименовывания в пределах
 одной файловой системы файл копируется с одной файловой системы на другую.
 Поэтому лучше, если кэш будет находиться на той же файловой
-системе, что и каталог с временными файлами, задаваемый директивой
+системе, что и каталог с временными файлами.
+Какой из каталогов будет использоваться для временных файлов
+определяется параметром <literal>use_temp_path</literal> (1.7.10).
+Если параметр не задан или установлен в значение “<literal>on</literal>”,
+то будет использоваться каталог, задаваемый директивой
 <link id="fastcgi_temp_path"/> для данного location.
+Если параметр установлен в значение “<literal>off</literal>”,
+то временные файлы будут располагаться непосредственно в каталоге кэша.
 </para>
 
 <para>
@@ -1343,6 +1350,11 @@
 </example>
 </para>
 
+<para>
+См. также параметр <literal>use_temp_path</literal> директивы
+<link id="fastcgi_cache_path"/>.
+</para>
+
 </directive>
 
 </section>
diff -r 0f63ac5c9463 -r 66ee77849563 xml/ru/docs/http/ngx_http_proxy_module.xml
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml	Tue Dec 23 18:34:38 2014 +0300
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml	Wed Dec 24 19:31:21 2014 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_proxy_module"
         link="/ru/docs/http/ngx_http_proxy_module.html"
         lang="ru"
-        rev="34">
+        rev="35">
 
 <section id="summary">
 
@@ -319,6 +319,7 @@
 <syntax>
     <value>путь</value>
     [<literal>levels</literal>=<value>уровни</value>]
+    [<literal>use_temp_path</literal>=<literal>on</literal>|<literal>off</literal>]
     <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
     [<literal>inactive</literal>=<value>время</value>]
     [<literal>max_size</literal>=<value>размер</value>]
@@ -353,8 +354,14 @@
 что в этом случае вместо дешёвой операции переименовывания в пределах
 одной файловой системы файл копируется с одной файловой системы на другую.
 Поэтому лучше, если кэш будет находиться на той же файловой
-системе, что и каталог с временными файлами, задаваемый директивой
+системе, что и каталог с временными файлами.
+Какой из каталогов будет использоваться для временных файлов
+определяется параметром <literal>use_temp_path</literal> (1.7.10).
+Если параметр не задан или установлен в значение “<literal>on</literal>”,
+то будет использоваться каталог, задаваемый директивой
 <link id="proxy_temp_path"/> для данного location.
+Если параметр установлен в значение “<literal>off</literal>”,
+то временные файлы будут располагаться непосредственно в каталоге кэша.
 </para>
 
 <para>
@@ -1940,6 +1947,11 @@
 </example>
 </para>
 
+<para>
+См. также параметр <literal>use_temp_path</literal> директивы
+<link id="proxy_cache_path"/>.
+</para>
+
 </directive>
 
 </section>
diff -r 0f63ac5c9463 -r 66ee77849563 xml/ru/docs/http/ngx_http_scgi_module.xml
--- a/xml/ru/docs/http/ngx_http_scgi_module.xml	Tue Dec 23 18:34:38 2014 +0300
+++ b/xml/ru/docs/http/ngx_http_scgi_module.xml	Wed Dec 24 19:31:21 2014 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_scgi_module"
         link="/ru/docs/http/ngx_http_scgi_module.html"
         lang="ru"
-        rev="14">
+        rev="15">
 
 <section id="summary">
 
@@ -312,6 +312,7 @@
 <syntax>
     <value>путь</value>
     [<literal>levels</literal>=<value>уровни</value>]
+    [<literal>use_temp_path</literal>=<literal>on</literal>|<literal>off</literal>]
     <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
     [<literal>inactive</literal>=<value>время</value>]
     [<literal>max_size</literal>=<value>размер</value>]
@@ -346,8 +347,14 @@
 что в этом случае вместо дешёвой операции переименовывания в пределах
 одной файловой системы файл копируется с одной файловой системы на другую.
 Поэтому лучше, если кэш будет находиться на той же файловой
-системе, что и каталог с временными файлами, задаваемый директивой
+системе, что и каталог с временными файлами.
+Какой из каталогов будет использоваться для временных файлов
+определяется параметром <literal>use_temp_path</literal> (1.7.10).
+Если параметр не задан или установлен в значение “<literal>on</literal>”,
+то будет использоваться каталог, задаваемый директивой
 <link id="scgi_temp_path"/> для данного location.
+Если параметр установлен в значение “<literal>off</literal>”,
+то временные файлы будут располагаться непосредственно в каталоге кэша.
 </para>
 
 <para>
@@ -1192,6 +1199,11 @@
 </example>
 </para>
 
+<para>
+См. также параметр <literal>use_temp_path</literal> директивы
+<link id="scgi_cache_path"/>.
+</para>
+
 </directive>
 
 </section>
diff -r 0f63ac5c9463 -r 66ee77849563 xml/ru/docs/http/ngx_http_uwsgi_module.xml
--- a/xml/ru/docs/http/ngx_http_uwsgi_module.xml	Tue Dec 23 18:34:38 2014 +0300
+++ b/xml/ru/docs/http/ngx_http_uwsgi_module.xml	Wed Dec 24 19:31:21 2014 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_uwsgi_module"
         link="/ru/docs/http/ngx_http_uwsgi_module.html"
         lang="ru"
-        rev="16">
+        rev="17">
 
 <section id="summary">
 
@@ -312,6 +312,7 @@
 <syntax>
     <value>путь</value>
     [<literal>levels</literal>=<value>уровни</value>]
+    [<literal>use_temp_path</literal>=<literal>on</literal>|<literal>off</literal>]
     <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
     [<literal>inactive</literal>=<value>время</value>]
     [<literal>max_size</literal>=<value>размер</value>]
@@ -346,8 +347,14 @@
 что в этом случае вместо дешёвой операции переименовывания в пределах
 одной файловой системы файл копируется с одной файловой системы на другую.
 Поэтому лучше, если кэш будет находиться на той же файловой
-системе, что и каталог с временными файлами, задаваемый директивой
+системе, что и каталог с временными файлами.
+Какой из каталогов будет использоваться для временных файлов
+определяется параметром <literal>use_temp_path</literal> (1.7.10).
+Если параметр не задан или установлен в значение “<literal>on</literal>”,
+то будет использоваться каталог, задаваемый директивой
 <link id="uwsgi_temp_path"/> для данного location.
+Если параметр установлен в значение “<literal>off</literal>”,
+то временные файлы будут располагаться непосредственно в каталоге кэша.
 </para>
 
 <para>
@@ -1449,6 +1456,11 @@
 </example>
 </para>
 
+<para>
+См. также параметр <literal>use_temp_path</literal> директивы
+<link id="uwsgi_cache_path"/>.
+</para>
+
 </directive>
 
 </section>