mirror/curl
2
0
Fork 0
mirror of https://github.com/curl/curl.git synced 2024-12-27 06:59:43 +08:00
Code Issues Packages Projects Releases Wiki Activity
28f8440c0b
curl/docs/cmdline-opts/remote-header-name.d

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

35 lines
1.4 KiB
D
Raw Normal View History

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
cmdline-docs: more options converted over
2016-11-16 06:44:58 +08:00
Long: remote-header-name
Short: J
Protocols: HTTP
Help: Use the header-provided filename
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-07-13 20:15:04 +08:00
Category: output
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-08-31 22:37:14 +08:00
Example: -OJ https://example.com/file
cmdline-opts: made the 'Added:' field mandatory Since "too old" versions are no longer included in the generated man page, this field is now mandatory so that it won't be forgotten and then not included in the documentation. Closes #7786
2021-09-28 17:50:07 +08:00
Added: 7.20.0
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 22:58:20 +08:00
See-also: remote-name
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
cmdline-docs: more options converted over
2016-11-16 06:44:58 +08:00
---
This option tells the --remote-name option to use the server-specified
remote-header-name.d: clarify - it strips off the path from the server provided name - it saves in current directory or --output-dir Ref: https://curl.se/mail/archive-2022-01/0032.html Closes #8249
2022-01-09 18:34:37 +08:00
Content-Disposition filename instead of extracting a filename from the URL. If
the server-provided file name contains a path, that will be stripped off
before the file name is used.
The file is saved in the current directory, or in the directory specified with
--output-dir.
cmdline-docs: more options converted over
2016-11-16 06:44:58 +08:00
If the server specifies a file name and a file with that name already exists
remote-header-name.d: clarify - it strips off the path from the server provided name - it saves in current directory or --output-dir Ref: https://curl.se/mail/archive-2022-01/0032.html Closes #8249
2022-01-09 18:34:37 +08:00
in the destination directory, it will not be overwritten and an error will
remote-header-name.d: mention that filename* is not supported and that you can use --clobber to allow overwriting. Ref: #10533 Closes #10555 Co-authored-by: Jay Satiro <raysatiro@yahoo.com>
2023-02-18 17:18:57 +08:00
occur - unless you allow it by using the --clobber option. If the server does
not specify a file name then this option has no effect.
cmdline-docs: more options converted over
2016-11-16 06:44:58 +08:00
docs: rewrite to present tense ... instead of using future tense. + numerous cleanups and improvements + stick to "reuse" not "re-use" + fewer contractions Closes #11713
2023-08-22 23:40:39 +08:00
There is no attempt to decode %-sequences (yet) in the provided file name, so
cmdline-docs: more options converted over
2016-11-16 06:44:58 +08:00
this option may provide you with rather unexpected file names.
remote-header-name.d: mention that filename* is not supported and that you can use --clobber to allow overwriting. Ref: #10533 Closes #10555 Co-authored-by: Jay Satiro <raysatiro@yahoo.com>
2023-02-18 17:18:57 +08:00
This feature uses the name from the "filename" field, it does not yet support
the "filename*" field (filenames with explicit character sets).
docs: make gen.pl support *italic* and **bold** Remove some nroffisms from the cmdline doc files to simplify editing, and instead support this markdown style. Closes #6771
2021-03-22 23:50:57 +08:00
**WARNING**: Exercise judicious use of this option, especially on Windows. A
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 15:46:59 +08:00
rogue server could send you the name of a DLL or other file that could be
loaded automatically by Windows or some third party software.
Reference in New Issue Copy Permalink