[PATCH] Fixed order of perl request object methods
Sergey A. Osokin
osa at FreeBSD.org.ru
Mon Feb 2 19:42:22 UTC 2026
# HG changeset patch
# User Sergey A. Osokin <osa at FreeBSD.org.ru>
# Date 1770061280 -10800
# Mon Feb 02 22:41:20 2026 +0300
# Node ID d83d66357a77d374475c9db75b5487b68a380178
# Parent c6cbc552bd6a56e79276518253637c71628cbe16
Fixed order of perl request object methods.
diff -r c6cbc552bd6a -r d83d66357a77 xml/en/docs/http/ngx_http_perl_module.xml
--- a/xml/en/docs/http/ngx_http_perl_module.xml Tue Dec 16 16:20:31 2025 +0300
+++ b/xml/en/docs/http/ngx_http_perl_module.xml Mon Feb 02 22:41:20 2026 +0300
@@ -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 @@
<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 @@
</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 @@
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 @@
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 @@
</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 @@
</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 -r c6cbc552bd6a -r d83d66357a77 xml/ru/docs/http/ngx_http_perl_module.xml
--- a/xml/ru/docs/http/ngx_http_perl_module.xml Tue Dec 16 16:20:31 2025 +0300
+++ b/xml/ru/docs/http/ngx_http_perl_module.xml Mon Feb 02 22:41:20 2026 +0300
@@ -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 @@
<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 @@
</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 @@
метод передаёт клиенту данные.
</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 @@
возвращает 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 @@
</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 @@
</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”.
More information about the nginx-devel
mailing list