Restructured text in syntax.xml.

Author: y82

xml/en/docs/syntax.xml

@@ -8,28 +8,58 @@
 <article name="Configuration file measurement units"
          link="/en/docs/syntax.html"
          lang="en"
-         rev="3">
+         rev="4">
 
-<section>
+<section id="summary">
 
 <para>
-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,
+nginx supports several measurement units for specifying
+sizes, offsets, and time intervals within configuration files.
+</para>
+
+</section>
+
+
+<section id="size" name="Sizes and offsets">
+
+<para>
+Sizes can be specified in bytes, kilobytes, or megabytes
+using the following suffixes:
+
+<list type="bullet">
+
+<listitem>
+<literal>k</literal> and <literal>K</literal> for kilobytes
+</listitem>
+
+<listitem>
+<literal>m</literal> and <literal>M</literal> for megabytes
+</listitem>
+
+</list>
+</para>
+
+<para>
+For example,
 “<literal>1024</literal>”, “<literal>8k</literal>”, “<literal>1m</literal>”.
 </para>
 
 <para>
-Offsets may be also specified in gigabytes using
+Offsets can be also specified in gigabytes using the
 <literal>g</literal> or <literal>G</literal> suffixes.
 </para>
 
+</section>
+
+
+<section id="time" name="Time intervals">
+
 <para>
 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%">s</td><td>seconds (default)</td></tr>
 <tr><td width="20%">m</td><td>minutes</td></tr>
 <tr><td width="20%">h</td><td>hours</td></tr>
 <tr><td width="20%">d</td><td>days</td></tr>
@@ -45,12 +75,30 @@ 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>”.
+</para>
+
+<para>
+<list type="bullet">
+
+<listitem>
+<para>
 A value without a suffix means seconds.
+</para>
+</listitem>
+
+<listitem>
+<para>
 It is recommended to always specify a suffix.
 </para>
+</listitem>
 
+<listitem>
 <para>
-Some of the time intervals can be specified only with a seconds resolution.
+Certain time intervals can be specified only with a seconds resolution.
+</para>
+</listitem>
+
+</list>
 </para>
 
 </section>

xml/ru/docs/syntax.xml

@@ -8,23 +8,58 @@
 <article name="Единицы измерения в конфигурационном файле"
          link="/ru/docs/syntax.html"
          lang="ru"
-         rev="3">
+         rev="4">
 
-<section>
+<section id="summary">
 
 <para>
-Размеры можно указывать в байтах, килобайтах
-(суффиксы <literal>k</literal> и <literal>K</literal>) или мегабайтах
-(суффиксы <literal>m</literal> и <literal>M</literal>), например,
+nginx поддерживает несколько единиц измерения для указания
+размеров, смещений и временных интервалов в конфигурационных файлах.
+</para>
+
+</section>
+
+
+<section id="size" name="Размеры и смещения">
+
+<para>
+Размеры можно указывать в байтах, килобайтах или мегабайтах
+используя следующие суффиксы:
+
+<list type="bullet">
+
+<listitem>
+<literal>k</literal> и <literal>K</literal> для килобайт
+</listitem>
+
+<listitem>
+<literal>m</literal> и <literal>M</literal> для мегабайт
+</listitem>
+
+</list>
+</para>
+
+<para>
+Например,
 “<literal>1024</literal>”, “<literal>8k</literal>”, “<literal>1m</literal>”.
 </para>
 
+<para>
+Смещения также можно указать в гигабайтах используя
+суффиксы <literal>g</literal> или <literal>G</literal>.
+</para>
+
+</section>
+
+
+<section id="time" name="Интервалы времени">
+
 <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%">s</td><td>секунды (по умолчанию)</td></tr>
 <tr><td width="20%">m</td><td>минуты</td></tr>
 <tr><td width="20%">h</td><td>часы</td></tr>
 <tr><td width="20%">d</td><td>дни</td></tr>
@@ -40,13 +75,31 @@
 и по желанию отделяя их пробелами.
 Например, “<literal>1h 30m</literal>” задаёт то же время,
 что и “<literal>90m</literal>” или “<literal>5400s</literal>”.
+</para>
+
+<para>
+<list type="bullet">
+
+<listitem>
+<para>
 Значение без суффикса задаёт секунды.
+</para>
+</listitem>
+
+<listitem>
+<para>
 Рекомендуется всегда указывать суффикс.
 </para>
+</listitem>
 
+<listitem>
 <para>
 Некоторые интервалы времени можно задать лишь с точностью до секунд.
 </para>
+</listitem>
+
+</list>
+</para>
 
 </section>