Documented the "nocache" parameter of the "js_set" directive.

Author: xeioex

xml/en/docs/http/ngx_http_js_module.xml

@@ -9,7 +9,7 @@
 <module name="Module ngx_http_js_module"
         link="/en/docs/http/ngx_http_js_module.html"
         lang="en"
-        rev="47">
+        rev="48">
 
 <section id="summary">
 
@@ -646,8 +646,9 @@ Several <literal>js_preload_object</literal> directives can be specified.
 
 <directive name="js_set">
 <syntax>
-<value>$variable</value> <value>function</value> |
-<value>module.function</value></syntax>
+    <value>$variable</value>
+    <value>function</value> | <value>module.function</value>
+    [<literal>nocache</literal>]</syntax>
 <default/>
 <context>http</context>
 <context>server</context>
@@ -675,6 +676,17 @@ This handler can be used to do some cleanup
 right before the request is freed.
 </para>
 
+<para>
+Since <link doc="../njs/changes.xml" id="njs0.8.6">0.8.6</link>,
+if an optional argument <literal>nocache</literal> is specified,
+the handler is called every time it is referenced.
+Due to current limitations
+of the <link doc="ngx_http_rewrite_module.xml">rewrite</link> module,
+when a <literal>nocache</literal> variable is referenced by the
+<link doc="ngx_http_rewrite_module.xml" id="set">set</link> directive
+its handler should always return a fixed-length value.
+</para>
+
 <para>
 <note>
 As the <literal>js_set</literal> handler

xml/en/docs/stream/ngx_stream_js_module.xml

@@ -9,7 +9,7 @@
 <module name="Module ngx_stream_js_module"
         link="/en/docs/stream/ngx_stream_js_module.html"
         lang="en"
-        rev="45">
+        rev="46">
 
 <section id="summary">
 
@@ -632,8 +632,9 @@ See
 
 <directive name="js_set">
 <syntax>
-<value>$variable</value> <value>function</value> |
-<value>module.function</value></syntax>
+    <value>$variable</value>
+    <value>function</value> | <value>module.function</value>
+    [<literal>nocache</literal>]</syntax>
 <default/>
 <context>stream</context>
 <context>server</context>
@@ -660,6 +661,17 @@ This handler can be used to do some cleanup
 right before the request is freed.
 </para>
 
+<para>
+Since <link doc="../njs/changes.xml" id="njs0.8.6">0.8.6</link>, when
+optional argument <literal>nocache</literal> is provided the handler
+is called every time it is referenced.
+Due to current limitations
+of the <link doc="ngx_stream_rewrite_module.xml">rewrite</link> module,
+when a <literal>nocache</literal> variable is referenced by the
+<link doc="ngx_stream_set_module.xml" id="set">set</link> directive
+its handler should always return a fixed-length value.
+</para>
+
 <para>
 <note>
 As the <literal>js_set</literal> handler

xml/ru/docs/http/ngx_http_js_module.xml

@@ -9,7 +9,7 @@
 <module name="Модуль ngx_http_js_module"
         link="/ru/docs/http/ngx_http_js_module.html"
         lang="ru"
-        rev="47">
+        rev="48">
 
 <section id="summary">
 
@@ -648,8 +648,9 @@ js_preload_object map.json;
 
 <directive name="js_set">
 <syntax>
-<value>$переменная</value> <value>функция</value> |
-<value>модуль.функция</value></syntax>
+    <value>$переменная</value>
+    <value>функция</value> | <value>модуль.функция</value>
+    [<literal>nocache</literal>]</syntax>
 <default/>
 <context>http</context>
 <context>server</context>
@@ -677,6 +678,16 @@ js_preload_object map.json;
 непосредственно перед освобождением запроса.
 </para>
 
+<para>
+Начиная с <link doc="../njs/changes.xml" id="njs0.8.6">0.8.6</link>,
+если указан необязательный параметр <literal>nocache</literal>, то
+обработчик выполняется каждый раз при обращении к переменной.
+Из-за ограничения модуля  <link doc="ngx_http_rewrite_module.xml">rewrite</link>
+при обращении к <literal>nocache</literal>-переменной при помощи
+директивы <link doc="ngx_http_rewrite_module.xml" id="set">set</link>,
+обработчик должен возвращать значение фиксированной длины.
+</para>
+
 <para>
 <note>
 Так как обработчик <literal>js_set</literal>

xml/ru/docs/stream/ngx_stream_js_module.xml

@@ -9,7 +9,7 @@
 <module name="Модуль ngx_stream_js_module"
         link="/ru/docs/stream/ngx_stream_js_module.html"
         lang="ru"
-        rev="45">
+        rev="46">
 
 <section id="summary">
 
@@ -632,8 +632,9 @@ async function handler(s) {
 
 <directive name="js_set">
 <syntax>
-<value>$переменная</value> <value>функция</value> |
-<value>модуль.функция</value></syntax>
+    <value>$переменная</value>
+    <value>функция</value> | <value>модуль.функция</value>
+    [<literal>nocache</literal>]</syntax>
 <default/>
 <context>stream</context>
 <context>server</context>
@@ -660,6 +661,16 @@ async function handler(s) {
 непосредственно перед освобождением запроса.
 </para>
 
+<para>
+Начиная с <link doc="../njs/changes.xml" id="njs0.8.6">0.8.6</link>,
+если указан необязательный параметр <literal>nocache</literal>, то
+обработчик выполняется каждый раз при обращении к переменной.
+Из-за ограничения модуля  <link doc="ngx_stream_rewrite_module.xml">rewrite</link>
+при обращении к <literal>nocache</literal>-переменной при помощи
+директивы <link doc="ngx_stream_rewrite_module.xml" id="set">set</link>,
+обработчик должен возвращать значение фиксированной длины.
+</para>
+
 <para>
 <note>
 Так как обработчик <literal>js_set</literal>