changeset 2452:4487310de7e7

Added IDs to resolver parameters, minor language fixes in resolver.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 29 Oct 2019 19:19:25 +0300
parents 721f78cff4ef
children 1b0cc44de0fd
files xml/en/docs/http/ngx_http_core_module.xml xml/en/docs/mail/ngx_mail_core_module.xml xml/en/docs/stream/ngx_stream_core_module.xml xml/ru/docs/http/ngx_http_core_module.xml xml/ru/docs/mail/ngx_mail_core_module.xml xml/ru/docs/stream/ngx_stream_core_module.xml
diffstat 6 files changed, 36 insertions(+), 18 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_core_module.xml
+++ b/xml/en/docs/http/ngx_http_core_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_core_module"
         link="/en/docs/http/ngx_http_core_module.html"
         lang="en"
-        rev="86">
+        rev="87">
 
 <section id="directives" name="Directives">
 
@@ -2128,8 +2128,8 @@ into addresses, for example:
 <example>
 resolver 127.0.0.1 [::1]:5353;
 </example>
-An address can be specified as a domain name or IP address,
-and an optional port (1.3.1, 1.2.2).
+The address can be specified as a domain name or IP address,
+with an optional port (1.3.1, 1.2.2).
 If port is not specified, the port 53 is used.
 Name servers are queried in a round-robin fashion.
 <note>
@@ -2137,6 +2137,9 @@ Before version 1.1.7, only a single name
 Specifying name servers using IPv6 addresses is supported
 starting from versions 1.3.1 and 1.2.2.
 </note>
+</para>
+
+<para id="resolver_ipv6">
 By default, nginx will look up both IPv4 and IPv6 addresses while resolving.
 If looking up of IPv6 addresses is not desired,
 the <literal>ipv6=off</literal> parameter can be specified.
@@ -2144,6 +2147,9 @@ the <literal>ipv6=off</literal> paramete
 Resolving of names into IPv6 addresses is supported
 starting from version 1.5.8.
 </note>
+</para>
+
+<para id="resolver_valid">
 By default, nginx caches answers using the TTL value of a response.
 An optional <literal>valid</literal> parameter allows overriding it:
 <example>
--- a/xml/en/docs/mail/ngx_mail_core_module.xml
+++ b/xml/en/docs/mail/ngx_mail_core_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_mail_core_module"
         link="/en/docs/mail/ngx_mail_core_module.html"
         lang="en"
-        rev="11">
+        rev="12">
 
 <section id="summary">
 
@@ -302,8 +302,8 @@ For example:
 <example>
 resolver 127.0.0.1 [::1]:5353;
 </example>
-An address can be specified as a domain name or IP address,
-and an optional port (1.3.1, 1.2.2).
+The address can be specified as a domain name or IP address,
+with an optional port (1.3.1, 1.2.2).
 If port is not specified, the port 53 is used.
 Name servers are queried in a round-robin fashion.
 <note>
@@ -311,6 +311,9 @@ Before version 1.1.7, only a single name
 Specifying name servers using IPv6 addresses is supported
 starting from versions 1.3.1 and 1.2.2.
 </note>
+</para>
+
+<para id="resolver_valid">
 By default, nginx caches answers using the TTL value of a response.
 An optional <literal>valid</literal> parameter allows overriding it:
 <example>
@@ -332,7 +335,7 @@ The parameter is available as part of ou
 <commercial_version>commercial subscription</commercial_version>.
 </para>
 
-<para>
+<para id="resolver_off">
 The special value <literal>off</literal> disables resolving.
 </para>
 
--- a/xml/en/docs/stream/ngx_stream_core_module.xml
+++ b/xml/en/docs/stream/ngx_stream_core_module.xml
@@ -9,7 +9,7 @@
 <module name="Module ngx_stream_core_module"
         link="/en/docs/stream/ngx_stream_core_module.html"
         lang="en"
-        rev="28">
+        rev="29">
 
 <section id="summary">
 
@@ -333,19 +333,19 @@ into addresses, for example:
 <example>
 resolver 127.0.0.1 [::1]:5353;
 </example>
-An address can be specified as a domain name or IP address,
-and an optional port.
+The address can be specified as a domain name or IP address,
+with an optional port.
 If port is not specified, the port 53 is used.
 Name servers are queried in a round-robin fashion.
 </para>
 
-<para>
+<para id="resolver_ipv6">
 By default, nginx will look up both IPv4 and IPv6 addresses while resolving.
 If looking up of IPv6 addresses is not desired,
 the <literal>ipv6=off</literal> parameter can be specified.
 </para>
 
-<para>
+<para id="resolver_valid">
 By default, nginx caches answers using the TTL value of a response.
 The optional <literal>valid</literal> parameter allows overriding it:
 <example>
--- a/xml/ru/docs/http/ngx_http_core_module.xml
+++ b/xml/ru/docs/http/ngx_http_core_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_core_module"
         link="/ru/docs/http/ngx_http_core_module.html"
         lang="ru"
-        rev="86">
+        rev="87">
 
 <section id="directives" name="Директивы">
 
@@ -2135,6 +2135,9 @@ resolver 127.0.0.1 [::1]:5353;
 Задание DNS-серверов с помощью IPv6-адресов поддерживается
 начиная с версий 1.3.1 и 1.2.2.
 </note>
+</para>
+
+<para id="resolver_ipv6">
 По умолчанию nginx будет искать как IPv4-, так и IPv6-адреса
 при преобразовании имён в адреса.
 Если поиск IPv6-адресов нежелателен,
@@ -2143,6 +2146,9 @@ resolver 127.0.0.1 [::1]:5353;
 Преобразование имён в IPv6-адреса поддерживается
 начиная с версии 1.5.8.
 </note>
+</para>
+
+<para id="resolver_valid">
 По умолчанию nginx кэширует ответы, используя значение TTL из ответа.
 Необязательный параметр <literal>valid</literal> позволяет это
 переопределить:
--- a/xml/ru/docs/mail/ngx_mail_core_module.xml
+++ b/xml/ru/docs/mail/ngx_mail_core_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_mail_core_module"
         link="/ru/docs/mail/ngx_mail_core_module.html"
         lang="ru"
-        rev="11">
+        rev="12">
 
 <section id="summary">
 
@@ -313,6 +313,9 @@ resolver 127.0.0.1 [::1]:5353;
 Задание DNS-серверов с помощью IPv6-адресов поддерживается
 начиная с версий 1.3.1 и 1.2.2.
 </note>
+</para>
+
+<para id="resolver_valid">
 По умолчанию nginx кэширует ответы, используя значение TTL из ответа.
 Необязательный параметр <literal>valid</literal> позволяет это
 переопределить:
@@ -335,7 +338,7 @@ resolver 127.0.0.1 [::1]:5353 valid=30s;
 <commercial_version>коммерческой подписки</commercial_version>.
 </para>
 
-<para>
+<para id="resolver_off">
 Специальное значение <literal>off</literal> запрещает использование DNS.
 </para>
 
--- a/xml/ru/docs/stream/ngx_stream_core_module.xml
+++ b/xml/ru/docs/stream/ngx_stream_core_module.xml
@@ -9,7 +9,7 @@
 <module name="Модуль ngx_stream_core_module"
         link="/ru/docs/stream/ngx_stream_core_module.html"
         lang="ru"
-        rev="28">
+        rev="29">
 
 <section id="summary">
 
@@ -344,14 +344,14 @@ resolver 127.0.0.1 [::1]:5353;
 Серверы DNS опрашиваются циклически.
 </para>
 
-<para>
+<para id="resolver_ipv6">
 По умолчанию nginx будет искать как IPv4-, так и IPv6-адреса
 при преобразовании имён в адреса.
 Если поиск IPv6-адресов нежелателен,
 можно указать параметр <literal>ipv6=off</literal>.
 </para>
 
-<para>
+<para id="resolver_valid">
 По умолчанию nginx кэширует ответы, используя значение TTL из ответа.
 Необязательный параметр <literal>valid</literal> позволяет это
 переопределить: