From ddd6fc7ce65a0171cdb1c9ee87a978bd164a1d90 Mon Sep 17 00:00:00 2001
From: Yaroslav Zhuravlev <y.zhuravlev@f5.com>
Date: Mon, 27 Oct 2025 18:20:11 +0000
Subject: [PATCH] Documented "$request_port" and "$is_request_port".

---
 xml/en/docs/http/ngx_http_core_module.xml | 18 +++++++++++++++++-
 xml/ru/docs/http/ngx_http_core_module.xml | 18 +++++++++++++++++-
 2 files changed, 34 insertions(+), 2 deletions(-)

diff --git a/xml/en/docs/http/ngx_http_core_module.xml b/xml/en/docs/http/ngx_http_core_module.xml
index 1ede3dcb..fa68dca5 100644
--- a/xml/en/docs/http/ngx_http_core_module.xml
+++ b/xml/en/docs/http/ngx_http_core_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_core_module"
         link="/en/docs/http/ngx_http_core_module.html"
         lang="en"
-        rev="109">
+        rev="110">
 
 <section id="directives" name="Directives">
 
@@ -3219,6 +3219,13 @@ or an empty string otherwise
 or an empty string otherwise
 </tag-desc>
 
+<tag-name id="var_is_request_port"><var>$is_request_port</var></tag-name>
+<tag-desc>
+“<literal>:</literal>” if
+<link id="var_request_port">$request_port</link> is non-empty,
+or an empty string otherwise (1.29.3)
+</tag-desc>
+
 <tag-name id="var_limit_rate"><var>$limit_rate</var></tag-name>
 <tag-desc>
 setting this variable enables response rate limiting;
@@ -3493,6 +3500,15 @@ request method, usually
 “<literal>GET</literal>” or “<literal>POST</literal>”
 </tag-desc>
 
+<tag-name id="var_request_port"><var>$request_port</var></tag-name>
+<tag-desc>
+in this order of precedence:
+port number from the
+<link url="https://datatracker.ietf.org/doc/html/rfc9110#section-4.2.1">URI</link>
+authority component, or
+port number from the <header>Host</header> request header field (1.29.3)
+</tag-desc>
+
 <tag-name id="var_request_time"><var>$request_time</var></tag-name>
 <tag-desc>
 request processing time in seconds with a milliseconds resolution
diff --git a/xml/ru/docs/http/ngx_http_core_module.xml b/xml/ru/docs/http/ngx_http_core_module.xml
index bd210de6..4d0bfe1e 100644
--- a/xml/ru/docs/http/ngx_http_core_module.xml
+++ b/xml/ru/docs/http/ngx_http_core_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_core_module"
         link="/ru/docs/http/ngx_http_core_module.html"
         lang="ru"
-        rev="109">
+        rev="110">
 
 <section id="directives" name="Директивы">
 
@@ -3214,6 +3214,13 @@ cookie <value>имя</value>
 и пустая строка, если их нет
 </tag-desc>
 
+<tag-name id="var_is_request_port"><var>$is_request_port</var></tag-name>
+<tag-desc>
+“<literal>:</literal>”, если значение
+<link id="var_request_port">$request_port</link> непустое,
+либо пустая строка (1.29.3)
+</tag-desc>
+
 <tag-name id="var_limit_rate"><var>$limit_rate</var></tag-name>
 <tag-desc>
 установка этой переменной позволяет ограничивать скорость
@@ -3483,6 +3490,15 @@ scgi_pass_request_body off</link>
 “<literal>GET</literal>” или “<literal>POST</literal>”
 </tag-desc>
 
+<tag-name id="var_request_port"><var>$request_port</var></tag-name>
+<tag-desc>
+в порядке приоритета:
+номер порта из компонента
+<link url="https://datatracker.ietf.org/doc/html/rfc9110#section-4.2.1">URI</link>
+authority, или
+номер порта из поля <header>Host</header> заголовка запроса (1.29.3)
+</tag-desc>
+
 <tag-name id="var_request_time"><var>$request_time</var></tag-name>
 <tag-desc>
 время обработки запроса в секундах с точностью до миллисекунд