# HG changeset patch
# User Sergey Kandaurov <pluknet@nginx.com>
# Date 1488808882 -10800
# Node ID 237a10fb98d26c7ebf6c521dc8aa76c045ff19d4
# Parent  66a30a380fba9eabd3f91c518bb4afff5efa35d3
Clarified imap/pop3/smtp_capabilities and starttls interaction.

diff --git a/xml/en/docs/mail/ngx_mail_imap_module.xml b/xml/en/docs/mail/ngx_mail_imap_module.xml
--- a/xml/en/docs/mail/ngx_mail_imap_module.xml
+++ b/xml/en/docs/mail/ngx_mail_imap_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_mail_imap_module"
         link="/en/docs/mail/ngx_mail_imap_module.html"
         lang="en"
-        rev="3">
+        rev="4">
 
 <section id="directives" name="Directives">
 
@@ -63,10 +63,10 @@ Sets the
 <link url="https://tools.ietf.org/html/rfc3501">IMAP protocol</link>
 extensions list that is passed to the client in response to
 the <literal>CAPABILITY</literal> command.
-The authentication methods specified in the <link id="imap_auth"/> and
-<link url="https://tools.ietf.org/html/rfc2595">STARTTLS</link> directives
-are automatically added to this list if the
-<link doc="ngx_mail_ssl_module.xml" id="starttls"/> directive is enabled.
+The authentication methods specified in the <link id="imap_auth"/> directive and
+<link url="https://tools.ietf.org/html/rfc2595">STARTTLS</link>
+are automatically added to this list depending on the
+<link doc="ngx_mail_ssl_module.xml" id="starttls"/> directive value.
 </para>
 
 <para>
diff --git a/xml/en/docs/mail/ngx_mail_pop3_module.xml b/xml/en/docs/mail/ngx_mail_pop3_module.xml
--- a/xml/en/docs/mail/ngx_mail_pop3_module.xml
+++ b/xml/en/docs/mail/ngx_mail_pop3_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_mail_pop3_module"
         link="/en/docs/mail/ngx_mail_pop3_module.html"
         lang="en"
-        rev="3">
+        rev="4">
 
 <section id="directives" name="Directives">
 
@@ -67,12 +67,11 @@ Sets the
 <link url="https://tools.ietf.org/html/rfc2449">POP3 protocol</link>
 extensions list that is passed to the client in response to
 the <literal>CAPA</literal> command.
-
-The authentication methods specified in the <link id="pop3_auth"/> and
+The authentication methods specified in the <link id="pop3_auth"/> directive
 (<link url="https://tools.ietf.org/html/rfc2449">SASL</link> extension) and
-<link url="https://tools.ietf.org/html/rfc2595">STLS</link> directives,
-are automatically added to this list if the
-<link doc="ngx_mail_ssl_module.xml" id="starttls"/> directive is enabled.
+<link url="https://tools.ietf.org/html/rfc2595">STLS</link>
+are automatically added to this list depending on the
+<link doc="ngx_mail_ssl_module.xml" id="starttls"/> directive value.
 </para>
 
 <para>
diff --git a/xml/en/docs/mail/ngx_mail_smtp_module.xml b/xml/en/docs/mail/ngx_mail_smtp_module.xml
--- a/xml/en/docs/mail/ngx_mail_smtp_module.xml
+++ b/xml/en/docs/mail/ngx_mail_smtp_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_mail_smtp_module"
         link="/en/docs/mail/ngx_mail_smtp_module.html"
         lang="en"
-        rev="4">
+        rev="5">
 
 <section id="directives" name="Directives">
 
@@ -69,8 +69,10 @@ Authentication is not required.
 Sets the SMTP protocol extensions list
 that is passed to the client in response to the
 <literal>EHLO</literal> command.
-Authentication methods specified in the <link id="smtp_auth"/> directive
-are automatically added to this list.
+The authentication methods specified in the <link id="smtp_auth"/> directive and
+<link url="https://tools.ietf.org/html/rfc3207">STARTTLS</link>
+are automatically added to this list depending on the
+<link doc="ngx_mail_ssl_module.xml" id="starttls"/> directive value.
 </para>
 
 <para>
diff --git a/xml/en/docs/mail/ngx_mail_ssl_module.xml b/xml/en/docs/mail/ngx_mail_ssl_module.xml
--- a/xml/en/docs/mail/ngx_mail_ssl_module.xml
+++ b/xml/en/docs/mail/ngx_mail_ssl_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_mail_ssl_module"
         link="/en/docs/mail/ngx_mail_ssl_module.html"
         lang="en"
-        rev="14">
+        rev="15">
 
 <section id="summary">
 
@@ -573,7 +573,7 @@ Sets the verification depth in the clien
 <tag-name><literal>on</literal></tag-name>
 <tag-desc>
 allow usage of the <literal>STLS</literal> command for the POP3
-and the <literal>STARTTLS</literal> command for the IMAP;
+and the <literal>STARTTLS</literal> command for the IMAP and SMTP;
 </tag-desc>
 
 <tag-name><literal>off</literal></tag-name>
diff --git a/xml/ru/docs/mail/ngx_mail_imap_module.xml b/xml/ru/docs/mail/ngx_mail_imap_module.xml
--- a/xml/ru/docs/mail/ngx_mail_imap_module.xml
+++ b/xml/ru/docs/mail/ngx_mail_imap_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_mail_imap_module"
         link="/ru/docs/mail/ngx_mail_imap_module.html"
         lang="ru"
-        rev="3">
+        rev="4">
 
 <section id="directives" name="Директивы">
 
@@ -63,10 +63,11 @@
 <link url="https://tools.ietf.org/html/rfc3501">протокола IMAP</link>,
 выдаваемый клиенту по команде
 <literal>CAPABILITY</literal>.
-К этому списку автоматически добавляются
-методы аутентификации, указанные в директиве <link id="imap_auth"/> и
-<link url="https://tools.ietf.org/html/rfc2595">STARTTLS</link>,
-если включена директива <link doc="ngx_mail_ssl_module.xml" id="starttls"/>.
+В зависимости от значения директивы
+<link doc="ngx_mail_ssl_module.xml" id="starttls"/>
+к этому списку автоматически добавляются
+методы аутентификации, указанные в директиве <link id="imap_auth"/>, и
+<link url="https://tools.ietf.org/html/rfc2595">STARTTLS</link>.
 </para>
 
 <para>
diff --git a/xml/ru/docs/mail/ngx_mail_pop3_module.xml b/xml/ru/docs/mail/ngx_mail_pop3_module.xml
--- a/xml/ru/docs/mail/ngx_mail_pop3_module.xml
+++ b/xml/ru/docs/mail/ngx_mail_pop3_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_mail_pop3_module"
         link="/ru/docs/mail/ngx_mail_pop3_module.html"
         lang="ru"
-        rev="3">
+        rev="4">
 
 <section id="directives" name="Директивы">
 
@@ -67,11 +67,12 @@
 <link url="https://tools.ietf.org/html/rfc2449">протокола POP3</link>,
 выдаваемый клиенту по команде
 <literal>CAPA</literal>.
-К этому списку автоматически добавляются
+В зависимости от значения директивы
+<link doc="ngx_mail_ssl_module.xml" id="starttls"/>
+к этому списку автоматически добавляются
 методы аутентификации, указанные в директиве <link id="pop3_auth"/>
-(расширение <link url="https://tools.ietf.org/html/rfc2449">SASL</link>) и
-<link url="https://tools.ietf.org/html/rfc2595">STLS</link>,
-если включена директива <link doc="ngx_mail_ssl_module.xml" id="starttls"/>.
+(расширение <link url="https://tools.ietf.org/html/rfc2449">SASL</link>), и
+<link url="https://tools.ietf.org/html/rfc2595">STLS</link>.
 </para>
 
 <para>
diff --git a/xml/ru/docs/mail/ngx_mail_smtp_module.xml b/xml/ru/docs/mail/ngx_mail_smtp_module.xml
--- a/xml/ru/docs/mail/ngx_mail_smtp_module.xml
+++ b/xml/ru/docs/mail/ngx_mail_smtp_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_mail_smtp_module"
         link="/ru/docs/mail/ngx_mail_smtp_module.html"
         lang="ru"
-        rev="4">
+        rev="5">
 
 <section id="directives" name="Директивы">
 
@@ -69,8 +69,11 @@ SMTP-клиентов.
 Позволяет указать список расширений протокола SMTP,
 выдаваемый клиенту в ответе на команду
 <literal>EHLO</literal>.
-К этому списку автоматически добавляются
-методы аутентификации, указанные в директиве <link id="smtp_auth"/>.
+В зависимости от значения директивы
+<link doc="ngx_mail_ssl_module.xml" id="starttls"/>
+к этому списку автоматически добавляются
+методы аутентификации, указанные в директиве <link id="smtp_auth"/>, и
+<link url="https://tools.ietf.org/html/rfc3207">STARTTLS</link>.
 </para>
 
 <para>
diff --git a/xml/ru/docs/mail/ngx_mail_ssl_module.xml b/xml/ru/docs/mail/ngx_mail_ssl_module.xml
--- a/xml/ru/docs/mail/ngx_mail_ssl_module.xml
+++ b/xml/ru/docs/mail/ngx_mail_ssl_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_mail_ssl_module"
         link="/ru/docs/mail/ngx_mail_ssl_module.html"
         lang="ru"
-        rev="14">
+        rev="15">
 
 <section id="summary">
 
@@ -573,7 +573,7 @@ AES256 (для 80-байтных ключей, 1.11.8), либо AES128 (для 48-байтных ключей).
 <tag-name><literal>on</literal></tag-name>
 <tag-desc>
 разрешить использование команд <literal>STLS</literal> для POP3
-и <literal>STARTTLS</literal> для IMAP;
+и <literal>STARTTLS</literal> для IMAP и SMTP;
 </tag-desc>
 
 <tag-name><literal>off</literal></tag-name>