From: Daniel Stenberg <daniel@haxx.se>
Date: Tue, 17 Sep 2024 16:03:30 +0000 (+0200)
Subject: curl_url_set.md: document HOST handling when URL is parsed
X-Git-Tag: curl-8_11_0~435
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=c0a9db8424a59d649037bb54e034ae2cc2f83daf;p=thirdparty%2Fcurl.git

curl_url_set.md: document HOST handling when URL is parsed

When a full URL is set (parsed), the hostname component is stored URL
decoded (with default zero flags).

While perhaps surprising and inconsistent, the API has done this for
quite some time already and changigtn this now would break existing
behaviour.

Fixes #14942
Reported-by: Venkat Krishna R
Closes #14946
---

diff --git a/docs/libcurl/curl_url_set.md b/docs/libcurl/curl_url_set.md
index 390f524939..b041d756df 100644
--- a/docs/libcurl/curl_url_set.md
+++ b/docs/libcurl/curl_url_set.md
@@ -91,6 +91,8 @@ it does not recognize.
 Unless *CURLU_NO_AUTHORITY* is set, a blank hostname is not allowed in
 the URL.
 
+When a full URL is set (parsed), the hostname component is stored URL decoded.
+
 ## CURLUPART_SCHEME
 
 Scheme cannot be URL decoded on set. libcurl only accepts setting schemes up