--- a/xml/en/GNUmakefile
+++ b/xml/en/GNUmakefile
@@ -5,6 +5,7 @@ DOCS =									\
 		install							\
 		windows							\
 		events							\
+		syntax							\
 		control							\
 		hash							\
 		dirindex						\

--- a/xml/en/docs/index.xml
+++ b/xml/en/docs/index.xml
@@ -46,6 +46,10 @@
 </listitem>
 
 <listitem>
+<link doc="syntax.xml"/>
+</listitem>
+
+<listitem>
 <link doc="hash.xml"/>
 </listitem>
 

new file mode 100644
--- /dev/null
+++ b/xml/en/docs/syntax.xml
@@ -0,0 +1,45 @@
+<!--
+  Copyright (C) Igor Sysoev
+  Copyright (C) Nginx, Inc.
+  -->
+
+<!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
+
+<article name="Configuration file measurement units"
+         link="/en/docs/syntax.html"
+         lang="en"
+         rev="2">
+
+<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.
+</para>
+
+<para>
+Time can be specified in minutes, hours, days and so on:
+<table width="30%">
+<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>
+<tr><td width="20%">d</td><td>days</td></tr>
+<tr><td width="20%">w</td><td>weeks</td></tr>
+<tr><td width="20%">M</td><td>months, 30 days</td></tr>
+<tr><td width="20%">y</td><td>years, 365 days</td></tr>
+</table>
+</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.
+</para>
+
+</section>
+
+</article>

--- a/xml/ru/docs/syntax.xml
+++ b/xml/ru/docs/syntax.xml
@@ -5,36 +5,24 @@
 
 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
 
-<article name="Синтаксис конфигурационного файла"
+<article name="Единицы измерения в конфигурационном файле"
          link="/ru/docs/syntax.html"
          lang="ru"
-         rev="1">
+         rev="2">
 
 <section>
 
-<!--
-
-<para lang="ru">
-<programlisting>
-    директива  параметр  [параметр ...];
-</programlisting>
-</para>
-
--->
-
 <para>
-Размеры можно указывать в килобайтах и мегабайтах:
-<table width="30%">
-<tr><td width="20%">k,K</td><td>килобайты</td></tr>
-<tr><td width="20%">m,M</td><td>мегабайты</td></tr>
-</table>
-например, "8k", "1m". По умолчанию размер в байтах.
+Размеры можно указывать в килобайтах (<literal>k</literal>,
+<literal>K</literal>) и мегабайтах (<literal>m</literal>,
+<literal>M</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>
@@ -43,7 +31,13 @@
 <tr><td width="20%">M</td><td>месяцы, 30 дней</td></tr>
 <tr><td width="20%">y</td><td>годы, 365 дней</td></tr>
 </table>
-например, "1h 30m", "1y 6M". По умолчанию время в секундах.
+</para>
+
+<para>
+например, “<literal>1h 30m</literal>”, “<literal>1y 6M</literal>”.
+Также в некоторых директивах возможно указать время
+с точностью до миллисекунд (<literal>ms</literal>).
+Если суффикс не указан, то значение задано в секундах.
 </para>
 
 </section>