# HG changeset patch
# User Yaroslav Zhuravlev <yar@nginx.com>
# Date 1418739762 -10800
# Node ID 90922e31756d0969cc81d10b4be40290638e6ce0
# Parent  47e19b6d3dbcc20f5d080c17bf91d4d93b501071
Documented the autoindex_format directive.

diff --git a/xml/en/docs/http/ngx_http_autoindex_module.xml b/xml/en/docs/http/ngx_http_autoindex_module.xml
--- a/xml/en/docs/http/ngx_http_autoindex_module.xml
+++ b/xml/en/docs/http/ngx_http_autoindex_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_autoindex_module"
         link="/en/docs/http/ngx_http_autoindex_module.html"
         lang="en"
-        rev="2">
+        rev="3">
 
 <section id="summary">
 
@@ -64,13 +64,40 @@ Enables or disables the directory listin
 <context>location</context>
 
 <para>
-Specifies whether exact file sizes should be output in the directory listing,
+For the HTML <link id="autoindex_format">format</link>,
+specifies whether exact file sizes should be output in the directory listing,
 or rather rounded to kilobytes, megabytes, and gigabytes.
 </para>
 
 </directive>
 
 
+<directive name="autoindex_format">
+<syntax>
+    <literal>html</literal> |
+    <literal>xml</literal> |
+    <literal>json</literal> |
+    <literal>jsonp</literal></syntax>
+<default>html</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.7.9</appeared-in>
+
+<para>
+Sets the format of a directory listing.
+</para>
+
+<para>
+When the JSONP format is used, the name of a callback function is set
+with the <literal>callback</literal> request argument.
+If the argument is missing or has an empty value,
+then the JSON format is used.
+</para>
+
+</directive>
+
+
 <directive name="autoindex_localtime">
 <syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>off</default>
@@ -79,7 +106,8 @@ or rather rounded to kilobytes, megabyte
 <context>location</context>
 
 <para>
-Specifies whether times in the directory listing should be
+For the HTML <link id="autoindex_format">format</link>,
+specifies whether times in the directory listing should be
 output in the local time zone or UTC.
 </para>
 
diff --git a/xml/ru/docs/http/ngx_http_autoindex_module.xml b/xml/ru/docs/http/ngx_http_autoindex_module.xml
--- a/xml/ru/docs/http/ngx_http_autoindex_module.xml
+++ b/xml/ru/docs/http/ngx_http_autoindex_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_autoindex_module"
         link="/ru/docs/http/ngx_http_autoindex_module.html"
         lang="ru"
-        rev="2">
+        rev="3">
 
 <section id="summary">
 
@@ -62,13 +62,40 @@ location / {
 <context>location</context>
 
 <para>
-Определяет, как выводить размеры файлов в листинге
+Для <link id="autoindex_format">формата</link> HTML
+определяет, как выводить размеры файлов в листинге
 каталога: точно или округляя до килобайт, мегабайт и гигабайт.
 </para>
 
 </directive>
 
 
+<directive name="autoindex_format">
+<syntax>
+    <literal>html</literal> |
+    <literal>xml</literal> |
+    <literal>json</literal> |
+    <literal>jsonp</literal></syntax>
+<default>html</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.7.9</appeared-in>
+
+<para>
+Задаёт формат вывода листинга каталога.
+</para>
+
+<para>
+При использовании формата JSONP имя callback-функции
+задаётся в аргументе запроса <literal>callback</literal>.
+Если аргумент отсутствует или имеет пустое значение,
+то используется формат JSON.
+</para>
+
+</directive>
+
+
 <directive name="autoindex_localtime">
 <syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>off</default>
@@ -77,7 +104,8 @@ location / {
 <context>location</context>
 
 <para>
-Определяет, в какой временной зоне выводить время в листинге
+Для <link id="autoindex_format">формата</link> HTML
+определяет, в какой временной зоне выводить время в листинге
 каталога: в локальной или в UTC.
 </para>