Daniel Stenberg
76d6e719d9
docs: address proselint nits
...
- avoid exclamation marks
- use consistent number of spaces after periods: one
- avoid clichés
- avoid using 'very'
Closes #8060
2021-11-26 14:27:07 +01:00
Daniel Stenberg
ddaa85893d
curl.1: require "see also" for every documented option
...
gen.pl now generates a warning if the "See Also" field is not filled in for a
command line option
All command line options now provide one or more related options. 167
"See alsos" added!
Closes #8019
2021-11-15 23:06:41 +01:00
Daniel Stenberg
68784d73c3
curl.1: provide examples for each option
...
The file format for each option now features a "Example:" header that
can provide one or more examples that get rendered appropriately in the
output. All options MUST have at least one example or gen.pl complains
at build-time.
This fix also does a few other minor format and consistency cleanups.
Closes #7654
2021-09-01 14:02:43 +02:00
Jay Satiro
21445a76df
retry.d: Clarify transient 5xx HTTP response codes
...
- Clarify the only 5xx response codes that are treated as transient are
500, 502, 503 and 504.
Prior to this change it said it treated all 5xx as transient, but the
code says otherwise.
Ref: https://github.com/curl/curl/blob/curl-7_75_0/src/tool_operate.c#L462-L495
Closes https://github.com/curl/curl/pull/6724
2021-03-12 03:16:22 -05:00
Daniel Stenberg
aa71750687
cmdline-opts/retry.d: mention response code 429 as well
...
Reported-by: Cherish98
Bug: https://curl.se/mail/archive-2020-12/0018.html
2021-01-02 11:51:55 +01:00
Emil Engler
5dddc1dc7e
docs: add categories to all cmdline opts
...
Adapted gen.pl with 'listcats'
This commit is a part of "--help me if you can"
Closes #5680
2020-09-04 15:38:14 +02:00
Daniel Stenberg
640b9733de
curl: make use of CURLINFO_RETRY_AFTER when retrying
...
If a Retry-After: header was used in the response, that value overrides
other retry timing options.
Fixes #3794
Closes #4195
2019-08-07 14:45:44 +02:00
Jay Satiro
351c0f3a55
tool_operate: Add http code 408 to transient list for --retry
...
- Treat 408 request timeout as transient so that curl will retry the
request if --retry was used.
Closes #2925
2018-09-03 13:19:14 +02:00
Daniel Stenberg
5c4a526388
cmdline-opts: more command line options documented
...
Moved over to the new format
2016-11-28 00:50:25 +01:00