From 587dac67fb495f265fd45442cd787355edc4f5a4 Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Tue, 11 Apr 2023 08:59:00 +0200 Subject: [PATCH] curl_url_set.3: mention that users can set content rather freely ... which then might render bad URLs if you extract a URL later. Closes #10921 --- docs/libcurl/curl_url_set.3 | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/libcurl/curl_url_set.3 b/docs/libcurl/curl_url_set.3 index 36d4a44e93..420ea0ce55 100644 --- a/docs/libcurl/curl_url_set.3 +++ b/docs/libcurl/curl_url_set.3 @@ -58,6 +58,11 @@ This function call has no particular maximum length for any provided input string. In the real world, excessively long field in URLs will cause problems even if this API accepts them. +When setting or updating contents of individual URL parts, this API might +accept data that would not be otherwise possible to set in the string when it +gets populated as a result of a full URL parse. Beware. If done so, extracting +a full URL later on from such components might render an invalid URL. + The \fIflags\fP argument is a bitmask with independent features. .SH PARTS .IP CURLUPART_URL