# HG changeset patch
# User Yaroslav Zhuravlev <yar@nginx.com>
# Date 1659970987 -3600
# Node ID 0280b6c71d388f0fb535a2c64adfa733156c26ca
# Parent  d8162f6cee3832bbdde2722973d4682c567594a5
Added note about string length to log methods in njs.

diff -r d8162f6cee38 -r 0280b6c71d38 xml/en/docs/njs/reference.xml
--- a/xml/en/docs/njs/reference.xml	Fri Aug 05 12:21:34 2022 +0400
+++ b/xml/en/docs/njs/reference.xml	Mon Aug 08 16:03:07 2022 +0100
@@ -9,7 +9,7 @@
 <article name="Reference"
         link="/en/docs/njs/reference.html"
         lang="en"
-        rev="84">
+        rev="85">
 
 <section id="summary">
 
@@ -111,6 +111,14 @@
 <tag-desc>
 writes a <literal>string</literal> to the error log
 on the <literal>error</literal> level of logging
+<para>
+<note>
+As nginx has a
+<link doc="../dev/development_guide.xml" id="logging">hardcoded</link>
+maximum line length limit,
+only first 2048 bytes of the string can be logged.
+</note>
+</para>
 </tag-desc>
 
 <tag-name id="r_finish"><literal>r.finish()</literal></tag-name>
@@ -248,6 +256,14 @@
 <tag-desc>
 writes a <literal>string</literal> to the error log
 on the <literal>info</literal> level of logging
+<para>
+<note>
+As nginx has a
+<link doc="../dev/development_guide.xml" id="logging">hardcoded</link>
+maximum line length limit,
+only first 2048 bytes of the string can be logged.
+</note>
+</para>
 </tag-desc>
 
 <tag-name id="r_method"><literal>r.method</literal></tag-name>
@@ -559,6 +575,14 @@
 <tag-desc>
 writes a <literal>string</literal> to the error log
 on the <literal>warning</literal> level of logging
+<para>
+<note>
+As nginx has a
+<link doc="../dev/development_guide.xml" id="logging">hardcoded</link>
+maximum line length limit,
+only first 2048 bytes of the string can be logged.
+</note>
+</para>
 </tag-desc>
 
 </list>
@@ -642,6 +666,14 @@
 <tag-desc>
 writes a sent <literal>string</literal> to the error log
 on the <literal>error</literal> level of logging
+<para>
+<note>
+As nginx has a
+<link doc="../dev/development_guide.xml" id="logging">hardcoded</link>
+maximum line length limit,
+only first 2048 bytes of the string can be logged.
+</note>
+</para>
 </tag-desc>
 
 <tag-name id="s_log"><literal>s.log(<value>string</value>)</literal></tag-name>
@@ -654,6 +686,14 @@
 <tag-desc>
 unregisters the callback set by the <link id="s_on">s.on()</link> method
 (<link doc="changes.xml" id="njs0.2.4">0.2.4</link>)
+<para>
+<note>
+As nginx has a
+<link doc="../dev/development_guide.xml" id="logging">hardcoded</link>
+maximum line length limit,
+only first 2048 bytes of the string can be logged.
+</note>
+</para>
 </tag-desc>
 
 <tag-name id="s_on"><literal>s.on(<value>event</value>,
@@ -790,6 +830,14 @@
 <tag-desc>
 writes a sent <literal>string</literal> to the error log
 on the <literal>warning</literal> level of logging
+<para>
+<note>
+As nginx has a
+<link doc="../dev/development_guide.xml" id="logging">hardcoded</link>
+maximum line length limit,
+only first 2048 bytes of the string can be logged.
+</note>
+</para>
 </tag-desc>
 
 </list>
@@ -976,6 +1024,14 @@
 <literal>ngx.INFO</literal>,
 <literal>ngx.WARN</literal>, and
 <literal>ngx.ERR</literal>.
+<para>
+<note>
+As nginx has a
+<link doc="../dev/development_guide.xml" id="logging">hardcoded</link>
+maximum line length limit,
+only first 2048 bytes of the string can be logged.
+</note>
+</para>
 </tag-desc>
 
 </list>