--- a/xml/ru/docs/http/ngx_http_empty_gif_module.xml	Mon Jan 16 11:11:30 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_empty_gif_module.xml	Mon Jan 16 11:12:08 2012 +0000
@@ -2,20 +2,21 @@
 
 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
 
-<module name="Директивы модуля ngx_http_empty_gif_module"
+<module name="Модуль ngx_http_empty_gif_module"
         link="/ru/docs/http/ngx_http_empty_gif_module.html"
         lang="ru">
 
 <section id="summary">
 
 <para>
-Модуль ngx_http_empty_gif_module выдаёт одно-пиксельный прозрачный GIF.
+Модуль <literal>ngx_http_empty_gif_module</literal> выдаёт
+однопиксельный прозрачный GIF.
 </para>
 
 </section>
 
 
-<section name="Пример конфигурации" id="example">
+<section id="example" name="Пример конфигурации">
 
 <para>
 <example>
@@ -28,7 +29,7 @@
 </section>
 
 
-<section name="Директивы" id="directives">
+<section id="directives" name="Директивы">
 
 <directive name="empty_gif">
 <syntax/>
@@ -36,7 +37,7 @@
 <context>location</context>
 
 <para>
-Директива разрешает выдавать одно-пиксельный прозрачный GIF.
+Разрешает в содержащем location выдавать однопиксельный прозрачный GIF.
 </para>
 
 </directive>

--- a/xml/ru/docs/http/ngx_http_flv_module.xml	Mon Jan 16 11:11:30 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_flv_module.xml	Mon Jan 16 11:12:08 2012 +0000
@@ -2,27 +2,33 @@
 
 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
 
-<module name="Директивы модуля ngx_http_flv_module"
+<module name="Модуль ngx_http_flv_module"
         link="/ru/docs/http/ngx_http_flv_module.html"
         lang="ru">
 
 <section id="summary">
 
 <para>
-Модуль ngx_http_flv_module делает специальную обработку передаваемых файлов:
-при передаче файла, начиная со смещения, указанного в аргументах
-запроса "start=XXX", добавляет FLV-заголовок перед запрашиваемым файлом.
+Модуль <literal>ngx_http_flv_module</literal> обеспечивает серверную поддержку
+псевдо-стриминга для файлов Flash Video (FLV).
 </para>
 
 <para>
-По умолчанию модуль не собирается, нужно разрешить его сборку
-при конфигурировании параметром <literal>--with-http_flv_module</literal>.
+Он специальным образом обрабатывает запросы с аргументом
+<literal>start</literal> в строке запроса, посылая в ответ содержимое файла
+с запрошенного смещения в байтах, добавив перед ним FLV-заголовок.
+</para>
+
+<para>
+По умолчанию этот модуль не собирается, его сборку необходимо
+разрешить с помощью конфигурационного параметра
+<literal>--with-http_flv_module</literal>.
 </para>
 
 </section>
 
 
-<section name="Пример конфигурации" id="example">
+<section id="example" name="Пример конфигурации">
 
 <para>
 <example>
@@ -35,7 +41,7 @@
 </section>
 
 
-<section name="Директивы" id="directives">
+<section id="directives" name="Директивы">
 
 <directive name="flv">
 <syntax/>
@@ -43,7 +49,7 @@
 <context>location</context>
 
 <para>
-Директива разрешает специальную обработку передаваемых файлов.
+Включает в содержащем location обработку этим модулем.
 </para>
 
 </directive>

--- a/xml/ru/docs/http/ngx_http_index_module.xml	Mon Jan 16 11:11:30 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_index_module.xml	Mon Jan 16 11:12:08 2012 +0000
@@ -2,25 +2,26 @@
 
 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
 
-<module name="Директивы модуля ngx_http_index_module"
+<module name="Модуль ngx_http_index_module"
         link="/ru/docs/http/ngx_http_index_module.html"
         lang="ru">
 
 <section id="summary">
 
 <para>
-Модуль ngx_http_index_module обслуживает запросы, оканчивающиеся слэшом.
+Модуль <literal>ngx_http_index_module</literal> обслуживает запросы,
+оканчивающиеся слэшом (‘<literal>/</literal>’).
 </para>
 
 </section>
 
 
-<section name="Пример конфигурации" id="example">
+<section id="example" name="Пример конфигурации">
 
 <para>
 <example>
-    location  /  {
-        index  index.$geo.html  index.html;
+    location / {
+        index index.$geo.html index.html;
     }
 </example>
 </para>
@@ -28,30 +29,31 @@
 </section>
 
 
-<section name="Директивы" id="directives">
+<section id="directives" name="Директивы">
 
 <directive name="index">
 <syntax><value>файл</value> ...</syntax>
 <default>index.html</default>
-<context>http, server, location</context>
+<context>http</context>
+<context>server</context>
+<context>location</context>
 
 <para>
-Директива определяет файлы, которые будут использоваться в качестве индекса.
+Определяет файлы, которые будут использоваться в качестве индекса.
 В имени файла можно использовать переменные.
 Наличие файлов проверяется в порядке их перечисления.
 В конце списка может стоять файл с абсолютным путём.
-Пример использования:
+Пример:
 <example>
-    index  index.$geo.html  index.0.html  /index.html;
+    index index.$geo.html index.0.html /index.html;
 </example>
 </para>
 
 <para>
 Необходимо иметь в виду, что при использовании индексного файла делается
 внутреннее перенаправление и запрос может быть обработан уже в другом
-location'е.
-Например, запрос "/" будет фактически обработан во втором location'е
-как "/index.html" в такой конфигурации:
+location’е.
+Например, в такой конфигурации:
 <example>
     location  = /  {
         index  index.html;
@@ -61,6 +63,8 @@
         ...
     }
 </example>
+запрос “<literal>/</literal>” будет фактически обработан во
+втором location’е как “<literal>/index.html</literal>”.
 </para>
 
 </directive>

--- a/xml/ru/docs/http/ngx_http_random_index_module.xml	Mon Jan 16 11:11:30 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_random_index_module.xml	Mon Jan 16 11:12:08 2012 +0000
@@ -2,29 +2,34 @@
 
 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
 
-<module name="Директивы модуля ngx_http_random_index_module"
+<module name="Модуль ngx_http_random_index_module"
         link="/ru/docs/http/ngx_http_random_index_module.html"
         lang="ru">
 
 <section id="summary">
 
 <para>
-Модуль ngx_http_random_index_module выдаёт случайный файл в качестве
-индексного файла каталога. Модуль работает до модуля
+Модуль <literal>ngx_http_random_index_module</literal> выдаёт случайный
+файл в качестве индексного файла каталога.
+Модуль работает до модуля
 <link doc="ngx_http_index_module.xml">ngx_http_index_module</link>.
-По умолчанию модуль не собирается, нужно разрешить его сборку при
-конфигурировании параметром <literal>--with-http_random_index_module</literal>.
+</para>
+
+<para>
+По умолчанию этот модуль не собирается, его сборку необходимо
+разрешить с помощью конфигурационного параметра
+<literal>--with-http_random_index_module</literal>.
 </para>
 
 </section>
 
 
-<section name="Пример конфигурации" id="example">
+<section id="example" name="Пример конфигурации">
 
 <para>
 <example>
-    location  /  {
-        random_index  on;
+    location / {
+        random_index on;
     }
 </example>
 </para>
@@ -32,7 +37,7 @@
 </section>
 
 
-<section name="Директивы" id="directives">
+<section id="directives" name="Директивы">
 
 <directive name="random_index">
 <syntax><literal>on</literal> | <literal>off</literal></syntax>
@@ -40,7 +45,7 @@
 <context>location</context>
 
 <para>
-Директива разрешает или запрещает работу модуля.
+Разрешает или запрещает в содержащем location обработку этим модулем.
 </para>
 
 </directive>