curl/docs/cmdline-opts/ftp-method.d

c: Copyright (C) 1998 - 2022, Daniel Stenberg, <daniel@haxx.se>, et al.
SPDX-License-Identifier: curl
Long: ftp-method
Arg: <method>
Help: Control CWD usage
Protocols: FTP
Added: 7.15.1
Category: ftp
Example: --ftp-method multicwd ftp://example.com/dir1/dir2/file
Example: --ftp-method nocwd ftp://example.com/dir1/dir2/file
Example: --ftp-method singlecwd ftp://example.com/dir1/dir2/file
See-also: list-only
---
Control what method curl should use to reach a file on an FTP(S)
server. The method argument should be one of the following alternatives:
.RS
.IP multicwd
curl does a single CWD operation for each path part in the given URL. For deep
hierarchies this means many commands. This is how RFC 1738 says it should
be done. This is the default but the slowest behavior.
.IP nocwd
curl does no CWD at all. curl will do SIZE, RETR, STOR etc and give a full
path to the server for all these commands. This is the fastest behavior.
.IP singlecwd
curl does one CWD with the full target directory and then operates on the file
\&"normally" (like in the multicwd case). This is somewhat more standards
compliant than 'nocwd' but without the full penalty of 'multicwd'.
.RE
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			`c: Copyright (C) 1998 - 2022, Daniel Stenberg, <daniel@haxx.se>, et al.`
			`SPDX-License-Identifier: curl`
cmdline-docs: more options converted over 2016-11-16 06:44:58 +08:00			`Long: ftp-method`
			`Arg: <method>`
			`Help: Control CWD usage`
			`Protocols: FTP`
			`Added: 7.15.1`
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: ftp`
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: --ftp-method multicwd ftp://example.com/dir1/dir2/file`
			`Example: --ftp-method nocwd ftp://example.com/dir1/dir2/file`
			`Example: --ftp-method singlecwd ftp://example.com/dir1/dir2/file`
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: list-only`
cmdline-docs: more options converted over 2016-11-16 06:44:58 +08:00			`---`
			`Control what method curl should use to reach a file on an FTP(S)`
			`server. The method argument should be one of the following alternatives:`
			`.RS`
			`.IP multicwd`
			`curl does a single CWD operation for each path part in the given URL. For deep`
docs: reduce use of "very" "Very" should be avoided in most texts. If intensifiers are needed, try find better words instead. Closes #7936 2021-11-01 20:43:11 +08:00			`hierarchies this means many commands. This is how RFC 1738 says it should`
cmdline-docs: more options converted over 2016-11-16 06:44:58 +08:00			`be done. This is the default but the slowest behavior.`
			`.IP nocwd`
			`curl does no CWD at all. curl will do SIZE, RETR, STOR etc and give a full`
			`path to the server for all these commands. This is the fastest behavior.`
			`.IP singlecwd`
			`curl does one CWD with the full target directory and then operates on the file`
			`\&"normally" (like in the multicwd case). This is somewhat more standards`
			`compliant than 'nocwd' but without the full penalty of 'multicwd'.`
			`.RE`