[nginx-site] Fixed order of perl request object methods.

[Maxim Dounin]

details:   http://freenginx.org/hg/nginx-site/rev/d83d66357a77
branches:  
changeset: 3126:d83d66357a77
user:      Sergey A. Osokin <osa at FreeBSD.org.ru>
date:      Mon Feb 02 22:41:20 2026 +0300
description:
Fixed order of perl request object methods.

diffstat:

 xml/en/docs/http/ngx_http_perl_module.xml |  68 +++++++++++++++---------------
 xml/ru/docs/http/ngx_http_perl_module.xml |  68 +++++++++++++++---------------
 2 files changed, 68 insertions(+), 68 deletions(-)

diffs (262 lines):

diff --git a/xml/en/docs/http/ngx_http_perl_module.xml b/xml/en/docs/http/ngx_http_perl_module.xml
--- a/xml/en/docs/http/ngx_http_perl_module.xml
+++ b/xml/en/docs/http/ngx_http_perl_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_perl_module"
         link="/en/docs/http/ngx_http_perl_module.html"
         lang="en"
-        rev="8">
+        rev="9">
 
 <section id="summary">
 
@@ -219,16 +219,31 @@ An SSI command calling Perl has the foll
 <para>
 <list type="tag">
 
+<tag-name><literal>$r->allow_ranges</literal></tag-name>
+<tag-desc>
+enables the use of byte ranges when sending responses.
+</tag-desc>
+
 <tag-name><literal>$r->args</literal></tag-name>
 <tag-desc>
 returns request arguments.
 </tag-desc>
 
+<tag-name><literal>$r->discard_request_body</literal></tag-name>
+<tag-desc>
+instructs nginx to discard the request body.
+</tag-desc>
+
 <tag-name><literal>$r->filename</literal></tag-name>
 <tag-desc>
 returns a filename corresponding to the request URI.
 </tag-desc>
 
+<tag-name><literal>$r->flush</literal></tag-name>
+<tag-desc>
+immediately sends data to the client.
+</tag-desc>
+
 <tag-name>
     <literal>$r->has_request_body(<value>handler</value>)</literal>
 </tag-name>
@@ -275,16 +290,6 @@ 1;
 </example>
 </tag-desc>
 
-<tag-name><literal>$r->allow_ranges</literal></tag-name>
-<tag-desc>
-enables the use of byte ranges when sending responses.
-</tag-desc>
-
-<tag-name><literal>$r->discard_request_body</literal></tag-name>
-<tag-desc>
-instructs nginx to discard the request body.
-</tag-desc>
-
 <tag-name><literal>$r->header_in(<value>field</value>)</literal></tag-name>
 <tag-desc>
 returns the value of the specified client request header field.
@@ -331,6 +336,11 @@ will be appended to the message.
 passes data to a client.
 </tag-desc>
 
+<tag-name><literal>$r->remote_addr</literal></tag-name>
+<tag-desc>
+returns the client IP address.
+</tag-desc>
+
 <tag-name><literal>$r->request_body</literal></tag-name>
 <tag-desc>
 returns the client request body if it has not been
@@ -356,14 +366,15 @@ should be enabled.
 returns the client request HTTP method.
 </tag-desc>
 
-<tag-name><literal>$r->remote_addr</literal></tag-name>
+<tag-name>
+    <literal>$r->send_http_header([<value>type</value>])</literal>
+</tag-name>
 <tag-desc>
-returns the client IP address.
-</tag-desc>
-
-<tag-name><literal>$r->flush</literal></tag-name>
-<tag-desc>
-immediately sends data to the client.
+sends the response header to the client.
+The optional <value>type</value> parameter sets the value of
+the <header>Content-Type</header> response header field.
+If the value is an empty string, the <header>Content-Type</header>
+header field will not be sent.
 </tag-desc>
 
 <tag-name>
@@ -380,22 +391,6 @@ has completed.
 </tag-desc>
 
 <tag-name>
-    <literal>$r->send_http_header([<value>type</value>])</literal>
-</tag-name>
-<tag-desc>
-sends the response header to the client.
-The optional <value>type</value> parameter sets the value of
-the <header>Content-Type</header> response header field.
-If the value is an empty string, the <header>Content-Type</header>
-header field will not be sent.
-</tag-desc>
-
-<tag-name><literal>$r->status(<value>code</value>)</literal></tag-name>
-<tag-desc>
-sets a response code.
-</tag-desc>
-
-<tag-name>
     <literal>$r->sleep(<value>milliseconds</value>,
     <value>handler</value>)</literal>
 </tag-name>
@@ -438,6 +433,11 @@ 1;
 </example>
 </tag-desc>
 
+<tag-name><literal>$r->status(<value>code</value>)</literal></tag-name>
+<tag-desc>
+sets a response code.
+</tag-desc>
+
 <tag-name><literal>$r->unescape(<value>text</value>)</literal></tag-name>
 <tag-desc>
 decodes a text encoded in the “%XX” form.
diff --git a/xml/ru/docs/http/ngx_http_perl_module.xml b/xml/ru/docs/http/ngx_http_perl_module.xml
--- a/xml/ru/docs/http/ngx_http_perl_module.xml
+++ b/xml/ru/docs/http/ngx_http_perl_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_perl_module"
         link="/ru/docs/http/ngx_http_perl_module.html"
         lang="ru"
-        rev="8">
+        rev="9">
 
 <section id="summary">
 
@@ -220,16 +220,31 @@ 1;
 <para>
 <list type="tag">
 
+<tag-name><literal>$r->allow_ranges</literal></tag-name>
+<tag-desc>
+разрешает использовать диапазоны байт (byte ranges) при передаче ответа.
+</tag-desc>
+
 <tag-name><literal>$r->args</literal></tag-name>
 <tag-desc>
 возвращает аргументы запроса.
 </tag-desc>
 
+<tag-name><literal>$r->discard_request_body</literal></tag-name>
+<tag-desc>
+указывает nginx игнорировать тело запроса.
+</tag-desc>
+
 <tag-name><literal>$r->filename</literal></tag-name>
 <tag-desc>
 возвращает имя файла, соответствующее URI запроса.
 </tag-desc>
 
+<tag-name><literal>$r->flush</literal></tag-name>
+<tag-desc>
+немедленно передаёт данные клиенту.
+</tag-desc>
+
 <tag-name>
     <literal>$r->has_request_body(<value>обработчик</value>)</literal>
 </tag-name>
@@ -276,16 +291,6 @@ 1;
 </example>
 </tag-desc>
 
-<tag-name><literal>$r->allow_ranges</literal></tag-name>
-<tag-desc>
-разрешает использовать диапазоны байт (byte ranges) при передаче ответа.
-</tag-desc>
-
-<tag-name><literal>$r->discard_request_body</literal></tag-name>
-<tag-desc>
-указывает nginx игнорировать тело запроса.
-</tag-desc>
-
 <tag-name><literal>$r->header_in(<value>поле</value>)</literal></tag-name>
 <tag-desc>
 возвращает значение заданного поля в заголовке запроса клиента.
@@ -331,6 +336,11 @@ 1;
 метод передаёт клиенту данные.
 </tag-desc>
 
+<tag-name><literal>$r->remote_addr</literal></tag-name>
+<tag-desc>
+возвращает IP-адрес клиента.
+</tag-desc>
+
 <tag-name><literal>$r->request_body</literal></tag-name>
 <tag-desc>
 возвращает тело запроса клиента при условии,
@@ -356,14 +366,15 @@ 1;
 возвращает HTTP-метод запроса клиента.
 </tag-desc>
 
-<tag-name><literal>$r->remote_addr</literal></tag-name>
+<tag-name>
+    <literal>$r->send_http_header([<value>тип</value>])</literal>
+</tag-name>
 <tag-desc>
-возвращает IP-адрес клиента.
-</tag-desc>
-
-<tag-name><literal>$r->flush</literal></tag-name>
-<tag-desc>
-немедленно передаёт данные клиенту.
+передаёт клиенту заголовок ответа.
+Необязательный параметр <value>тип</value> устанавливает значение поля
+<header>Content-Type</header> в заголовке ответа.
+Пустая строка в качестве типа запрещает передачу поля
+<header>Content-Type</header>.
 </tag-desc>
 
 <tag-name>
@@ -380,22 +391,6 @@ 1;
 </tag-desc>
 
 <tag-name>
-    <literal>$r->send_http_header([<value>тип</value>])</literal>
-</tag-name>
-<tag-desc>
-передаёт клиенту заголовок ответа.
-Необязательный параметр <value>тип</value> устанавливает значение поля
-<header>Content-Type</header> в заголовке ответа.
-Пустая строка в качестве типа запрещает передачу поля
-<header>Content-Type</header>.
-</tag-desc>
-
-<tag-name><literal>$r->status(<value>код</value>)</literal></tag-name>
-<tag-desc>
-устанавливает код ответа.
-</tag-desc>
-
-<tag-name>
     <literal>$r->sleep(<value>миллисекунды</value>,
     <value>обработчик</value>)</literal>
 </tag-name>
@@ -438,6 +433,11 @@ 1;
 </example>
 </tag-desc>
 
+<tag-name><literal>$r->status(<value>код</value>)</literal></tag-name>
+<tag-desc>
+устанавливает код ответа.
+</tag-desc>
+
 <tag-name><literal>$r->unescape(<value>текст</value>)</literal></tag-name>
 <tag-desc>
 декодирует текст, заданный в виде “%XX”.