From 00b65e3779ec083f1eb5e52f83da615e99182a72 Mon Sep 17 00:00:00 2001 From: Jay Satiro Date: Wed, 25 Sep 2019 19:12:27 -0400 Subject: docs: disambiguate CURLUPART_HOST is for host name (ie no port) Closes #4424 --- docs/libcurl/curl_url_get.3 | 5 +++-- docs/libcurl/curl_url_set.3 | 5 +++-- 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 -- cgit v1.2.1