documented the current --retry options

1 files changed, 26 insertions, 1 deletions

diff --git a/docs/curl.1 b/docs/curl.1
index 6daef25c3..7392a44c3 100644
--- a/docs/curl.1
+++ b/docs/curl.1
@@ -21,7 +21,7 @@
 .\" * $Id$
 .\" **************************************************************************
 .\"
-.TH curl 1 "19 Oct 2004" "Curl 7.12.3" "Curl Manual"
+.TH curl 1 "2 Nov 2004" "Curl 7.12.3" "Curl Manual"
 .SH NAME
 curl \- transfer a URL
 .SH SYNOPSIS
@@ -723,6 +723,31 @@ remote file, and if that is available make the local file get that same
 timestamp.
 
 If this option is used twice, the second time disables this again.
+.IP "--retry <num>"
+If a transient error is returned when curl tries to perform a transfer, it
+will retry this number of times before giving up. Setting the number to 0
+makes curl do no retries (which is the default).
+
+Transient error means either: timeout, an FTP 5xx response code or a HTTP 5xx
+response code.
+
+When curl is about to retry a transfer, it will first wait one second and then
+for all forthcoming retries it will double the waiting time until it reaches
+10 minutes which then will be the delay between the rest of the retries.
+
+By using \fI--retry-delay\fP you disable this exponential backoff algorithm.
+(Option added in 7.12.3)
+
+If this option is used multiple times, the last occurance decide the amount.
+.IP "--retry-delay <seconds>"
+Make curl sleep this amount of time between each retry when a transfer has
+failed with a transient error (it changes the default backoff time algorithm
+between retries). This option is only interestinf if \fI--retry\fP is also
+used. (Option added in 7.12.3)
+
+Setting the delay to zero will make curl use the default backoff time.
+
+If this option is used multiple times, the last occurance decide the amount.
 .IP "-s/--silent"
 Silent mode. Don't show progress meter or error messages.  Makes
 Curl mute.