]> git.ipfire.org Git - thirdparty/curl.git/commitdiff
DOCS: Reworked the scheme calculation explanation under CURLOPT_URL
authorSteve Holme <steve_holme@hotmail.com>
Tue, 23 Apr 2013 18:57:12 +0000 (19:57 +0100)
committerSteve Holme <steve_holme@hotmail.com>
Tue, 23 Apr 2013 18:57:58 +0000 (19:57 +0100)
docs/libcurl/curl_easy_setopt.3

index 43d15029073c3d5c3e34c9ca4f8a56be2ed555b8..d7f04bdaf9be25858f31b23259a526cb16e9e03a 100644 (file)
@@ -620,12 +620,20 @@ scheme://host:port/path
 
 For a greater explanation of the format please see RFC3986.
 
-If the given URL lacks the scheme, or protocol, part ("http://" or "ftp://"
-etc), libcurl will attempt to resolve which protocol to use based on the
-given host mame. If the protocol is not supported, libcurl will return
-(\fICURLE_UNSUPPORTED_PROTOCOL\fP) when you call \fIcurl_easy_perform(3)\fP
-or \fIcurl_multi_perform(3)\fP. Use \fIcurl_version_info(3)\fP for detailed
-information on which protocols are supported.
+If the given URL lacks the scheme (such as "http://" or "ftp://" etc) then
+libcurl will attempt to resolve the protocol based on the given host name,
+which may be one of the following:
+
+HTTP, FTP, DICT, LDAP, IMAP, POP3 or SMTP
+
+(POP3 and SMTP added in 7.30.1)
+
+Should the protocol, either that specified by the scheme or deduced by libcurl
+from the host name, not be supported by libcurl then
+(\fICURLE_UNSUPPORTED_PROTOCOL\fP) will be returned from either the
+\fIcurl_easy_perform(3)\fP or \fIcurl_multi_perform(3)\fP functions when you
+call them. Use \fIcurl_version_info(3)\fP for detailed information of which
+protocols are supported by the build of libcurl you are using.
 
 The host part of the URL contains the address of the server that you want to
 connect to. This can be the fully qualified domain name of the server, the