Mercurial > hg > nginx-site
diff xml/ru/docs/http/ngx_http_log_module.xml @ 271:4c6d2c614d2c
Cleaned up XML tag mess:
- all of <parameter> and <code>, and some of <dirname>, <value>,
and <command> were replaced by <literal>;
- the rest of <dirname> were replaced by links;
- <argument> were replaced by <value>;
- <value> is now rendered in HTML in italic;
- <literal> and <path> can now contain <value>.
Cleaned up terminology mess:
- directives take "parameters".
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Fri, 23 Dec 2011 17:29:59 +0000 |
parents | 945d7299c26c |
children | 457c54242cfa |
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_log_module.xml +++ b/xml/ru/docs/http/ngx_http_log_module.xml @@ -9,7 +9,7 @@ <section id="summary"> <para> -Модуль <code>ngx_http_log_module</code> записывает логи запросов +Модуль <literal>ngx_http_log_module</literal> записывает логи запросов в указанном формате. </para> @@ -35,10 +35,10 @@ <directive name="access_log"> <syntax> - <argument>путь</argument> - [<argument>формат</argument> - [<parameter>buffer</parameter>=<argument>размер</argument>]]</syntax> -<syntax><value>off</value></syntax> + <value>путь</value> + [<value>формат</value> + [<literal>buffer</literal>=<value>размер</value>]]</syntax> +<syntax><literal>off</literal></syntax> <default>log/access.log combined</default> <context>http</context> <context>server</context> @@ -49,10 +49,10 @@ <para> Задаёт путь, формат и размер буфера для буферизованной записи в лог. На одном уровне может использоваться несколько логов. -Специальное значение <value>off</value> отменяет все директивы -<code>access_log</code> для текущего уровня. +Специальное значение <literal>off</literal> отменяет все директивы +<literal>access_log</literal> для текущего уровня. Если формат не указан, то используется предопределённый формат -“<code>combined</code>”. +“<literal>combined</literal>”. </para> <para> @@ -80,7 +80,7 @@ Следует однако иметь в виду, что поскольку дескрипторы часто используемых файлов могут храниться в <link id="open_log_file_cache">кэше</link>, то при вращении логов в течение времени, заданного параметром -<parameter>valid</parameter> директивы <link id="open_log_file_cache"/>, +<literal>valid</literal> директивы <link id="open_log_file_cache"/>, запись может продолжаться в старый файл. </listitem> @@ -89,7 +89,7 @@ <link doc="ngx_http_core_module.xml" id="root">корневого каталога</link> для запроса — если этот каталог не существует, то лог не создаётся. Поэтому <link doc="ngx_http_core_module.xml" id="root"/> -и <code>access_log</code> нужно описывать на одном уровне: +и <literal>access_log</literal> нужно описывать на одном уровне: <example> server { root /spool/vhost/data/$host; @@ -106,8 +106,8 @@ server { <directive name="log_format"> <syntax> - <argument>название</argument> - <argument>строка</argument> ...</syntax> + <value>название</value> + <value>строка</value> ...</syntax> <default>combined "..."</default> <context>http</context> @@ -123,8 +123,8 @@ server { <tag-name><var>$body_bytes_sent</var></tag-name> <tag-desc> число байт, переданных клиенту, за вычетом заголовка ответа; -переменная совместима с параметром “<code>%B</code>” модуля Apache -<code>mod_log_config</code> +переменная совместима с параметром “<literal>%B</literal>” модуля Apache +<literal>mod_log_config</literal> </tag-desc> <tag-name><var>$bytes_sent</var></tag-name> @@ -144,7 +144,7 @@ server { <tag-name><var>$pipe</var></tag-name> <tag-desc> -“<code>p</code>” если запрос был pipelined, иначе “<code>.</code>” +“<literal>p</literal>” если запрос был pipelined, иначе “<literal>.</literal>” </tag-desc> <tag-name><var>$request_length</var></tag-name> @@ -179,13 +179,13 @@ server { <para> Строки заголовка, переданные клиенту, начинаются с префикса -“<code>sent_http_</code>”, например, +“<literal>sent_http_</literal>”, например, <var>$sent_http_content_range</var>. </para> <para> В конфигурации всегда существует предопределённый формат -“<code>combined</code>”: +“<literal>combined</literal>”: <example> log_format combined '$remote_addr - $remote_user [$time_local] ' '"$request" $status $body_bytes_sent ' @@ -198,11 +198,11 @@ server { <directive name="open_log_file_cache"> <syntax> -<parameter>max</parameter>=<argument>N</argument> -[<parameter>inactive</parameter>=<argument>время</argument>] -[<parameter>min_uses</parameter>=<argument>N</argument>] -[<parameter>valid</parameter>=<argument>время</argument>]</syntax> -<syntax><value>off</value></syntax> +<literal>max</literal>=<value>N</value> +[<literal>inactive</literal>=<value>время</value>] +[<literal>min_uses</literal>=<value>N</value>] +[<literal>valid</literal>=<value>время</value>]</syntax> +<syntax><literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -214,36 +214,36 @@ server { Параметры директивы: <list type="tag"> -<tag-name><parameter>max</parameter></tag-name> +<tag-name><literal>max</literal></tag-name> <tag-desc> задаёт максимальное число дескрипторов в кэше; при переполнении кэша наиболее давно не используемые (LRU) дескрипторы закрываются </tag-desc> -<tag-name><parameter>inactive</parameter></tag-name> +<tag-name><literal>inactive</literal></tag-name> <tag-desc> задаёт время, после которого закэшированный дескриптор закрывается, если к нему не было обращений в течение этого времени; по умолчанию 10 секунд </tag-desc> -<tag-name><parameter>min_uses</parameter></tag-name> +<tag-name><literal>min_uses</literal></tag-name> <tag-desc> задаёт минимальное число использований файла в течение -времени, заданного параметром <parameter>inactive</parameter>, +времени, заданного параметром <literal>inactive</literal>, после которого дескриптор файла будет оставаться открытым в кэше; по умолчанию 1 </tag-desc> -<tag-name><parameter>valid</parameter></tag-name> +<tag-name><literal>valid</literal></tag-name> <tag-desc> задаёт, через какое время нужно проверять, что файл ещё существует под тем же именем; по умолчанию 60 секунд </tag-desc> -<tag-name><value>off</value></tag-name> +<tag-name><literal>off</literal></tag-name> <tag-desc> запрещает кэш </tag-desc>