Daniel Stenberg
8f2fb3cdbd
retry-all-errors.d: make the example complete
...
... as it needs --retry too to work
2021-12-07 10:10:51 +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
a28464ae77
docs: reduce/avoid English contractions
...
You're => You are
Hasn't => Has not
Doesn't => Does not
Don't => Do not
You'll => You will
etc
Closes #7930
2021-11-07 23:16:27 +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
cf9d16b98c
retry-all-errors.d: Explain curl errors versus HTTP response errors
...
- Add a paragraph explaining that curl does not consider HTTP response
errors as curl errors, and how that behavior can be modified by using
--retry and --fail.
The --retry-all-errors doc says "Retry on any error" which some users
may find misleading without the added explanation.
Ref: https://curl.se/docs/faq.html#Why_do_I_get_downloaded_data_eve
Ref: https://curl.se/docs/faq.html#curl_doesn_t_return_error_for_HT
Reported-by: Lawrence Gripper
Fixes https://github.com/curl/curl/issues/6712
Closes https://github.com/curl/curl/pull/6720
2021-03-12 03:15:48 -05: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
Jay Satiro
79d60a9282
retry-all-errors.d: Shorten the summary line
...
Follow-up to b995bb5https://github.com/curl/curl/commit/b995bb5#r39108929
2020-05-12 03:12:55 -04:00
Jay Satiro
b995bb58cb
tool: Add option --retry-all-errors to retry on any error
...
The "sledgehammer" of retrying.
Closes https://github.com/curl/curl/pull/5185
2020-05-12 03:00:15 -04:00
