curl/docs/cmdline-opts/etag-save.d

Long: etag-save
Arg: <file>
Help: Parse ETag from a request and save it to a file
Protocols: HTTP
Added: 7.68.0
Category: http
---
This option saves an HTTP ETag to the specified file. An ETag is a
caching related header, usually returned in a response.

If no ETag is sent by the server, an empty file is created.
curl: two new command line options for etags --etag-compare and --etag-save Suggested-by: Paul Hoffman Fixes #4277 Closes #4543 2019-10-30 04:43:14 -04:00			`Long: etag-save`
			`Arg: <file>`
			`Help: Parse ETag from a request and save it to a file`
			`Protocols: HTTP`
docs: add "added: 7.68.0" to the --etag-* docs 2019-12-02 05:22:32 -05:00			`Added: 7.68.0`
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 08:15:04 -04:00			`Category: http`
curl: two new command line options for etags --etag-compare and --etag-save Suggested-by: Paul Hoffman Fixes #4277 Closes #4543 2019-10-30 04:43:14 -04:00			`---`
docs: make the documentation for --etag-save match the program behaviour When using curl with the option `--etag-save` I expected it to save the ETag without its surrounding quotes, as stated by the documentation in the repository and by the generated man pages. My first endeavour was to fix the program, but while investigating the history of the relevant parts, I discovered that curl once saved the ETag without the quotes. This was undone by Daniel Stenberg in commit `98c94596f5928840177b6bd3c7b0f0dd03a431af`, therefore I decided that in this case the documentation should be adjusted to match the behaviour of curl. The changed save behaviour also made parts of the `--etag-compare` documentation wrong or superfluous, so I adjusted those accordingly. Closes #7429 2021-07-18 04:42:54 -04:00			`This option saves an HTTP ETag to the specified file. An ETag is a`
			`caching related header, usually returned in a response.`
curl: two new command line options for etags --etag-compare and --etag-save Suggested-by: Paul Hoffman Fixes #4277 Closes #4543 2019-10-30 04:43:14 -04:00
docs: make the documentation for --etag-save match the program behaviour When using curl with the option `--etag-save` I expected it to save the ETag without its surrounding quotes, as stated by the documentation in the repository and by the generated man pages. My first endeavour was to fix the program, but while investigating the history of the relevant parts, I discovered that curl once saved the ETag without the quotes. This was undone by Daniel Stenberg in commit `98c94596f5928840177b6bd3c7b0f0dd03a431af`, therefore I decided that in this case the documentation should be adjusted to match the behaviour of curl. The changed save behaviour also made parts of the `--etag-compare` documentation wrong or superfluous, so I adjusted those accordingly. Closes #7429 2021-07-18 04:42:54 -04:00			`If no ETag is sent by the server, an empty file is created.`