curl/docs/cmdline-opts/cookie-jar.d

Short: c
Long: cookie-jar
Arg: <filename>
Protocols: HTTP
Help: Write cookies to <filename> after operation
Category: http
Example: -c store-here.txt $URL
Example: -c store-here.txt -b read-these $URL
Added: 7.9
---
Specify to which file you want curl to write all cookies after a completed
operation. Curl writes all cookies from its in-memory cookie storage to the
given file at the end of operations. If no cookies are known, no data will be
written. The file will be written using the Netscape cookie file format. If
you set the file name to a single dash, "-", the cookies will be written to
stdout.

This command line option will activate the cookie engine that makes curl
record and use cookies. Another way to activate it is to use the --cookie
option.

If the cookie jar cannot be created or written to, the whole curl operation
will not fail or even report an error clearly. Using --verbose will get a
warning displayed, but that is the only visible feedback you get about this
possibly lethal situation.

If this option is used several times, the last specified file name will be
used.
cmdline-opts: first test version of a new man page generator kit See MANPAGE.md for the description of how this works. Each command line option is now described in a separate .d file. 2016-11-14 06:40:12 +08:00			`Short: c`
			`Long: cookie-jar`
			`Arg: <filename>`
			`Protocols: HTTP`
cmdline-opts: support generating the --help output 2016-11-15 16:08:50 +08:00			`Help: Write cookies to <filename> after operation`
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: http`
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: -c store-here.txt $URL`
			`Example: -c store-here.txt -b read-these $URL`
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.9`
cmdline-opts: first test version of a new man page generator kit See MANPAGE.md for the description of how this works. Each command line option is now described in a separate .d file. 2016-11-14 06:40:12 +08:00			`---`
			`Specify to which file you want curl to write all cookies after a completed`
			`operation. Curl writes all cookies from its in-memory cookie storage to the`
			`given file at the end of operations. If no cookies are known, no data will be`
			`written. The file will be written using the Netscape cookie file format. If`
			`you set the file name to a single dash, "-", the cookies will be written to`
			`stdout.`

			`This command line option will activate the cookie engine that makes curl`
			`record and use cookies. Another way to activate it is to use the --cookie`
			`option.`

docs: reduce/avoid English contractions You're => You are Hasn't => Has not Doesn't => Does not Don't => Do not You'll => You will etc Closes #7930 2021-10-31 23:34:44 +08:00			`If the cookie jar cannot be created or written to, the whole curl operation`
			`will not fail or even report an error clearly. Using --verbose will get a`
			`warning displayed, but that is the only visible feedback you get about this`
			`possibly lethal situation.`
cmdline-opts: first test version of a new man page generator kit See MANPAGE.md for the description of how this works. Each command line option is now described in a separate .d file. 2016-11-14 06:40:12 +08:00
			`If this option is used several times, the last specified file name will be`
			`used.`