DOC: configuration: explain quotes and spaces in conditional blocks
authorWilly Tarreau <w@1wt.eu>
Wed, 20 Nov 2024 07:44:39 +0000 (08:44 +0100)
committerChristopher Faulet <cfaulet@haproxy.com>
Fri, 22 Nov 2024 14:45:37 +0000 (15:45 +0100)
commitb92987afa795f23ab95f35933c493e5751b0ac18
tree76ac68e9744010b9d7d21f60e574e15e63382f85
parentc693da8896d1b3515607966f512618b4b441efc4
DOC: configuration: explain quotes and spaces in conditional blocks

Conditional blocks inherit the same tokenizer and argument parser as
the rest of the configuration, but are also silently concatenated
around groups of spaces and tabs. This can lead to subtle failures
for configs containing spaces around commas and parenthesis, where
a string comparison might silently fail for example. Let's better
document this particular case.

Thanks to Valentine for analysing and reporting the problem.

This can be backported to 2.4.

(cherry picked from commit da1620b3175c63b768a8537951667885fef77e8c)
Signed-off-by: Christopher Faulet <cfaulet@haproxy.com>
doc/configuration.txt