summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorDaniel Stenberg <daniel@haxx.se>2023-04-11 08:59:00 +0200
committerDaniel Stenberg <daniel@haxx.se>2023-04-11 11:30:51 +0200
commit587dac67fb495f265fd45442cd787355edc4f5a4 (patch)
treed216d331929ffcf5ee07e46885b6cd3d61f3079f /docs
parentaafb79de2a5a2c704b33e85c263148fb0a0fdea8 (diff)
downloadcurl-587dac67fb495f265fd45442cd787355edc4f5a4.tar.gz
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
Diffstat (limited to 'docs')
-rw-r--r--docs/libcurl/curl_url_set.35
1 files changed, 5 insertions, 0 deletions
diff --git a/docs/libcurl/curl_url_set.3 b/docs/libcurl/curl_url_set.3
index 36d4a44e9..420ea0ce5 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