# HG changeset patch
# User Yaroslav Zhuravlev <yar@nginx.com>
# Date 1508759301 -10800
# Node ID 3d9e7993c201d24a8a09d3eca794e8a53346c41d
# Parent  014323d0cc38f6d45ae06d2f9466a25e734afc5a
Added links to directives in the example of ssl modules.

diff -r 014323d0cc38 -r 3d9e7993c201 xml/en/docs/http/ngx_http_ssl_module.xml
--- a/xml/en/docs/http/ngx_http_ssl_module.xml	Tue Oct 24 18:14:43 2017 +0300
+++ b/xml/en/docs/http/ngx_http_ssl_module.xml	Mon Oct 23 14:48:21 2017 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_ssl_module"
         link="/en/docs/http/ngx_http_ssl_module.html"
         lang="en"
-        rev="36">
+        rev="37">
 
 <section id="summary">
 
@@ -39,23 +39,28 @@
 <list type="bullet">
 
 <listitem>
-set the number of worker processes equal to the number of processors,
-</listitem>
-
-<listitem>
-enable keep-alive connections,
+set the number of
+<link doc="../ngx_core_module.xml" id="worker_processes">worker processes</link>
+equal to the number of processors,
 </listitem>
 
 <listitem>
-enable the shared session cache,
+enable
+<link doc="ngx_http_core_module.xml" id="keepalive_timeout">keep-alive</link>
+connections,
 </listitem>
 
 <listitem>
-disable the built-in session cache,
+enable the <link id="ssl_session_cache_shared">shared</link> session cache,
 </listitem>
 
 <listitem>
-and possibly increase the session lifetime (by default, 5 minutes):
+disable the <link id="ssl_session_cache_builtin">built-in</link> session cache,
+</listitem>
+
+<listitem>
+and possibly increase the session <link id="ssl_session_timeout">lifetime</link>
+(by default, 5 minutes):
 </listitem>
 
 </list>
@@ -430,7 +435,7 @@
 actually store session parameters in the cache.
 </tag-desc>
 
-<tag-name><literal>builtin</literal></tag-name>
+<tag-name id="ssl_session_cache_builtin"><literal>builtin</literal></tag-name>
 <tag-desc>
 a cache built in OpenSSL; used by one worker process only.
 The cache size is specified in sessions.
@@ -438,7 +443,7 @@
 Use of the built-in cache can cause memory fragmentation.
 </tag-desc>
 
-<tag-name><literal>shared</literal></tag-name>
+<tag-name id="ssl_session_cache_shared"><literal>shared</literal></tag-name>
 <tag-desc>
 a cache shared between all worker processes.
 The cache size is specified in bytes; one megabyte can store
diff -r 014323d0cc38 -r 3d9e7993c201 xml/en/docs/mail/ngx_mail_ssl_module.xml
--- a/xml/en/docs/mail/ngx_mail_ssl_module.xml	Tue Oct 24 18:14:43 2017 +0300
+++ b/xml/en/docs/mail/ngx_mail_ssl_module.xml	Mon Oct 23 14:48:21 2017 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_mail_ssl_module"
         link="/en/docs/mail/ngx_mail_ssl_module.html"
         lang="en"
-        rev="16">
+        rev="17">
 
 <section id="summary">
 
@@ -39,19 +39,22 @@
 <list type="bullet">
 
 <listitem>
-set the number of worker processes equal to the number of processors,
+set the number of
+<link doc="../ngx_core_module.xml" id="worker_processes">worker processes</link>
+equal to the number of processors,
 </listitem>
 
 <listitem>
-enable the shared session cache,
+enable the <link id="ssl_session_cache_shared">shared</link> session cache,
 </listitem>
 
 <listitem>
-disable the built-in session cache,
+disable the <link id="ssl_session_cache_builtin">built-in</link> session cache,
 </listitem>
 
 <listitem>
-and possibly increase the session lifetime (by default, 5 minutes):
+and possibly increase the session <link id="ssl_session_timeout">lifetime</link>
+(by default, 5 minutes):
 </listitem>
 
 </list>
@@ -387,7 +390,7 @@
 actually store session parameters in the cache.
 </tag-desc>
 
-<tag-name><literal>builtin</literal></tag-name>
+<tag-name id="ssl_session_cache_builtin"><literal>builtin</literal></tag-name>
 <tag-desc>
 a cache built in OpenSSL; used by one worker process only.
 The cache size is specified in sessions.
@@ -395,7 +398,7 @@
 Use of the built-in cache can cause memory fragmentation.
 </tag-desc>
 
-<tag-name><literal>shared</literal></tag-name>
+<tag-name id="ssl_session_cache_shared"><literal>shared</literal></tag-name>
 <tag-desc>
 a cache shared between all worker processes.
 The cache size is specified in bytes; one megabyte can store
diff -r 014323d0cc38 -r 3d9e7993c201 xml/en/docs/stream/ngx_stream_ssl_module.xml
--- a/xml/en/docs/stream/ngx_stream_ssl_module.xml	Tue Oct 24 18:14:43 2017 +0300
+++ b/xml/en/docs/stream/ngx_stream_ssl_module.xml	Mon Oct 23 14:48:21 2017 +0300
@@ -9,7 +9,7 @@
 <module name="Module ngx_stream_ssl_module"
         link="/en/docs/stream/ngx_stream_ssl_module.html"
         lang="en"
-        rev="17">
+        rev="18">
 
 <section id="summary">
 
@@ -32,19 +32,22 @@
 <list type="bullet">
 
 <listitem>
-set the number of worker processes equal to the number of processors,
+set the number of
+<link doc="../ngx_core_module.xml" id="worker_processes">worker processes</link>
+equal to the number of processors,
 </listitem>
 
 <listitem>
-enable the shared session cache,
+enable the <link id="ssl_session_cache_shared">shared</link> session cache,
 </listitem>
 
 <listitem>
-disable the built-in session cache,
+disable the <link id="ssl_session_cache_builtin">built-in</link> session cache,
 </listitem>
 
 <listitem>
-and possibly increase the session lifetime (by default, 5 minutes):
+and possibly increase the session <link id="ssl_session_timeout">lifetime</link>
+(by default, 5 minutes):
 </listitem>
 
 </list>
@@ -368,7 +371,7 @@
 actually store session parameters in the cache.
 </tag-desc>
 
-<tag-name><literal>builtin</literal></tag-name>
+<tag-name id="ssl_session_cache_builtin"><literal>builtin</literal></tag-name>
 <tag-desc>
 a cache built in OpenSSL; used by one worker process only.
 The cache size is specified in sessions.
@@ -376,7 +379,7 @@
 Use of the built-in cache can cause memory fragmentation.
 </tag-desc>
 
-<tag-name><literal>shared</literal></tag-name>
+<tag-name id="ssl_session_cache_shared"><literal>shared</literal></tag-name>
 <tag-desc>
 a cache shared between all worker processes.
 The cache size is specified in bytes; one megabyte can store
diff -r 014323d0cc38 -r 3d9e7993c201 xml/ru/docs/http/ngx_http_ssl_module.xml
--- a/xml/ru/docs/http/ngx_http_ssl_module.xml	Tue Oct 24 18:14:43 2017 +0300
+++ b/xml/ru/docs/http/ngx_http_ssl_module.xml	Mon Oct 23 14:48:21 2017 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_ssl_module"
         link="/ru/docs/http/ngx_http_ssl_module.html"
         lang="ru"
-        rev="36">
+        rev="37">
 
 <section id="summary">
 
@@ -39,23 +39,28 @@
 <list type="bullet">
 
 <listitem>
-установить число рабочих процессов равным числу процессоров,
-</listitem>
-
-<listitem>
-разрешить keep-alive соединения,
+установить число
+<link doc="../ngx_core_module.xml" id="worker_processes">рабочих процессов</link>
+равным числу процессоров,
 </listitem>
 
 <listitem>
-включить разделяемый кэш сессий,
+разрешить
+<link doc="ngx_http_core_module.xml" id="keepalive_timeout">keep-alive</link>
+соединения,
 </listitem>
 
 <listitem>
-выключить встроенный кэш сессий
+включить <link id="ssl_session_cache_shared">разделяемый</link> кэш сессий,
 </listitem>
 
 <listitem>
-и, возможно, увеличить время жизни сессии (по умолчанию 5 минут):
+выключить <link id="ssl_session_cache_builtin">встроенный</link> кэш сессий
+</listitem>
+
+<listitem>
+и, возможно, увеличить <link id="ssl_session_timeout">время жизни</link> сессии
+(по умолчанию 5 минут):
 </listitem>
 
 </list>
@@ -432,7 +437,7 @@
 на самом деле не хранит параметры сессии в кэше.
 </tag-desc>
 
-<tag-name><literal>builtin</literal></tag-name>
+<tag-name id="ssl_session_cache_builtin"><literal>builtin</literal></tag-name>
 <tag-desc>
 встроенный в OpenSSL кэш, используется в рамках только одного рабочего процесса.
 Размер кэша задаётся в сессиях.
@@ -440,7 +445,7 @@
 Использование встроенного кэша может вести к фрагментации памяти.
 </tag-desc>
 
-<tag-name><literal>shared</literal></tag-name>
+<tag-name id="ssl_session_cache_shared"><literal>shared</literal></tag-name>
 <tag-desc>
 кэш, разделяемый между всеми рабочими процессами.
 Размер кэша задаётся в байтах, в 1 мегабайт может поместиться
diff -r 014323d0cc38 -r 3d9e7993c201 xml/ru/docs/mail/ngx_mail_ssl_module.xml
--- a/xml/ru/docs/mail/ngx_mail_ssl_module.xml	Tue Oct 24 18:14:43 2017 +0300
+++ b/xml/ru/docs/mail/ngx_mail_ssl_module.xml	Mon Oct 23 14:48:21 2017 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_mail_ssl_module"
         link="/ru/docs/mail/ngx_mail_ssl_module.html"
         lang="ru"
-        rev="16">
+        rev="17">
 
 <section id="summary">
 
@@ -39,19 +39,22 @@
 <list type="bullet">
 
 <listitem>
-установить число рабочих процессов равным числу процессоров,
+установить число
+<link doc="../ngx_core_module.xml" id="worker_processes">рабочих процессов</link>
+равным числу процессоров,
 </listitem>
 
 <listitem>
-включить разделяемый кэш сессий,
+включить <link id="ssl_session_cache_shared">разделяемый</link> кэш сессий,
 </listitem>
 
 <listitem>
-выключить встроенный кэш сессий
+выключить <link id="ssl_session_cache_builtin">встроенный</link> кэш сессий
 </listitem>
 
 <listitem>
-и, возможно, увеличить время жизни сессии (по умолчанию 5 минут):
+и, возможно, увеличить <link id="ssl_session_timeout">время жизни</link> сессии
+(по умолчанию 5 минут):
 </listitem>
 
 </list>
@@ -387,7 +390,7 @@
 на самом деле не хранит параметры сессии в кэше.
 </tag-desc>
 
-<tag-name><literal>builtin</literal></tag-name>
+<tag-name id="ssl_session_cache_builtin"><literal>builtin</literal></tag-name>
 <tag-desc>
 встроенный в OpenSSL кэш, используется в рамках только одного рабочего процесса.
 Размер кэша задаётся в сессиях.
@@ -395,7 +398,7 @@
 Использование встроенного кэша может вести к фрагментации памяти.
 </tag-desc>
 
-<tag-name><literal>shared</literal></tag-name>
+<tag-name id="ssl_session_cache_shared"><literal>shared</literal></tag-name>
 <tag-desc>
 кэш, разделяемый между всеми рабочими процессами.
 Размер кэша задаётся в байтах, в 1 мегабайт может поместиться
diff -r 014323d0cc38 -r 3d9e7993c201 xml/ru/docs/stream/ngx_stream_ssl_module.xml
--- a/xml/ru/docs/stream/ngx_stream_ssl_module.xml	Tue Oct 24 18:14:43 2017 +0300
+++ b/xml/ru/docs/stream/ngx_stream_ssl_module.xml	Mon Oct 23 14:48:21 2017 +0300
@@ -9,7 +9,7 @@
 <module name="Модуль ngx_stream_ssl_module"
         link="/ru/docs/stream/ngx_stream_ssl_module.html"
         lang="ru"
-        rev="17">
+        rev="18">
 
 <section id="summary">
 
@@ -32,19 +32,22 @@
 <list type="bullet">
 
 <listitem>
-установить число рабочих процессов равным числу процессоров,
+установить число
+<link doc="../ngx_core_module.xml" id="worker_processes">рабочих процессов</link>
+равным числу процессоров,
 </listitem>
 
 <listitem>
-включить разделяемый кэш сессий,
+включить <link id="ssl_session_cache_shared">разделяемый</link> кэш сессий,
 </listitem>
 
 <listitem>
-выключить встроенный кэш сессий
+выключить <link id="ssl_session_cache_builtin">встроенный</link> кэш сессий
 </listitem>
 
 <listitem>
-и, возможно, увеличить время жизни сессии (по умолчанию 5 минут):
+и, возможно, увеличить <link id="ssl_session_timeout">время жизни</link> сессии
+(по умолчанию 5 минут):
 </listitem>
 
 </list>
@@ -368,7 +371,7 @@
 на самом деле не хранит параметры сессии в кэше.
 </tag-desc>
 
-<tag-name><literal>builtin</literal></tag-name>
+<tag-name id="ssl_session_cache_builtin"><literal>builtin</literal></tag-name>
 <tag-desc>
 встроенный в OpenSSL кэш, используется в рамках только одного рабочего процесса.
 Размер кэша задаётся в сессиях.
@@ -376,7 +379,7 @@
 Использование встроенного кэша может вести к фрагментации памяти.
 </tag-desc>
 
-<tag-name><literal>shared</literal></tag-name>
+<tag-name id="ssl_session_cache_shared"><literal>shared</literal></tag-name>
 <tag-desc>
 кэш, разделяемый между всеми рабочими процессами.
 Размер кэша задаётся в байтах, в 1 мегабайт может поместиться