From 050aa803096f6d745a173d5810c65dd829f2f8b2 Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Sun, 13 Nov 2016 23:40:12 +0100 Subject: 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. --- docs/cmdline-opts/cookie-jar.d | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 docs/cmdline-opts/cookie-jar.d (limited to 'docs/cmdline-opts/cookie-jar.d') diff --git a/docs/cmdline-opts/cookie-jar.d b/docs/cmdline-opts/cookie-jar.d new file mode 100644 index 000000000..50bfa61c0 --- /dev/null +++ b/docs/cmdline-opts/cookie-jar.d @@ -0,0 +1,23 @@ +Short: c +Long: cookie-jar +Arg: +Protocols: HTTP +--- +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 can't be created or written to, the whole curl operation +won't 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. -- cgit v1.2.3