# HG changeset patch
# User Yaroslav Zhuravlev <yar@nginx.com>
# Date 1683618185 -3600
# Node ID b2bb7aa090da2bbee9855d36f592527521ab1a48
# Parent  cebca5ba84d7d7af7cdb1658af36b18bc3208bd8
Updated ngx.fetch description in njs Reference.

diff -r cebca5ba84d7 -r b2bb7aa090da xml/en/docs/njs/reference.xml
--- a/xml/en/docs/njs/reference.xml	Wed May 03 13:15:55 2023 +0100
+++ b/xml/en/docs/njs/reference.xml	Tue May 09 08:43:05 2023 +0100
@@ -9,7 +9,7 @@
 <article name="Reference"
         link="/en/docs/njs/reference.html"
         lang="en"
-        rev="103">
+        rev="104">
 
 <section id="summary">
 
@@ -1161,6 +1161,7 @@
 <tag-name id="ngx_fetch"><literal>ngx.fetch(<value>resource</value>,
 [<value>options</value>])</literal></tag-name>
 <tag-desc>
+<para>
 Makes a request to fetch a <value>resource</value>
 (<link doc="changes.xml" id="njs0.5.1">0.5.1</link>), which can be an
 URL or the <link id="request"><literal>Request</literal></link> object
@@ -1170,6 +1171,18 @@
 Since <link doc="changes.xml" id="njs0.7.0">0.7.0</link>,
 the <literal>https://</literal> scheme is supported,
 redirects are not handled.
+</para>
+
+<para>
+If the URL in the <value>resource</value> is specified as a domain name,
+it is determined using a
+<link doc="../http/ngx_http_core_module.xml" id="resolver"/>.
+If the <literal>https://</literal> scheme is specified, the
+<link doc="../http/ngx_http_js_module.xml" id="js_fetch_trusted_certificate"/>
+directive should be configured
+for the authentication of the <value>resource</value>'s HTTPS server.
+</para>
+
 <para>
 The <literal>options</literal> parameter is expected to be an object
 with the following keys: