Mercurial > hg > nginx-site
changeset 659:77a3314c74a7
Avoid the uses of second person.
line wrap: on
line diff
--- 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>—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>—собирает библиотеку 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>