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