mirror of
https://github.com/curl/curl.git
synced 2024-12-09 06:30:06 +08:00
68784d73c3
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
22 lines
896 B
Makefile
22 lines
896 B
Makefile
Long: remote-header-name
|
|
Short: J
|
|
Protocols: HTTP
|
|
Help: Use the header-provided filename
|
|
Category: output
|
|
Example: -OJ https://example.com/file
|
|
---
|
|
This option tells the --remote-name option to use the server-specified
|
|
Content-Disposition filename instead of extracting a filename from the URL.
|
|
|
|
If the server specifies a file name and a file with that name already exists
|
|
in the current working directory it will not be overwritten and an error will
|
|
occur. If the server doesn't specify a file name then this option has no
|
|
effect.
|
|
|
|
There's no attempt to decode %-sequences (yet) in the provided file name, so
|
|
this option may provide you with rather unexpected file names.
|
|
|
|
**WARNING**: Exercise judicious use of this option, especially on Windows. A
|
|
rogue server could send you the name of a DLL or other file that could possibly
|
|
be loaded automatically by Windows or some third party software.
|