# HG changeset patch
# User Ruslan Ermilov <ru@nginx.com>
# Date 1350567313 0
# Node ID e1593207d1cbc996dcf427c67198bdd3790da846
# Parent  99ea52dbb4d42f33720d09f4df82cbfd621b05ad
Documented in more detail how time intervals are specified in nginx
configuration file, and paraphrased the text about sizes.

diff -r 99ea52dbb4d4 -r e1593207d1cb xml/en/docs/syntax.xml
--- a/xml/en/docs/syntax.xml	Wed Oct 17 14:30:05 2012 +0000
+++ b/xml/en/docs/syntax.xml	Thu Oct 18 13:35:13 2012 +0000
@@ -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 @@
 </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>
diff -r 99ea52dbb4d4 -r e1593207d1cb xml/ru/docs/syntax.xml
--- a/xml/ru/docs/syntax.xml	Wed Oct 17 14:30:05 2012 +0000
+++ b/xml/ru/docs/syntax.xml	Thu Oct 18 13:35:13 2012 +0000
@@ -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>