[PATCH] Fix the $r request object methods order

[Sergey A. Osokin]

# HG changeset patch
# User Sergey A. Osokin <osa at FreeBSD.org.ru>
# Date 1770044238 -10800
#      Mon Feb 02 17:57:18 2026 +0300
# Node ID 6589496596a1a7c180c66972e43ceca26504e66e
# Parent  c6cbc552bd6a56e79276518253637c71628cbe16
Fix the $r request object methods order

diff -r c6cbc552bd6a -r 6589496596a1 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 17:57:18 2026 +0300
@@ -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.