From: Daniel Stenberg <daniel@haxx.se>
Date: Thu, 27 Dec 2012 22:33:14 +0000 (+0100)
Subject: curl.1: extend the -X, --request description
X-Git-Tag: curl-7_29_0~174
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=2ee2693a477ccb4389691a069ea17106b78716c6;p=thirdparty%2Fcurl.git

curl.1: extend the -X, --request description
---

diff --git a/docs/curl.1 b/docs/curl.1
index 6808d07e59..63bf455add 100644
--- a/docs/curl.1
+++ b/docs/curl.1
@@ -1631,6 +1631,14 @@ details and explanations. Common additional HTTP requests include PUT and
 DELETE, but related technologies like WebDAV offers PROPFIND, COPY, MOVE and
 more.
 
+Normally you don't need this option. All sorts of GET, HEAD, POST and PUT
+requests are rather invoked by using dedicated command line options.
+
+This option only changes the actual word used in the HTTP request, it does not
+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.
+
 (FTP)
 Specifies a custom FTP command to use instead of LIST when doing file lists
 with FTP.