--- a/xml/en/docs/http/ngx_http_core_module.xml
+++ b/xml/en/docs/http/ngx_http_core_module.xml
@@ -1845,22 +1845,28 @@ closed normally.
 <context>location</context>
 
 <para>
-Configures name servers used to resolve names of upstream servers,
-for example:
+Configures name servers used to resolve names of upstream servers
+into addresses, for example:
 <example>
-resolver 127.0.0.1 192.0.2.1;
+resolver 127.0.0.1 [::1]:5353;
 </example>
-An <value>address</value> parameter may be specified as
-either an IPv4 address or a hostname;
-in the latter case, the first resolved IPv4 address is used.
+An address can be specified as a domain name or IP address,
+and an optional port (1.3.1).
+<!--
+If address is specified using a domain name, only the first
+resolved IPv4 address is used.
+-->
+If port is not specified, the port 53 is used.
 Name servers are queried in a round-robin fashion.
 <note>
 Before version 1.1.7, only a single name server could be configured.
+Specifying name servers using IPv6 addresses is supported
+starting from version 1.3.1.
 </note>
 By default, nginx caches answers using the TTL value of a response.
 An optional <literal>valid</literal> parameter allows to override it:
 <example>
-resolver 127.0.0.1 192.0.2.1 valid=30s;
+resolver 127.0.0.1 [::1]:5353 valid=30s;
 </example>
 <note>
 Before version 1.1.9, tuning of caching time was not possible,

--- a/xml/ru/docs/http/ngx_http_core_module.xml
+++ b/xml/ru/docs/http/ngx_http_core_module.xml
@@ -1832,20 +1832,26 @@ open_file_cache_events   on;
 Задаёт серверы DNS, используемые для преобразования имён вышестоящих серверов
 в адреса, например:
 <example>
-resolver 127.0.0.1 192.0.2.1;
+resolver 127.0.0.1 [::1]:5353;
 </example>
-Параметр <value>адрес</value> может быть задан либо
-IPv4-адресом, либо именем хоста;
-во втором случае используется первый полученный IPv4-адрес.
+Адрес может быть указан в виде доменного имени или IP-адреса,
+и необязательного порта (1.3.1).
+<!--
+Если адрес указан в виде доменного имени, используется только первый
+IPv4-адрес, соответствующий имени.
+-->
+Если порт не указан, используется порт 53.
 Серверы DNS опрашиваются циклически.
 <note>
 До версии 1.1.7 можно было задать лишь один DNS-сервер.
+Задание DNS-серверов с помощью IPv6-адресов поддерживается
+начиная с версии 1.3.1.
 </note>
 По умолчанию nginx кэширует ответы, используя значение TTL из ответа.
 Необязательный параметр <literal>valid</literal> позволяет это
 переопределить:
 <example>
-resolver 127.0.0.1 192.0.2.1 valid=30s;
+resolver 127.0.0.1 [::1]:5353 valid=30s;
 </example>
 <note>
 До версии 1.1.9 настройка времени кэширования была невозможна