# HG changeset patch
# User Yaroslav Zhuravlev <yar@nginx.com>
# Date 1570448476 -10800
# Node ID 080581ce888d2f287e961d724b44ade806d667da
# Parent  7a353370ffcd865ea81c78558b89b5aa6c6858cc
Added note to r.headersIn in njs Reference.

diff -r 7a353370ffcd -r 080581ce888d xml/en/docs/njs/reference.xml
--- a/xml/en/docs/njs/reference.xml	Thu Oct 03 19:39:57 2019 +0300
+++ b/xml/en/docs/njs/reference.xml	Mon Oct 07 14:41:16 2019 +0300
@@ -9,7 +9,7 @@
 <article name="Reference"
         link="/en/docs/njs/reference.html"
         lang="en"
-        rev="30">
+        rev="31">
 
 <section id="summary">
 
@@ -56,6 +56,17 @@
 For example, the <literal>Foo</literal> header
 can be accessed with the syntax <literal>headersIn.foo</literal>
 or <literal>headersIn['Foo']</literal>
+<note>
+For headers that can appear multiple times such as
+<header>Cookie</header> or <header>X-Forwarded-For</header>,
+only the first value will be returned.
+To get all cookies,
+<literal>r.variables.http_cookie</literal>
+should be used.
+To get the <literal>name</literal> cookie,
+<literal>r.variables["cookie_<value>name</value>"]</literal>
+should be used.
+</note>
 </para>
 </tag-desc>
 
diff -r 7a353370ffcd -r 080581ce888d xml/ru/docs/njs/reference.xml
--- a/xml/ru/docs/njs/reference.xml	Thu Oct 03 19:39:57 2019 +0300
+++ b/xml/ru/docs/njs/reference.xml	Mon Oct 07 14:41:16 2019 +0300
@@ -57,6 +57,17 @@
 Например, доступ к заголовку <literal>Foo</literal>
 можно получить при помощи синтаксиса <literal>headersIn.foo</literal>
 или <literal>headersIn['Foo']</literal>
+<note>
+Если заголовок может быть указан несколько раз, например
+<header>Cookie</header> или <header>X-Forwarded-For</header>,
+будет возвращено только первое значение.
+Чтобы получить все cookie
+необходимо использовать
+<literal>r.variables.http_cookie</literal>.
+Чтобы получить <literal>имя</literal> cookie
+необходимо использовать
+<literal>r.variables["cookie_<value>имя</value>"]</literal>.
+</note>
 </para>
 </tag-desc>