# HG changeset patch
# User Yaroslav Zhuravlev <yar@nginx.com>
# Date 1661262712 -3600
# Node ID ccd42f2b99fbca17effb530b31ddde9b50382094
# Parent  4959250ba4299b3df47ce71b35787c7f855834f2
Deprecated several methods in njs reference.

diff -r 4959250ba429 -r ccd42f2b99fb xml/en/docs/njs/reference.xml
--- a/xml/en/docs/njs/reference.xml	Tue Aug 23 14:51:40 2022 +0100
+++ b/xml/en/docs/njs/reference.xml	Tue Aug 23 14:51:52 2022 +0100
@@ -9,7 +9,7 @@
 <article name="Reference"
         link="/en/docs/njs/reference.html"
         lang="en"
-        rev="86">
+        rev="87">
 
 <section id="summary">
 
@@ -2399,30 +2399,44 @@
 <tag-name id="string_frombytes"><literal>String.prototype.fromBytes(<value>start</value>[,
 <value>end</value>])</literal></tag-name>
 <tag-desc>
-Returns a new Unicode string from a byte string
-where each byte is replaced with a corresponding Unicode code point.
+the property is deprecated since
+<link doc="changes.xml" id="njs0.7.7">0.7.7</link>.
+Before <link doc="changes.xml" id="njs0.7.7">0.7.7</link>,
+returned a new Unicode string from a byte string
+where each byte was replaced with a corresponding Unicode code point.
 </tag-desc>
 
 <tag-name id="string_fromutf8"><literal>String.prototype.fromUTF8(<value>start</value>[,
 <value>end</value>])</literal></tag-name>
 <tag-desc>
-Converts a byte string containing a valid UTF-8 string
+the property is deprecated since
+<link doc="changes.xml" id="njs0.7.7">0.7.7</link>,
+the <link id="textedeoder"><literal>TextDecoder</literal></link> method
+should be used instead.
+Before <link doc="changes.xml" id="njs0.7.7">0.7.7</link>,
+converted a byte string containing a valid UTF-8 string
 into a Unicode string,
-otherwise <literal>null</literal> is returned.
+otherwise <literal>null</literal> was returned.
 </tag-desc>
 
 <tag-name id="string_tobytes"><literal>String.prototype.toBytes(<value>start</value>[,
 <value>end</value>])</literal></tag-name>
 <tag-desc>
-Serializes a Unicode string to a byte string.
-Returns <literal>null</literal> if a character larger than 255 is
+the property is deprecated since
+<link doc="changes.xml" id="njs0.7.7">0.7.7</link>.
+Before <link doc="changes.xml" id="njs0.7.7">0.7.7</link>,
+serialized a Unicode string to a byte string,
+returned <literal>null</literal> if a character larger than 255 was
 found in the string.
 </tag-desc>
 
 <tag-name id="string_tostring"><literal>String.prototype.toString(<value>encoding</value>)</literal></tag-name>
 <tag-desc>
 <para>
-Encodes a string to
+the property is deprecated since
+<link doc="changes.xml" id="njs0.7.7">0.7.7</link>.
+Before <link doc="changes.xml" id="njs0.7.7">0.7.7</link>,
+encoded a string to
 <literal>hex</literal>,
 <literal>base64</literal>, or
 <literal>base64url</literal>:
@@ -2442,8 +2456,13 @@
 <tag-name id="string_toutf8"><literal>String.prototype.toUTF8(<value>start</value>[,
 <value>end</value>])</literal></tag-name>
 <tag-desc>
-Serializes a Unicode string
-to a byte string using UTF-8 encoding.
+the property is deprecated since
+<link doc="changes.xml" id="njs0.7.7">0.7.7</link>,
+the <link id="textencoder"><literal>TextEncoder</literal></link> method
+should be used instead.
+Before <link doc="changes.xml" id="njs0.7.7">0.7.7</link>,
+serialized a Unicode string
+to a byte string using UTF-8 encoding:
 <example>
 >> 'αβγδ'.toUTF8().length
 8