Mercurial > hg > nginx-site
changeset 735:e1593207d1cb
Documented in more detail how time intervals are specified in nginx
configuration file, and paraphrased the text about sizes.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Thu, 18 Oct 2012 13:35:13 +0000 |
parents | 99ea52dbb4d4 |
children | 9f2953d854fd |
files | xml/en/docs/syntax.xml xml/ru/docs/syntax.xml |
diffstat | 2 files changed, 38 insertions(+), 22 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/en/docs/syntax.xml +++ b/xml/en/docs/syntax.xml @@ -8,21 +8,22 @@ <article name="Configuration file measurement units" link="/en/docs/syntax.html" lang="en" - rev="2"> + rev="3"> <section> <para> -Sizes can be specified in kilobytes (<literal>k</literal>, -<literal>K</literal>) and megabytes (<literal>m</literal>, -<literal>M</literal>), for example “<literal>8k</literal>”, -“<literal>1m</literal>”. -If the suffix is not specified, the value is bytes. +Sizes can be specified in bytes, kilobytes +(suffixes <literal>k</literal> and <literal>K</literal>) or megabytes +(suffixes <literal>m</literal> and <literal>M</literal>), for example, +“<literal>1024</literal>”, “<literal>8k</literal>”, “<literal>1m</literal>”. </para> <para> -Time can be specified in minutes, hours, days and so on: +Time intervals can be specified in milliseconds, seconds, +minutes, hours, days and so on, using the following suffixes: <table width="30%"> +<tr><td width="20%">ms</td><td>milliseconds</td></tr> <tr><td width="20%">s</td><td>seconds</td></tr> <tr><td width="20%">m</td><td>minutes</td></tr> <tr><td width="20%">h</td><td>hours</td></tr> @@ -34,10 +35,17 @@ Time can be specified in minutes, hours, </para> <para> -for example “<literal>1h 30m</literal>”, “<literal>1y 6M</literal>”. -Additionally, it is possible to specify time with millisecond -precision (<literal>ms</literal>) in some directives. -If the suffix is not specified, the value is seconds. +Multiple units can be combined in a single value +by specifying them in the order from the most to the least significant, +and optionally separated by whitespace. +For example, “<literal>1h 30m</literal>” specifies the same time +as “<literal>90m</literal>” or “<literal>5400s</literal>”. +A value without a suffix means seconds. +It is recommended to always specify a suffix. +</para> + +<para> +Some of the time intervals can be specified only with a seconds resolution. </para> </section>
--- a/xml/ru/docs/syntax.xml +++ b/xml/ru/docs/syntax.xml @@ -8,21 +8,22 @@ <article name="Единицы измерения в конфигурационном файле" link="/ru/docs/syntax.html" lang="ru" - rev="2"> + rev="3"> <section> <para> -Размеры можно указывать в килобайтах (<literal>k</literal>, -<literal>K</literal>) и мегабайтах (<literal>m</literal>, -<literal>M</literal>), например, “<literal>8k</literal>”, -“<literal>1m</literal>”. -Если суффикс не указан, то значение задано в байтах. +Размеры можно указывать в байтах, килобайтах +(суффиксы <literal>k</literal> и <literal>K</literal>) или мегабайтах +(суффиксы <literal>m</literal> и <literal>M</literal>), например, +“<literal>1024</literal>”, “<literal>8k</literal>”, “<literal>1m</literal>”. </para> <para> -Время можно указывать в минутах, часах, днях и так далее: +Интервалы времени можно задавать в миллисекундах, секундах, +минутах, часах, днях и т.д., используя следующие суффиксы: <table width="30%"> +<tr><td width="20%">ms</td><td>миллисекунды</td></tr> <tr><td width="20%">s</td><td>секунды</td></tr> <tr><td width="20%">m</td><td>минуты</td></tr> <tr><td width="20%">h</td><td>часы</td></tr> @@ -34,10 +35,17 @@ </para> <para> -например, “<literal>1h 30m</literal>”, “<literal>1y 6M</literal>”. -Также в некоторых директивах возможно указать время -с точностью до миллисекунд (<literal>ms</literal>). -Если суффикс не указан, то значение задано в секундах. +В одном значении можно комбинировать различные единицы, +указывая их в порядке от более к менее значащим, +и по желанию отделяя их пробелами. +Например, “<literal>1h 30m</literal>” задаёт то же время, +что и “<literal>90m</literal>” или “<literal>5400s</literal>”. +Значение без суффикса задаёт секунды. +Рекомендуется всегда указывать суффикс. +</para> + +<para> +Некоторые интервалы времени можно задать лишь с точностью до секунд. </para> </section>