DOC: config: retry-on list is space-delimited
authorLukas Tribus <lukas@ltri.eu>
Wed, 8 Dec 2021 10:33:01 +0000 (11:33 +0100)
committerWilly Tarreau <w@1wt.eu>
Fri, 24 Dec 2021 16:58:44 +0000 (17:58 +0100)
We are using comma-delimited list for init-addr for example, let's
document that this is space-delimited to avoid the guessing game.

(cherry picked from commit de16008c298d87b212807b9bb42d27f675be732b)
Signed-off-by: Christopher Faulet <cfaulet@haproxy.com>
(cherry picked from commit d9a0d71290259e4502bf44d7e246a6acc516ddb1)
Signed-off-by: Christopher Faulet <cfaulet@haproxy.com>
(cherry picked from commit bb474ff83b557944ef1d5715dfa9c8fafeae444c)
Signed-off-by: Willy Tarreau <w@1wt.eu>

doc/configuration.txt

index aec3052..63d0d32 100644 (file)
@@ -9534,17 +9534,18 @@ retries <value>
   See also : "option redispatch"
 
 
-retry-on [list of keywords]
+retry-on [space-delimited list of keywords]
   Specify when to attempt to automatically retry a failed request.
   This setting is only valid when "mode" is set to http and is silently ignored
   otherwise.
   May be used in sections:    defaults | frontend | listen | backend
                                  yes   |    no    |   yes  |   yes
   Arguments :
-    <keywords>  is a list of keywords or HTTP status codes, each representing a
-                type of failure event on which an attempt to retry the request
-                is desired. Please read the notes at the bottom before changing
-                this setting. The following keywords are supported :
+    <keywords>  is a space-delimited list of keywords or HTTP status codes, each
+                representing a type of failure event on which an attempt to
+                retry the request is desired. Please read the notes at the
+                bottom before changing this setting. The following keywords are
+                supported :
 
       none              never retry
 
@@ -9616,6 +9617,9 @@ retry-on [list of keywords]
 
   The default is "conn-failure".
 
+  Example:
+    retry-on 503 504
+
   See also: "retries", "option redispatch", "tune.bufsize"
 
 server <name> <address>[:[port]] [param*]