curl/docs/cmdline-opts/post301.d

c: Copyright (C) 1998 - 2022, Daniel Stenberg, <daniel@haxx.se>, et al.
SPDX-License-Identifier: curl
Long: post301
Help: Do not switch to GET after following a 301
Protocols: HTTP
See-also: post302 post303 location
Added: 7.17.1
Category: http post
Example: --post301 --location -d "data" $URL
---
Tells curl to respect RFC 7231/6.4.2 and not convert POST requests into GET
requests when following a 301 redirection. The non-RFC behavior is ubiquitous
in web browsers, so curl does the conversion by default to maintain
consistency. However, a server may require a POST to remain a POST after such
a redirection. This option is meaningful only when using --location.
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`
cmdline-docs: more conversion 2016-11-16 21:20:36 +08:00			`Long: post301`
			`Help: Do not switch to GET after following a 301`
			`Protocols: HTTP`
			`See-also: post302 post303 location`
			`Added: 7.17.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 post`
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: --post301 --location -d "data" $URL`
cmdline-docs: more conversion 2016-11-16 21:20:36 +08:00			`---`
cmdline-opts/post30X.d: fix the RFC references 2016-12-18 07:42:36 +08:00			`Tells curl to respect RFC 7231/6.4.2 and not convert POST requests into GET`
language: s/behaviour/behavior/g We currently use both spellings the british "behaviour" and the american "behavior". However "behavior" is more used in the project so I think it's worth dropping the british name. Closes #6395 2020-12-31 17:11:49 +08:00			`requests when following a 301 redirection. The non-RFC behavior is ubiquitous`
cmdline-docs: more conversion 2016-11-16 21:20:36 +08:00			`in web browsers, so curl does the conversion by default to maintain`
			`consistency. However, a server may require a POST to remain a POST after such`
			`a redirection. This option is meaningful only when using --location.`