--- a/xml/ru/docs/control.xml	Wed Oct 12 05:36:20 2011 +0000
+++ b/xml/ru/docs/control.xml	Wed Oct 12 15:47:58 2011 +0000
@@ -11,7 +11,7 @@
 записывается в файл <command>/usr/local/nginx/logs/nginx.pid</command>.
 Изменить имя этого файла можно при конфигурации сборки или же в
 <command>nginx.conf</command> директивой
-<link doc="ngx_core_module.xml#pid">pid</link>.
+<link doc="ngx_core_module.xml" id="pid">pid</link>.
 Главный процесс поддерживает следующие сигналы:
 <note>
 <table>

--- a/xml/ru/docs/hash.xml	Wed Oct 12 05:36:20 2011 +0000
+++ b/xml/ru/docs/hash.xml	Wed Oct 12 15:47:58 2011 +0000
@@ -19,8 +19,8 @@
 hash max size.
 Для большинства хэшей есть директивы, которые позволяют менять эти параметры,
 например, для хэшей имён серверов директивы называются
-<link doc="http/ngx_http_core_module.xml#server_names_hash_max_size">server_names_hash_max_size</link>
-и <link doc="http/ngx_http_core_module.xml#server_names_hash_bucket_size">server_names_hash_bucket_size</link>.
+<link doc="http/ngx_http_core_module.xml" id="server_names_hash_max_size">server_names_hash_max_size</link>
+и <link doc="http/ngx_http_core_module.xml" id="server_names_hash_bucket_size">server_names_hash_bucket_size</link>.
 </para>
 
 <para>

--- a/xml/ru/docs/http/ngx_http_core_module.xml	Wed Oct 12 05:36:20 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_core_module.xml	Wed Oct 12 15:47:58 2011 +0000
@@ -164,7 +164,8 @@
 <para>
 Директива определяет, сохранять ли всё тело запроса клиента в файл.
 Директиву можно использовать для отладки и при использовании
-переменной $request_body_file или метода <link doc="ngx_http_perl_module.xml#methods">$r-&gt;request_body_file</link>
+переменной $request_body_file или метода
+<link doc="ngx_http_perl_module.xml" id="methods">$r-&gt;request_body_file</link>
 модуля ngx_http_perl_module.
 </para>
 
@@ -534,7 +535,8 @@
 <para>
 Директива ограничивает HTTP-методы, доступные внутри location.
 Метод GET также включает в себя метод HEAD.
-Для ограничения могут использоваться директивы модулей <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>
+Для ограничения могут использоваться директивы модулей
+<link doc="ngx_http_access_module.xml">ngx_http_access_module</link>
 и <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>:
 <example>
 limit_except  GET {
@@ -838,7 +840,8 @@
 <context>http, server, location</context>
 
 <para>
-Директива разрешает или запрещает записывать в <link doc="ngx_http_log_module.xml#access_log">access_log</link>
+Директива разрешает или запрещает записывать в
+<link doc="ngx_http_log_module.xml" id="access_log">access_log</link>
 подзапросы.
 </para>
 
@@ -1756,8 +1759,8 @@
 <listitem>
 $request_body, эта переменная содержит тело запроса.
 Значение переменной появляется в location'ах, обрабатываемых директивами
-<link doc="ngx_http_proxy_module.xml#proxy_pass">proxy_pass</link>
-и <link doc="ngx_http_fastcgi_module.xml#fastcgi_pass">fastcgi_pass</link>.
+<link doc="ngx_http_proxy_module.xml" id="proxy_pass">proxy_pass</link>
+и <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass">fastcgi_pass</link>.
 </listitem>
 
 <listitem>
@@ -1765,7 +1768,7 @@
 хранится тело запроса.
 По завершению работы файл необходимо удалить.
 Для того, чтобы тело запроса клиента всегда записывалось в файл, нужно
-указать <link doc="ngx_http_core_module.xml#client_body_in_file_only">client_body_in_file_only on</link>.
+указать <link doc="ngx_http_core_module.xml" id="client_body_in_file_only">client_body_in_file_only on</link>.
 При передаче имени в проксированном запросе или в запросе к FastCGI-серверу
 следует запретить передачу самого тела директивами
 "proxy_pass_request_body off" или

--- a/xml/ru/docs/http/ngx_http_dav_module.xml	Wed Oct 12 05:36:20 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_dav_module.xml	Wed Oct 12 15:47:58 2011 +0000
@@ -86,7 +86,8 @@
 что в этом случае вместо дешёвой операции переименовывания в пределах
 одной файловой системы файл копируется с одной файловой системы на другую.
 Поэтому лучше, если сохраняемые файлы будут находиться на той же файловой
-системе, что и каталог с временными файлами, задаваемый директивой <link doc="ngx_http_core_module.xml#client_body_temp_path">client_body_temp_path</link>
+системе, что и каталог с временными файлами, задаваемый директивой
+<link doc="ngx_http_core_module.xml" id="client_body_temp_path">client_body_temp_path</link>
 для данного location.
 </para>
 

--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Wed Oct 12 05:36:20 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Wed Oct 12 15:47:58 2011 +0000
@@ -561,8 +561,8 @@
 <para>
 Директива разрешает сохранение на диск файлов.
 Параметр "on" сохраняет файлы в соответствии с путями, указаными в директивах
-<link doc="ngx_http_core_module.xml#alias">alias</link> или
-<link doc="ngx_http_core_module.xml#root">root</link>.
+<link doc="ngx_http_core_module.xml" id="alias">alias</link> или
+<link doc="ngx_http_core_module.xml" id="root">root</link>.
 Параметр "off" запрещает сохранение файлов.
 Кроме того, имя файла можно явно задать с помощью строки с переменными:
 <example>

--- a/xml/ru/docs/http/ngx_http_gzip_module.xml	Wed Oct 12 05:36:20 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_gzip_module.xml	Wed Oct 12 15:47:58 2011 +0000
@@ -204,7 +204,7 @@
 Разрешает или запрещает выдавать в ответе строку заголовка
 "Vary: Accept-Encoding", если директивы
 <link id="gzip"/> или
-<link doc="ngx_http_gzip_static_module.xml#gzip_static">gzip_static</link>
+<link doc="ngx_http_gzip_static_module.xml" id="gzip_static">gzip_static</link>
 активны.
 </para>
 

--- a/xml/ru/docs/http/ngx_http_gzip_static_module.xml	Wed Oct 12 05:36:20 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_gzip_static_module.xml	Wed Oct 12 15:47:58 2011 +0000
@@ -44,10 +44,10 @@
 <para>
 Разрешает или запрещает проверку готового сжатого файла.
 При использовании также учитываются директивы
-<link doc="ngx_http_gzip_module.xml#gzip_http_version">gzip_http_version</link>,
-<link doc="ngx_http_gzip_module.xml#gzip_proxied">gzip_proxied</link>,
-<link doc="ngx_http_gzip_module.xml#gzip_disable">gzip_disable</link>
-и <link doc="ngx_http_gzip_module.xml#gzip_vary">gzip_vary</link>.
+<link doc="ngx_http_gzip_module.xml" id="gzip_http_version">gzip_http_version</link>,
+<link doc="ngx_http_gzip_module.xml" id="gzip_proxied">gzip_proxied</link>,
+<link doc="ngx_http_gzip_module.xml" id="gzip_disable">gzip_disable</link>
+и <link doc="ngx_http_gzip_module.xml" id="gzip_vary">gzip_vary</link>.
 </para>
 
 <para>

--- a/xml/ru/docs/http/ngx_http_log_module.xml	Wed Oct 12 05:36:20 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_log_module.xml	Wed Oct 12 15:47:58 2011 +0000
@@ -76,7 +76,7 @@
 <listitem>
 при каждой записи в лог проверяется существование каталога root'а для
 запроса — если этот каталог не существует, то лог не создаётся.
-Поэтому <link doc="ngx_http_core_module.xml#root">root</link>
+Поэтому <link doc="ngx_http_core_module.xml" id="root">root</link>
 и access_log нужно описывать на одном уровне:
 <example>
 server {

--- a/xml/ru/docs/http/ngx_http_perl_module.xml	Wed Oct 12 05:36:20 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_perl_module.xml	Wed Oct 12 15:47:58 2011 +0000
@@ -55,7 +55,7 @@
 будет увеличиваться в размерах при каждой переконфигурации.
 Когда основной процесс вырастет до неприемлемых размеров, можно
 воспользоваться процедурой
-<link doc="../control.html#upgrade">обновления сервера на лету</link>,
+<link doc="../control.html" id="upgrade">обновления сервера на лету</link>,
 не меняя при этом сам исполняемый файл.
 </para>
 
@@ -352,9 +352,10 @@
 <emphasis>$r-&gt;request_body</emphasis> — метод возвращает тело запроса
 клиента при условии, что тело не записано во временный файл.
 Для того, чтобы тело запроса клиента гарантировано находилось в памяти,
-нужно ограничить его размер с помощью <link doc="ngx_http_core_module.xml#client_max_body_size">client_max_body_size</link>
+нужно ограничить его размер с помощью
+<link doc="ngx_http_core_module.xml" id="client_max_body_size">client_max_body_size</link>
 и задать достаточной размер для буфера
-<link doc="ngx_http_core_module.xml#client_body_buffer_size">client_body_buffer_size</link>.
+<link doc="ngx_http_core_module.xml" id="client_body_buffer_size">client_body_buffer_size</link>.
 </listitem>
 
 <listitem>
@@ -362,7 +363,7 @@
 в котором хранится тело запроса клиента.
 По завершению работы файл необходимо удалить.
 Для того, чтобы тело запроса клиента всегда записывалось в файл, нужно
-указать <link doc="ngx_http_core_module.xml#client_body_in_file_only">client_body_in_file_only on</link>.
+указать <link doc="ngx_http_core_module.xml" id="client_body_in_file_only">client_body_in_file_only on</link>.
 </listitem>
 
 <listitem>
@@ -385,7 +386,8 @@
 Собственно передача данных происходит уже после завершения
 perl'ового обработчика.
 Необходимо учитывать, что при использовании
-этого метода в подзапросе и директиве <link doc="ngx_http_core_module.xml#sendfile">sendfile on</link>
+этого метода в подзапросе и директиве
+<link doc="ngx_http_core_module.xml" id="sendfile">sendfile on</link>
 содержимое файла не будет проходить через
 <link doc="ngx_http_gzip_module.xml">gzip</link>,
 <link doc="ngx_http_ssi_module.xml">SSI</link> и

--- a/xml/ru/docs/http/ngx_http_proxy_module.xml	Wed Oct 12 05:36:20 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml	Wed Oct 12 15:47:58 2011 +0000
@@ -504,7 +504,8 @@
 <para>
 В этом случае имя сервера ищется среди описанных
 <link doc="ngx_http_upstream.xml">групп серверов</link>
-и если не найдено, то определяется с помощью <link doc="ngx_http_core_module.xml#resolver">resolver'а</link>.
+и если не найдено, то определяется с помощью
+<link doc="ngx_http_core_module.xml" id="resolver">resolver'а</link>.
 </para>
 
 </directive>
@@ -718,8 +719,8 @@
 <para>
 Директива разрешает сохранение на диск файлов.
 Параметр "on" сохраняет файлы в соответствии с путями, указаными в директивах
-<link doc="ngx_http_core_module.xml#alias">alias</link> или
-<link doc="ngx_http_core_module.xml#root">root</link>.
+<link doc="ngx_http_core_module.xml" id="alias">alias</link> или
+<link doc="ngx_http_core_module.xml" id="root">root</link>.
 Параметр "off" запрещает сохранение файлов.
 Кроме того, имя файла можно явно задать с помощью строки с переменными:
 <example>

--- a/xml/ru/docs/http/ngx_http_rewrite_module.xml	Wed Oct 12 05:36:20 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_rewrite_module.xml	Wed Oct 12 15:47:58 2011 +0000
@@ -128,7 +128,8 @@
         return   403;
     }
 </example>
-Значение встроенной переменной $invalid_referer задаётся директивой <link doc="ngx_http_referer_module.xml#valid_referers">valid_referers</link>.
+Значение встроенной переменной $invalid_referer задаётся директивой
+<link doc="ngx_http_referer_module.xml" id="valid_referers">valid_referers</link>.
 </para>
 
 </directive>

--- a/xml/ru/docs/http/ngx_http_ssl_module.xml	Wed Oct 12 05:36:20 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_ssl_module.xml	Wed Oct 12 15:47:58 2011 +0000
@@ -129,7 +129,7 @@
      }
 </example>
 иначе для второго сайта будет выдаваться
-<link doc="../faq.xml#name_based_vhost_ssl">сертификат
+<link doc="../faq.xml" id="name_based_vhost_ssl">сертификат
 первого сервера</link>.
 </para>
 
@@ -333,7 +333,8 @@
 
 <para>
 Модуль ngx_http_ssl_module поддерживает несколько нестандартных кодов ошибок,
-которые можно использовать для перенаправления с помощью директивы <link doc="ngx_http_core_module.xml#error_page">error_page</link>:
+которые можно использовать для перенаправления с помощью директивы
+<link doc="ngx_http_core_module.xml" id="error_page">error_page</link>:
 <list type="bullet">
 
 <listitem>
@@ -374,7 +375,8 @@
 $ssl_client_cert возвращает клиентский сертификат
 для установленного SSL-соединения в формате PEM
 перед каждой строкой которого, кроме первой, вставляется символ табуляции;
-предназачен для использования в директиве <link doc="ngx_http_proxy_module.xml#proxy_set_header">proxy_set_header</link>.
+предназачен для использования в директиве
+<link doc="ngx_http_proxy_module.xml" id="proxy_set_header">proxy_set_header</link>.
 </listitem>
 
 <listitem>

--- a/xml/ru/docs/http/ngx_http_upstream.xml	Wed Oct 12 05:36:20 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_upstream.xml	Wed Oct 12 15:47:58 2011 +0000
@@ -11,8 +11,8 @@
 <para>
 Модуль позволяет описывать группы серверов,
 которые могут использоваться в директивах
-<link doc="ngx_http_proxy_module.xml#proxy_pass">proxy_pass</link>
-и <link doc="ngx_http_fastcgi_module.xml#fastcgi_pass">fastcgi_pass</link>.
+<link doc="ngx_http_proxy_module.xml" id="proxy_pass">proxy_pass</link>
+и <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass">fastcgi_pass</link>.
 </para>
 
 </section>
@@ -107,8 +107,8 @@
 По умолчанию число попыток равно одной.
 Нулевое значение запрещает учёт попыток.
 Что считается неудачной попыткой, задаётся директивами
-<link doc="ngx_http_proxy_module.xml#proxy_next_upstream">proxy_next_upstream</link>
-и <link doc="ngx_http_fastcgi_module.xml#fastcgi_next_upstream">fastcgi_next_upstream</link>.
+<link doc="ngx_http_proxy_module.xml" id="proxy_next_upstream">proxy_next_upstream</link>
+и <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_next_upstream">fastcgi_next_upstream</link>.
 Состояние http_404 не считается неудачной попыткой.
 </listitem>
 

--- a/xml/ru/docs/ngx_core_module.xml	Wed Oct 12 05:36:20 2011 +0000
+++ b/xml/ru/docs/ngx_core_module.xml	Wed Oct 12 15:47:58 2011 +0000
@@ -55,12 +55,13 @@
 <list type="bullet">
 
 <listitem>
-наследование переменных во время <link doc="../control.xml#upgrade">обновления исполняемого файла
-на лету</link>;
+наследование переменных во время
+<link doc="control.xml" id="upgrade">обновления исполняемого файла на лету</link>;
 </listitem>
 
 <listitem>
-использование переменных модулем <link doc="ngx_http_perl_module.xml">ngx_http_perl_module</link>;
+использование переменных модулем
+<link doc="http/ngx_http_perl_module.xml">ngx_http_perl_module</link>;
 </listitem>
 
 <listitem>