--- a/xml/en/docs/events.xml	Tue Aug 28 09:15:17 2012 +0000
+++ b/xml/en/docs/events.xml	Tue Aug 28 09:23:40 2012 +0000
@@ -77,7 +77,8 @@
 However, in Linux 2.6.6-mm2 this parameter is gone, and each process
 now has its own event queue.
 The size of each queue is limited by <literal>RLIMIT_SIGPENDING</literal>
-(see also <link doc="ngx_core_module.xml" id="worker_rlimit_sigpending"/>).
+and can be changed with
+<link doc="ngx_core_module.xml" id="worker_rlimit_sigpending"/>.
 </para>
 
 <para>

--- a/xml/en/docs/http/configuring_https_servers.xml	Tue Aug 28 09:15:17 2012 +0000
+++ b/xml/en/docs/http/configuring_https_servers.xml	Tue Aug 28 09:23:40 2012 +0000
@@ -15,9 +15,9 @@
 <section>
 
 <para>
-To configure an HTTPS server you must enable the SSL protocol
-in the server block, and specify the locations of the server certificate
-and private key files:
+To configure an HTTPS server, the SSL protocol must be enabled
+in the server block, and the locations of the server certificate
+and private key files should be specified:
 
 <programlisting>
 server {
@@ -79,7 +79,7 @@
 
 <para>
 SSL operations consume extra CPU resources.
-On multi-processor systems you should run several worker processes:
+On multi-processor systems several worker processes should be run,
 no less than the number of available CPU cores.
 The most CPU-intensive operation is the SSL handshake.
 There are two ways to minimize the number of these operations per client:
@@ -175,7 +175,7 @@
 may already have the required intermediate certificates and
 may not complain about a certificate sent without a chained bundle.
 To ensure the server sends the complete certificate chain,
-you may use the <command>openssl</command> command-line utility, for example:
+the <command>openssl</command> command-line utility may be used, for example:
 
 <programlisting>
 $ openssl s_client -connect www.godaddy.com:443
@@ -213,8 +213,8 @@
 </para>
 
 <para>
-If you have not added the certificates bundle, you will see only your server
-certificate #0.
+If a certificate bundle has not been added, only the server certificate #0
+will be shown.
 </para>
 
 </section>
@@ -223,13 +223,8 @@
 <section id="single_http_https_server" name="A single HTTP/HTTPS server">
 
 <para>
-It is good practice to configure separate servers for HTTP and HTTPS
-protocols from the very start. Although their functionalities currently
-seem equal, this may change significantly in the future
-and using a consolidated server may become problematic.
-However, if HTTP and HTTPS servers are equal,
-and you prefer not to think about the future,
-you may configure a single server that handles both HTTP and HTTPS requests
+If HTTP and HTTPS servers are equal,
+a single server that handles both HTTP and HTTPS requests may be configured
 by deleting the directive “<literal>ssl on</literal>”
 and adding the <literal>ssl</literal> parameter for *:443 port:
 

--- a/xml/en/docs/http/ngx_http_core_module.xml	Tue Aug 28 09:15:17 2012 +0000
+++ b/xml/en/docs/http/ngx_http_core_module.xml	Tue Aug 28 09:23:40 2012 +0000
@@ -418,7 +418,8 @@
 
 <para>
 Defines a default MIME-type of a response.
-See also the <link id="types"/> directive.
+Mapping of file name extensions to MIME types can be set
+with the <link id="types"/> directive.
 </para>
 
 </directive>
@@ -1771,7 +1772,8 @@
 </para>
 
 <para>
-See also the <link id="server_name_in_redirect"/> directive.
+The use of a primary server name in redirects is controlled by
+the <link id="server_name_in_redirect"/> directive.
 </para>
 
 </directive>
@@ -2254,7 +2256,7 @@
 </para>
 
 <para>
-For more information, please refer to the
+Detailed description of server names is provided in a separate
 <link doc="server_names.xml"/> document.
 </para>
 
@@ -2278,7 +2280,8 @@
 </para>
 
 <para>
-See also the <link id="port_in_redirect"/> directive.
+The use of a port in redirects is controlled by
+the <link id="port_in_redirect"/> directive.
 </para>
 
 </directive>
@@ -2292,8 +2295,8 @@
 <para>
 Sets the bucket size for the server names hash tables.
 Default value depends on the size of the processor’s cache line.
-For more information, please refer to
-<link doc="../hash.xml">Setting Up Hashes</link>.
+Details of setting up hash tables are provided in a separate
+<link doc="../hash.xml">document</link>.
 </para>
 
 </directive>
@@ -2306,8 +2309,8 @@
 
 <para>
 Sets the maximum <value>size</value> of the server names hash tables.
-For more information, please refer to
-<link doc="../hash.xml">Setting Up Hashes</link>.
+Details of setting up hash tables are provided in a separate
+<link doc="../hash.xml">document</link>.
 </para>
 
 </directive>
@@ -2404,7 +2407,7 @@
 }
 </example>
 The last parameter can also point to a named location,
-see examples below.
+as shown in examples below.
 As of version 0.7.51, the last parameter can also be a
 <value>code</value>:
 <example>
@@ -2569,8 +2572,8 @@
 <para>
 Sets the bucket size for the types hash tables.
 Default value depends on the size of the processor’s cache line.
-For more information, please refer to
-<link doc="../hash.xml">Setting Up Hashes</link>.
+Details of setting up hash tables are provided in a separate
+<link doc="../hash.xml">document</link>.
 </para>
 
 </directive>
@@ -2585,8 +2588,8 @@
 
 <para>
 Sets the maximum <value>size</value> of the types hash tables.
-For more information, please refer to
-<link doc="../hash.xml">Setting Up Hashes</link>.
+Details of setting up hash tables are provided in a separate
+<link doc="../hash.xml">document</link>.
 </para>
 
 </directive>
@@ -2622,8 +2625,8 @@
 
 <para>
 Sets the bucket size for the variables hash table.
-For more information, please refer to
-<link doc="../hash.xml">Setting Up Hashes</link>.
+Details of setting up hash tables are provided in a separate
+<link doc="../hash.xml">document</link>.
 </para>
 
 </directive>
@@ -2636,8 +2639,8 @@
 
 <para>
 Sets the maximum <value>size</value> of the variables hash table.
-For more information, please refer to
-<link doc="../hash.xml">Setting Up Hashes</link>.
+Details of setting up hash tables are provided in a separate
+<link doc="../hash.xml">document</link>.
 </para>
 
 </directive>

--- a/xml/en/docs/http/ngx_http_map_module.xml	Tue Aug 28 09:15:17 2012 +0000
+++ b/xml/en/docs/http/ngx_http_map_module.xml	Tue Aug 28 09:23:40 2012 +0000
@@ -88,7 +88,7 @@
 
 <para>
 If a source value matches one of the names of special parameters
-(see below), it should be prefixed with the “<literal>\</literal>” symbol.
+described below, it should be prefixed with the “<literal>\</literal>” symbol.
 </para>
 
 <para>
@@ -179,8 +179,8 @@
 <para>
 Sets the bucket size for the <link id="map"/> variables hash tables.
 Default value depends on the size of the processor’s cache line.
-For more information, please refer to
-<link doc="../hash.xml">Setting Up Hashes</link>.
+Details of setting up hash tables are provided in a separate
+<link doc="../hash.xml">document</link>.
 </para>
 
 </directive>
@@ -194,8 +194,8 @@
 <para>
 Sets the maximum <value>size</value> of the <link id="map"/> variables
 hash tables.
-For more information, please refer to
-<link doc="../hash.xml">Setting Up Hashes</link>.
+Details of setting up hash tables are provided in a separate
+<link doc="../hash.xml">document</link>.
 </para>
 
 </directive>

--- a/xml/en/docs/http/ngx_http_mp4_module.xml	Tue Aug 28 09:15:17 2012 +0000
+++ b/xml/en/docs/http/ngx_http_mp4_module.xml	Tue Aug 28 09:23:40 2012 +0000
@@ -82,7 +82,7 @@
 <literal>--with-http_mp4_module</literal>
 configuration parameter.
 <note>
-If you were using the third-party mp4 module, be sure to disable it.
+If a third-party mp4 module was previously used, it needs to be disabled.
 </note>
 </para>
 

--- a/xml/en/docs/http/ngx_http_referer_module.xml	Tue Aug 28 09:15:17 2012 +0000
+++ b/xml/en/docs/http/ngx_http_referer_module.xml	Tue Aug 28 09:23:40 2012 +0000
@@ -57,8 +57,8 @@
 
 <para>
 Sets the bucket size for the valid referers hash tables.
-For more information, please refer to
-<link doc="../hash.xml">Setting Up Hashes</link>.
+Details of setting up hash tables are provided in a separate
+<link doc="../hash.xml">document</link>.
 </para>
 
 </directive>
@@ -73,8 +73,8 @@
 
 <para>
 Sets the maximum <value>size</value> of the valid referers hash tables.
-For more information, please refer to
-<link doc="../hash.xml">Setting Up Hashes</link>.
+Details of setting up hash tables are provided in a separate
+<link doc="../hash.xml">document</link>.
 </para>
 
 </directive>

--- a/xml/en/docs/http/server_names.xml	Tue Aug 28 09:15:17 2012 +0000
+++ b/xml/en/docs/http/server_names.xml	Tue Aug 28 09:23:40 2012 +0000
@@ -327,7 +327,8 @@
 in three hash tables bound to the listen ports.
 The sizes of hash tables are optimized at the configuration phase
 so that a name can be found with the fewest CPU cache misses.
-See also “<link doc="../hash.xml"/>”.
+Details of setting up hash tables are provided in a separate
+<link doc="../hash.xml">document</link>.
 </para>
 
 <para>

--- a/xml/en/docs/install.xml	Tue Aug 28 09:15:17 2012 +0000
+++ b/xml/en/docs/install.xml	Tue Aug 28 09:23:40 2012 +0000
@@ -195,8 +195,8 @@
 <listitem>
 <para>
 <literal>--with-pcre-jit</literal>&mdash;builds the PCRE library with
-“just-in-time compilation” support (1.1.12, see
-<link doc="ngx_core_module.xml" id="pcre_jit"/>).
+“just-in-time compilation” support (1.1.12, the
+<link doc="ngx_core_module.xml" id="pcre_jit"/> directive).
 </para>
 </listitem>
 

--- a/xml/en/docs/ngx_core_module.xml	Tue Aug 28 09:15:17 2012 +0000
+++ b/xml/en/docs/ngx_core_module.xml	Tue Aug 28 09:23:40 2012 +0000
@@ -478,7 +478,7 @@
 not only connections with clients.
 Another consideration is that the actual number of simultaneous
 connections may not exceed the current limit on
-the maximum number of open files, see
+the maximum number of open files that can be changed by
 <link id="worker_rlimit_nofile"/>.
 </para>
 

--- a/xml/en/support.xml	Tue Aug 28 09:15:17 2012 +0000
+++ b/xml/en/support.xml	Tue Aug 28 09:23:40 2012 +0000
@@ -29,14 +29,12 @@
 <section name="Mailing Lists">
 
 <para>
-You can
+Mailing lists can be
 <link url="http://nginx.org/mailman/listinfo">
-browse</link>
-the mailing lists.
-To post to a mailing list, you must first
-<link url="http://nginx.org/mailman/listinfo">
-subscribe</link>
-an e-mail address that you will use for posting.
+browsed</link>.
+To post to a mailing list,
+an e-mail address that will be used for posting must first be
+<link url="http://nginx.org/mailman/listinfo">subscribed</link>.
 </para>
 
 <para>
@@ -123,8 +121,7 @@
 <section name="Commercial Support">
 
 <para>
-If you’re looking for a commercial support option
-please refer to the
+For a commercial support option please refer to the
 <link url="http://nginx.com/support.html">
 support page on our nginx.com web site</link>.
 </para>

--- a/xml/ru/docs/events.xml	Tue Aug 28 09:15:17 2012 +0000
+++ b/xml/ru/docs/events.xml	Tue Aug 28 09:23:40 2012 +0000
@@ -77,7 +77,8 @@
 Однако, начиная с Linux 2.6.6-mm2, этого параметра уже нет и для каждого
 процесса существует отдельная очередь сигналов, размер которой
 ограничивается с помощью <literal>RLIMIT_SIGPENDING</literal>
-(см. также <link doc="ngx_core_module.xml" id="worker_rlimit_sigpending"/>).
+и может быть изменён с помощью
+<link doc="ngx_core_module.xml" id="worker_rlimit_sigpending"/>.
 </para>
 
 <para>

--- a/xml/ru/docs/http/configuring_https_servers.xml	Tue Aug 28 09:15:17 2012 +0000
+++ b/xml/ru/docs/http/configuring_https_servers.xml	Tue Aug 28 09:23:40 2012 +0000
@@ -223,13 +223,8 @@
 <section id="single_http_https_server" name="Единый HTTP/HTTPS сервер">
 
 <para>
-На практике рекомендуется с самого начала настраивать отдельные серверы
-для протоколов HTTP и HTTPS.
-И хотя сегодня их функциональность может казаться идентичной, в будущем
-это может измениться и использование консолидированного сервера может
-стать проблематичным.
-Однако, если серверы HTTP и HTTPS идентичны, и думать о будущем не
-хочется, можно настроить единый сервер, который обслуживает
+Если серверы HTTP и HTTPS идентичны,
+можно настроить единый сервер, который обслуживает
 как HTTP-, так и HTTPS-запросы.
 Для этого следует исключить директиву “<literal>ssl on</literal>”
 и добавить параметр <literal>ssl</literal> к порту *:443:

--- a/xml/ru/docs/http/ngx_http_core_module.xml	Tue Aug 28 09:15:17 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_core_module.xml	Tue Aug 28 09:23:40 2012 +0000
@@ -408,7 +408,8 @@
 
 <para>
 Задаёт MIME-тип ответов по умолчанию.
-См. также директиву <link id="types"/>.
+Соответствие расширений имён файлов MIME-типу ответов задаётся
+с помощью директивы <link id="types"/>.
 </para>
 
 </directive>
@@ -1756,7 +1757,8 @@
 </para>
 
 <para>
-См. также директиву <link id="server_name_in_redirect"/>.
+Использование в перенаправлениях основного имени сервера управляется
+директивой <link id="server_name_in_redirect"/>.
 </para>
 
 </directive>
@@ -2241,8 +2243,8 @@
 </para>
 
 <para>
-Подробнее смотрите в документе, описывающем
-<link doc="server_names.xml">имена серверов</link>.
+Подробнее имена серверов обсуждаются в отдельном
+<link doc="server_names.xml">документе</link>.
 </para>
 
 </directive>
@@ -2265,7 +2267,8 @@
 </para>
 
 <para>
-См. также директиву <link id="port_in_redirect"/>.
+Использование в перенаправлениях порта управляется
+директивой <link id="port_in_redirect"/>.
 </para>
 
 </directive>
@@ -2279,8 +2282,8 @@
 <para>
 Задаёт размер корзины в хэш-таблицах имён серверов.
 Значение по умолчанию зависит от размера строки кэша процессора.
-Подробнее смотрите в документе по
-<link doc="../hash.xml">настройке хэшей</link>.
+Подробнее настройка хэш-таблиц обсуждается в отдельном
+<link doc="../hash.xml">документе</link>.
 </para>
 
 </directive>
@@ -2293,8 +2296,8 @@
 
 <para>
 Задаёт максимальный <value>размер</value> хэш-таблиц имён серверов.
-Подробнее смотрите в документе по
-<link doc="../hash.xml">настройке хэшей</link>.
+Подробнее настройка хэш-таблиц обсуждается в отдельном
+<link doc="../hash.xml">документе</link>.
 </para>
 
 </directive>
@@ -2389,7 +2392,7 @@
 }
 </example>
 Последний параметр может также указывать на именованный location,
-смотрите примеры ниже.
+как в примерах ниже.
 С версии 0.7.51 последний параметр может также быть кодом:
 <example>
 location / {
@@ -2553,8 +2556,8 @@
 <para>
 Задаёт размер корзины в хэш-таблицах типов.
 Значение по умолчанию зависит от размера строки кэша процессора.
-Подробнее смотрите в документе по
-<link doc="../hash.xml">настройке хэшей</link>.
+Подробнее настройка хэш-таблиц обсуждается в отдельном
+<link doc="../hash.xml">документе</link>.
 </para>
 
 </directive>
@@ -2569,8 +2572,8 @@
 
 <para>
 Задаёт максимальный <value>размер</value> хэш-таблиц типов.
-Подробнее смотрите в документе по
-<link doc="../hash.xml">настройке хэшей</link>.
+Подробнее настройка хэш-таблиц обсуждается в отдельном
+<link doc="../hash.xml">документе</link>.
 </para>
 
 </directive>
@@ -2607,8 +2610,8 @@
 
 <para>
 Задаёт размер корзины в хэш-таблице переменных.
-Подробнее смотрите в документе по
-<link doc="../hash.xml">настройке хэшей</link>.
+Подробнее настройка хэш-таблиц обсуждается в отдельном
+<link doc="../hash.xml">документе</link>.
 </para>
 
 </directive>
@@ -2621,8 +2624,8 @@
 
 <para>
 Задаёт максимальный <value>размер</value> хэш-таблицы переменных.
-Подробнее смотрите в документе по
-<link doc="../hash.xml">настройке хэшей</link>.
+Подробнее настройка хэш-таблиц обсуждается в отдельном
+<link doc="../hash.xml">документе</link>.
 </para>
 
 </directive>

--- a/xml/ru/docs/http/ngx_http_map_module.xml	Tue Aug 28 09:15:17 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_map_module.xml	Tue Aug 28 09:23:40 2012 +0000
@@ -87,8 +87,8 @@
 </para>
 
 <para>
-Если исходное значение совпадает с именем одного из специальных параметров
-(см. ниже), перед ним следует поставить символ “<literal>\</literal>”.
+Если исходное значение совпадает с именем одного из специальных параметров,
+описанных ниже, перед ним следует поставить символ “<literal>\</literal>”.
 </para>
 
 <para>
@@ -179,8 +179,8 @@
 <para>
 Задаёт размер корзины в хэш-таблицах для переменных <link id="map"/>.
 Значение по умолчанию зависит от размера строки кэша процессора.
-Подробнее смотрите в документе по
-<link doc="../hash.xml">настройке хэшей</link>.
+Подробнее настройка хэш-таблиц обсуждается в отдельном
+<link doc="../hash.xml">документе</link>.
 </para>
 
 </directive>
@@ -193,8 +193,8 @@
 
 <para>
 Задаёт максимальный размер хэш-таблиц для переменных <link id="map"/>.
-Подробнее смотрите в документе по
-<link doc="../hash.xml">настройке хэшей</link>.
+Подробнее настройка хэш-таблиц обсуждается в отдельном
+<link doc="../hash.xml">документе</link>.
 </para>
 
 </directive>

--- a/xml/ru/docs/http/ngx_http_mp4_module.xml	Tue Aug 28 09:15:17 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_mp4_module.xml	Tue Aug 28 09:23:40 2012 +0000
@@ -84,7 +84,7 @@
 разрешить с помощью конфигурационного параметра
 <literal>--with-http_mp4_module</literal>.
 <note>
-Если вы ранее использовали сторонний модуль mp4, не забудьте его отключить.
+Если ранее использовался сторонний модуль mp4, следует его отключить.
 </note>
 </para>
 

--- a/xml/ru/docs/http/ngx_http_referer_module.xml	Tue Aug 28 09:15:17 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_referer_module.xml	Tue Aug 28 09:23:40 2012 +0000
@@ -58,8 +58,8 @@
 
 <para>
 Задаёт размер корзины хэш-таблиц со значениями <header>Referer</header>.
-Подробнее смотрите в документе по
-<link doc="../hash.xml">настройке хэшей</link>.
+Подробнее настройка хэш-таблиц обсуждается в отдельном
+<link doc="../hash.xml">документе</link>.
 </para>
 
 </directive>
@@ -75,8 +75,8 @@
 <para>
 Задаёт максимальный <value>размер</value> хэш-таблиц со значениями
 <header>Referer</header>.
-Подробнее смотрите в документе по
-<link doc="../hash.xml">настройке хэшей</link>.
+Подробнее настройка хэш-таблиц обсуждается в отдельном
+<link doc="../hash.xml">документе</link>.
 </para>
 
 </directive>

--- a/xml/ru/docs/http/server_names.xml	Tue Aug 28 09:15:17 2012 +0000
+++ b/xml/ru/docs/http/server_names.xml	Tue Aug 28 09:23:40 2012 +0000
@@ -332,7 +332,8 @@
 в трёх хэш-таблицах, привязанных к слушающим портам.
 Размеры хэш-таблиц оптимизируются на фазе конфигурации таким образом,
 что имя может быть найдено с минимальным числом непопаданий в кэш процессора.
-См. также “<link doc="../hash.xml"/>”.
+Подробнее настройка хэш-таблиц обсуждается в отдельном
+<link doc="../hash.xml">документе</link>.
 </para>
 
 <para>

--- a/xml/ru/docs/install.xml	Tue Aug 28 09:15:17 2012 +0000
+++ b/xml/ru/docs/install.xml	Tue Aug 28 09:23:40 2012 +0000
@@ -189,7 +189,7 @@
 <listitem>
 <para>
 <literal>--with-pcre-jit</literal>&mdash;собирает библиотеку PCRE с
-поддержкой JIT-компиляции (1.1.12, см.
+поддержкой JIT-компиляции (1.1.12, директива
 <link doc="ngx_core_module.xml" id="pcre_jit"/>).
 </para>
 </listitem>

--- a/xml/ru/docs/mail/ngx_mail_auth_http_module.xml	Tue Aug 28 09:15:17 2012 +0000
+++ b/xml/ru/docs/mail/ngx_mail_auth_http_module.xml	Tue Aug 28 09:23:40 2012 +0000
@@ -105,8 +105,8 @@
 В текущей реализации на каждую попытку аутентификации выделяется память,
 которая освобождается только при завершении сессии.
 Поэтому число неудачных попыток аутентификации в рамках одной сессии
-должно быть ограничено — после 10-20 попыток (см. заголовок
-<header>Auth-Login-Attempt</header>) сервер должен выдать ответ
+должно быть ограничено — после 10-20 попыток (номер попытки передаётся
+в заголовке <header>Auth-Login-Attempt</header>) сервер должен выдать ответ
 без заголовка <header>Auth-Wait</header>.
 </para>
 

--- a/xml/ru/docs/ngx_core_module.xml	Tue Aug 28 09:15:17 2012 +0000
+++ b/xml/ru/docs/ngx_core_module.xml	Tue Aug 28 09:23:40 2012 +0000
@@ -476,7 +476,7 @@
 Стоит также учитывать, что фактическое число одновременных
 соединений не может превышать действующего ограничения на
 максимальное число открытых файлов,
-см. <link id="worker_rlimit_nofile"/>.
+которое можно изменить с помощью <link id="worker_rlimit_nofile"/>.
 </para>
 
 </directive>

--- a/xml/ru/support.xml	Tue Aug 28 09:15:17 2012 +0000
+++ b/xml/ru/support.xml	Tue Aug 28 09:23:40 2012 +0000
@@ -29,14 +29,12 @@
 <section name="Списки рассылок">
 
 <para>
-Вы можете
-<link url="http://nginx.org/mailman/listinfo">
-просматривать</link>
+Можно
+<link url="http://nginx.org/mailman/listinfo">просматривать</link>
 списки рассылок.
 Чтобы написать в список, необходимо вначале
-<link url="http://nginx.org/mailman/listinfo">
-подписать</link>
-свой почтовый адрес, который будет использоваться для отправки сообщений.
+<link url="http://nginx.org/mailman/listinfo">подписать</link>
+почтовый адрес, который будет использоваться для отправки сообщений.
 </para>
 
 <para>