summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJay Satiro <raysatiro@yahoo.com>2019-09-25 19:12:27 -0400
committerDaniel Stenberg <daniel@haxx.se>2019-09-28 18:13:33 +0200
commit00b65e3779ec083f1eb5e52f83da615e99182a72 (patch)
tree4dc4287b9ed1c9f6e6c4c7f1b3054c3b1f238f55
parentd0a7ee3f613b0c3f2370c6cc81e5aafef67120f0 (diff)
downloadcurl-00b65e3779ec083f1eb5e52f83da615e99182a72.tar.gz
docs: disambiguate CURLUPART_HOST is for host name (ie no port)
Closes #4424
-rw-r--r--docs/libcurl/curl_url_get.35
-rw-r--r--docs/libcurl/curl_url_set.35
2 files changed, 6 insertions, 4 deletions
diff --git a/docs/libcurl/curl_url_get.3 b/docs/libcurl/curl_url_get.3
index d5445e3c8..6afa5735d 100644
--- a/docs/libcurl/curl_url_get.3
+++ b/docs/libcurl/curl_url_get.3
@@ -76,8 +76,9 @@ Scheme cannot be URL decoded on get.
.IP CURLUPART_PASSWORD
.IP CURLUPART_OPTIONS
.IP CURLUPART_HOST
-If the host part is an IPv6 numeric address, the zoneid will not be part of
-the extracted host but is provided separately in \fICURLUPART_ZONEID\fP.
+The host name. If it is an IPv6 numeric address, the zoneid will not be part
+of it but is provided separately in \fICURLUPART_ZONEID\fP. IPv6 numerical
+addresses are returned within brackets ([]).
.IP CURLUPART_ZONEID
If the host name is a numeric IPv6 address, this field might also be set.
.IP CURLUPART_PORT
diff --git a/docs/libcurl/curl_url_set.3 b/docs/libcurl/curl_url_set.3
index e2e2c1887..a7667a35d 100644
--- a/docs/libcurl/curl_url_set.3
+++ b/docs/libcurl/curl_url_set.3
@@ -60,8 +60,9 @@ Scheme cannot be URL decoded on set.
.IP CURLUPART_PASSWORD
.IP CURLUPART_OPTIONS
.IP CURLUPART_HOST
-The host name can use IDNA. The string must then be encoded as your locale
-says or UTF-8 (when winidn is used).
+The host name. If it is IDNA the string must then be encoded as your locale
+says or UTF-8 (when WinIDN is used). If it is a bracketed IPv6 numeric address
+it may contain a zone id (or you can use CURLUPART_ZONEID).
.IP CURLUPART_ZONEID
If the host name is a numeric IPv6 address, this field can also be set.
.IP CURLUPART_PORT