curl/docs/cmdline-opts/remove-on-error.d

c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
SPDX-License-Identifier: curl
Long: remove-on-error
Help: Remove output file on errors
See-also: fail
Category: curl
Example: --remove-on-error -o output $URL
Added: 7.83.0
Multi: boolean
---
When curl returns an error when told to save output in a local file, this
option removes that saved file before exiting. This prevents curl from
leaving a partial file in the case of an error during transfer.

If the output is not a file, this option has no effect.
copyright: update all copyright lines and remove year ranges - they are mostly pointless in all major jurisdictions - many big corporations and projects already don't use them - saves us from pointless churn - git keeps history for us - the year range is kept in COPYING checksrc is updated to allow non-year using copyright statements Closes #10205 2023-01-02 20:51:48 +08:00			`c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.`
docs/cmdline-opts: add copyright and license identifier to each file gen.pl now insists on C: and SPDX-License-Identifier: fields to be present in all files. Closes #9002 2022-06-14 06:12:03 +08:00			`SPDX-License-Identifier: curl`
curl: add --remove-on-error If a transfer returns an error, using this option makes curl remove the leftover downloded (partial) local file before exiting. Added test 376 to verify Closes #8503 2022-02-24 17:30:10 +08:00			`Long: remove-on-error`
			`Help: Remove output file on errors`
			`See-also: fail`
			`Category: curl`
			`Example: --remove-on-error -o output $URL`
			`Added: 7.83.0`
cmdline/docs: add a required 'multi' keyword for each option The keyword specifies how option works when specified multiple times: - single: the last provided value replaces the earlier ones - append: it supports being provided multiple times - boolean: on/off values - mutex: flag-like option that disable anoter flag The 'gen.pl' script then outputs the proper and unified language for each option's multi-use behavior in the generated man page. The multi: header is requires in each .d file and will cause build error if missing or set to an unknown value. Closes #9759 2022-10-18 16:39:43 +08:00			`Multi: boolean`
curl: add --remove-on-error If a transfer returns an error, using this option makes curl remove the leftover downloded (partial) local file before exiting. Added test 376 to verify Closes #8503 2022-02-24 17:30:10 +08:00			`---`
			`When curl returns an error when told to save output in a local file, this`
remove-on-error.d: typo Reported-by: Colin Leroy Bug: https://github.com/curl/curl/pull/8503#pullrequestreview-906520081 2022-03-11 05:56:11 +08:00			`option removes that saved file before exiting. This prevents curl from`
curl: add --remove-on-error If a transfer returns an error, using this option makes curl remove the leftover downloded (partial) local file before exiting. Added test 376 to verify Closes #8503 2022-02-24 17:30:10 +08:00			`leaving a partial file in the case of an error during transfer.`

			`If the output is not a file, this option has no effect.`