From 36e09dc302d0bc70b1a314181cd6b5756d74217d Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Fri, 15 Apr 2022 23:50:34 +0200 Subject: [PATCH] fail.d: tweak the description Reviewed-by: Daniel Gustafsson Suggested-by: Robert Charles Muir Ref: https://twitter.com/rcmuir/status/1514915401574010887 Closes #8714 --- docs/cmdline-opts/fail.d | 12 ++++++------ src/tool_listhelp.c | 2 +- tests/data/test1461 | 2 +- 3 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/cmdline-opts/fail.d b/docs/cmdline-opts/fail.d index 47adafbb9b..e7a9f9aec1 100644 --- 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 115786b07c..93b7b899ea 100644 --- 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 847f8d1fb6..65797a405a 100644 --- a/tests/data/test1461 +++ b/tests/data/test1461 @@ -33,7 +33,7 @@ curl important --help Usage: curl [options...] -d, --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 Get help for commands -i, --include Include protocol response headers in the output -o, --output Write to file instead of stdout -- 2.47.3