From 0daf1ef7299dcd4755a75d6b9342739da6be7244 Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Mon, 9 Feb 2015 10:33:54 +0100 Subject: [PATCH] curl.1: clarify that -X is used for all requests Reported-by: Jon Seymour --- docs/curl.1 | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/curl.1 b/docs/curl.1 index 8b2d3f8cc..03944cae9 100644 --- a/docs/curl.1 +++ b/docs/curl.1 @@ -1900,7 +1900,7 @@ password. If this option is used several times, the last one will be used. .IP "-X, --request " (HTTP) Specifies a custom request method to use when communicating with the -HTTP server. The specified request will be used instead of the method +HTTP server. The specified request method will be used instead of the method otherwise used (which defaults to GET). Read the HTTP 1.1 specification for details and explanations. Common additional HTTP requests include PUT and DELETE, but related technologies like WebDAV offers PROPFIND, COPY, MOVE and @@ -1914,6 +1914,11 @@ alter the way curl behaves. So for example if you want to make a proper HEAD request, using -X HEAD will not suffice. You need to use the \fI-I, --head\fP option. +The the method string you set with -X will be used for all requests, which if +you for example use \fB-L, --location\fP may cause unintended side-effects +when curl doesn't change request method according to the HTTP 30x response +codes - and similar. + (FTP) Specifies a custom FTP command to use instead of LIST when doing file lists with FTP. -- 2.40.0