curl/docs/cmdline-opts/alt-svc.d

c: Copyright (C) 1998 - 2022, Daniel Stenberg, <daniel@haxx.se>, et al.
SPDX-License-Identifier: curl
Long: alt-svc
Arg: <file name>
Protocols: HTTPS
Help: Enable alt-svc with this cache file
Added: 7.64.1
Category: http
See-also: resolve connect-to
Example: --alt-svc svc.txt $URL
Multi: append
---
This option enables the alt-svc parser in curl. If the file name points to an
existing alt-svc cache file, that will be used. After a completed transfer,
the cache will be saved to the file name again if it has been modified.

Specify a "" file name (zero length) to avoid loading/saving and make curl
just handle the cache in memory.

If this option is used several times, curl will load contents from all the
files but the last one will be used for saving.
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`
alt-svc: the curl command line bits 2019-03-03 18:17:52 +08:00			`Long: alt-svc`
			`Arg: <file name>`
			`Protocols: HTTPS`
			`Help: Enable alt-svc with this cache file`
			`Added: 7.64.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: http`
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: resolve connect-to`
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: --alt-svc svc.txt $URL`
cmdline/docs: add a required 'multi' keyword for each option The keyword specifies how option works when specified multiple times: - single: the last provided value replaces the earlier ones - append: it supports being provided multiple times - boolean: on/off values - mutex: flag-like option that disable anoter flag The 'gen.pl' script then outputs the proper and unified language for each option's multi-use behavior in the generated man page. The multi: header is requires in each .d file and will cause build error if missing or set to an unknown value. Closes #9759 2022-10-18 16:39:43 +08:00			`Multi: append`
alt-svc: the curl command line bits 2019-03-03 18:17:52 +08:00			`---`
			`This option enables the alt-svc parser in curl. If the file name points to an`
			`existing alt-svc cache file, that will be used. After a completed transfer,`
			`the cache will be saved to the file name again if it has been modified.`

documentation: Fix several typos Closes #3724 Reviewed-by: Jakub Zakrzewski Reviewed-by: Daniel Gustafsson 2019-04-03 23:16:18 +08:00			`Specify a "" file name (zero length) to avoid loading/saving and make curl`
alt-svc: the curl command line bits 2019-03-03 18:17:52 +08:00			`just handle the cache in memory.`

			`If this option is used several times, curl will load contents from all the`
cleanup: fix typos and wording in docs and comments Closes #4869 Reviewed-by: Emil Engler and Daniel Gustafsson 2020-02-02 16:49:28 +08:00			`files but the last one will be used for saving.`