From: Willy Tarreau <w@1wt.eu>
Date: Wed, 30 Sep 2026 12:23:23 +0000 (+0200)
Subject: DOC: config: fix doc for hex2i() converter on unparsable input
X-Git-Tag: v3.5-dev8~76
X-Git-Url: https://git.kaiwu.me/?a=commitdiff_plain;h=5247b063b69857df9c5f526827e9c21127f0fd20;p=haproxy.git

DOC: config: fix doc for hex2i() converter on unparsable input

The doc said the converter would return zero, which is wrong, it fails
to return (i.e. no confusion possible with zero).
---

diff --git a/doc/configuration.txt b/doc/configuration.txt
index 7984fd423..0122ea301 100644
--- a/doc/configuration.txt
+++ b/doc/configuration.txt
@@ -22063,7 +22063,9 @@ hex
 
 hex2i
   Converts a hex string containing two hex digits per input byte to an
-  integer. If the input value cannot be converted, then zero is returned.
+  integer. If the input value contains a character which is not a
+  hexadecimal digit, the converter fails and returns nothing, which makes it
+  possible to differentiate an invalid input from a valid zero.
 
 hmac(<algorithm>,<key>)
   Converts a binary input sample to a message authentication code with the given