# HG changeset patch
# User Yaroslav Zhuravlev <yar@nginx.com>
# Date 1664552562 -3600
# Node ID 438a9cfa4fae9b370f6e64ed326ee82d89d3bd98
# Parent  8f395509754602e43910eddb81385bcff745fb32
Added info about setting r.headersOut in njs reference.

diff -r 8f3955097546 -r 438a9cfa4fae xml/en/docs/njs/reference.xml
--- a/xml/en/docs/njs/reference.xml	Tue Sep 27 16:13:35 2022 +0400
+++ b/xml/en/docs/njs/reference.xml	Fri Sep 30 16:42:42 2022 +0100
@@ -9,7 +9,7 @@
 <article name="Reference"
         link="/en/docs/njs/reference.html"
         lang="en"
-        rev="89">
+        rev="90">
 
 <section id="summary">
 
@@ -173,6 +173,26 @@
 </para>
 
 <para>
+Outgoing headers should be set before a response header is sent to a client,
+otherwise header update will be ignored.
+This means that <literal>r.headersOut{}</literal> is effectively writable in:
+
+<list type="bullet">
+
+<listitem>
+the <link doc="../http/ngx_http_js_module.xml" id="js_content"/> handler before
+<link id="r_send_header"><literal>r.sendHeader()</literal></link> or
+<link id="r_return"><literal>r.return()</literal></link> are called
+</listitem>
+
+<listitem>
+the <link doc="../http/ngx_http_js_module.xml" id="js_header_filter"/> handler
+</listitem>
+
+</list>
+</para>
+
+<para>
 Field values of multi-value response headers
 (<link doc="changes.xml" id="njs0.4.0">0.4.0</link>)
 can be set with the syntax: