From: William Lallemand <wlallemand@haproxy.org>
Date: Mon, 4 Sep 2023 14:49:59 +0000 (+0200)
Subject: DOC: configuration: update examples for req.ver
X-Git-Tag: v2.9-dev5~64
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=637306c86daa6e774f96114c66cd590131710698;p=thirdparty%2Fhaproxy.git

DOC: configuration: update examples for req.ver

Update the documentation for the req.ver sample fetch.

Could be backported as far as 2.6.
---

diff --git a/doc/configuration.txt b/doc/configuration.txt
index 3158ec8d20..245316060b 100644
--- a/doc/configuration.txt
+++ b/doc/configuration.txt
@@ -22407,8 +22407,14 @@ req.hdr_names([<delim>]) : string
 req.ver : string
 req_ver : string (deprecated)
   Returns the version string from the HTTP request, for example "1.1". This can
-  be useful for logs, but is mostly there for ACL. Some predefined ACL already
-  check for versions 1.0 and 1.1.
+  be useful for ACL. For logs use the "%HV" log variable. Some predefined ACL
+  already check for versions 1.0 and 1.1.
+
+  Common values are "1.0", "1.1", "2.0" or "3.0".
+
+  In the case of http/2 and http/3, the value is not extracted from the HTTP
+  version in the request line but is determined by the negociated protocol
+  version.
 
   ACL derivatives :
     req.ver : exact string match