# HG changeset patch
# User Yaroslav Zhuravlev <yar@nginx.com>
# Date 1529412225 -10800
# Node ID 97526b8346f499d2328fd6d4a77f073500c5bd20
# Parent  7865ca0da0ab6c21ef0465bbf88089efab04cca3
Added r.internalRedirect and its example in njs.

diff --git a/xml/en/docs/njs/njs_api.xml b/xml/en/docs/njs/njs_api.xml
--- a/xml/en/docs/njs/njs_api.xml
+++ b/xml/en/docs/njs/njs_api.xml
@@ -269,6 +269,13 @@ writes a <literal>string</literal> to th
 on the <literal>info</literal> level of logging
 </tag-desc>
 
+<tag-name id="r_internal_redirect"><literal>r.internalRedirect(<value>uri</value>)</literal></tag-name>
+<tag-desc>
+performs an internal redirect to the specified <literal>uri</literal>.
+If the uri starts with the “<literal>@</literal>” prefix,
+it is considered a named location.
+</tag-desc>
+
 <tag-name><literal>r.method</literal></tag-name>
 <tag-desc>
 HTTP method, read-only
@@ -526,6 +533,34 @@ function encoded_foo(r) {
 </section>
 
 
+<section id="example_internal_redirect" name="Internal Redirect">
+
+<para>
+<example>
+js_include redirect.js;
+
+location /redirect {
+    js_content redirect;
+}
+
+@named {
+    return 200 named;
+}
+</example>
+</para>
+
+<para>
+The <path>redirect.js</path> file:
+<example>
+function redirect(r) {
+    r.internalRedirect('@named');
+}
+</example>
+</para>
+
+</section>
+
+
 <section id="example_fast_response" name="Returning Fastest Response from Proxy">
 
 <para>