From c0a9db8424a59d649037bb54e034ae2cc2f83daf Mon Sep 17 00:00:00 2001
From: Daniel Stenberg <daniel@haxx.se>
Date: Tue, 17 Sep 2024 18:03:30 +0200
Subject: [PATCH] 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
---
 docs/libcurl/curl_url_set.md | 2 ++
 1 file changed, 2 insertions(+)

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