curl.1: clarify that -X is used for all requests

Reported-by: Jon Seymour

diff --git a/docs/curl.1 b/docs/curl.1
index 8b2d3f8cc1b2ad1c250137bf09ceb8a86d6702ae..03944cae96693764dbdcd2362f43274ddf9e044a 100644 (file)
--- 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 <command>"
 (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.