curl/docs/cmdline-opts/user-agent.d

Short: A
Long: user-agent
Arg: <name>
Help: Send User-Agent <name> to server
Protocols: HTTP
Category: important http
Example: -A "Agent 007" $URL
---
Specify the User-Agent string to send to the HTTP server. To encode blanks in
the string, surround the string with single quote marks. This header can also
be set with the --header or the --proxy-header options.

If you give an empty argument to --user-agent (""), it will remove the header
completely from the request. If you prefer a blank header, you can set it to a
single space (" ").

If this option is used several times, the last one will be used.
cmdline-docs: more options converted over 2016-11-16 06:44:58 +08:00			`Short: A`
			`Long: user-agent`
			`Arg: <name>`
			`Help: Send User-Agent <name> to server`
			`Protocols: HTTP`
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: important 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: -A "Agent 007" $URL`
cmdline-docs: more options converted over 2016-11-16 06:44:58 +08:00			`---`
			`Specify the User-Agent string to send to the HTTP server. To encode blanks in`
user-agent.d:: mention --proxy-header as well Bug: https://github.com/curl/curl/issues/2381 2018-03-16 06:52:43 +08:00			`the string, surround the string with single quote marks. This header can also`
			`be set with the --header or the --proxy-header options.`
cmdline-docs: more options converted over 2016-11-16 06:44:58 +08:00
user-agent.d: spell out what happens given a blank argument Closes #5525 2020-06-05 20:10:52 +08:00			`If you give an empty argument to --user-agent (""), it will remove the header`
			`completely from the request. If you prefer a blank header, you can set it to a`
			`single space (" ").`

cmdline-docs: more options converted over 2016-11-16 06:44:58 +08:00			`If this option is used several times, the last one will be used.`