fail.d: tweak the description

Reviewed-by: Daniel Gustafsson
Suggested-by: Robert Charles Muir
Ref: https://twitter.com/rcmuir/status/1514915401574010887

Closes #8714

diff --git a/docs/cmdline-opts/fail.d b/docs/cmdline-opts/fail.d
index 47adafbb9bcd6bc8f89b2cf7228de18766afe5d1..e7a9f9aec17c941cdc4fb485b3e60effb559e2e4 100644 (file)
--- a/docs/cmdline-opts/fail.d
+++ b/docs/cmdline-opts/fail.d
@@ -1,17 +1,17 @@
 Long: fail
 Short: f
 Protocols: HTTP
-Help: Fail silently (no output at all) on HTTP errors
+Help: Fail fast with no output on HTTP errors
 See-also: fail-with-body
 Category: important http
 Example: --fail $URL
 Added: 4.0
 ---
-Fail silently (no output at all) on server errors. This is mostly done to
-enable scripts etc to better deal with failed attempts. In normal cases
-when an HTTP server fails to deliver a document, it returns an HTML document
-stating so (which often also describes why and more). This flag will prevent
-curl from outputting that and return error 22.
+Fail fast with no output at all on server errors. This is useful to enable
+scripts and users to better deal with failed attempts. In normal cases when an
+HTTP server fails to deliver a document, it returns an HTML document stating
+so (which often also describes why and more). This flag will prevent curl from
+outputting that and return error 22.
 
 This method is not fail-safe and there are occasions where non-successful
 response codes will slip through, especially when authentication is involved

diff --git a/src/tool_listhelp.c b/src/tool_listhelp.c
index 115786b07c471a50f980ea68a7bdc5d5143f3653..93b7b899ea542f4d4576535017b72539d00e3790 100644 (file)
--- a/src/tool_listhelp.c
+++ b/src/tool_listhelp.c
@@ -179,7 +179,7 @@ const struct helptxt helptext[] = {
    "How long to wait for 100-continue",
    CURLHELP_HTTP},
   {"-f, --fail",
-   "Fail silently (no output at all) on HTTP errors",
+   "Fail fast with no output on HTTP errors",
    CURLHELP_IMPORTANT | CURLHELP_HTTP},
   {"    --fail-early",
    "Fail on first transfer error, do not continue",

diff --git a/tests/data/test1461 b/tests/data/test1461
index 847f8d1fb68f4ca6c22751611db8244d655b0d88..65797a405a2bc39753a5346585efeb1deb8cd530 100644 (file)
--- a/tests/data/test1461
+++ b/tests/data/test1461
@@ -33,7 +33,7 @@ curl important --help
 <stdout mode="text">
 Usage: curl [options...] <url>
  -d, --data <data>          HTTP POST data
- -f, --fail                 Fail silently (no output at all) on HTTP errors
+ -f, --fail                 Fail fast with no output on HTTP errors
  -h, --help <category>      Get help for commands
  -i, --include              Include protocol response headers in the output
  -o, --output <file>        Write to file instead of stdout