]> git.ipfire.org Git - thirdparty/curl.git/commitdiff
curl_url_get.3: clarify about path and query
authorEmil Engler <me@emilengler.com>
Fri, 13 Aug 2021 07:22:05 +0000 (09:22 +0200)
committerDaniel Stenberg <daniel@haxx.se>
Fri, 13 Aug 2021 15:38:23 +0000 (17:38 +0200)
The current man-page lacks some details regarding the obtained path and
query.

Closes #7563

docs/libcurl/curl_url_get.3

index 3eb3288b3a8d6b3fcb7af93b52c66555e7766ded..a61157275e8905cda9fc66ec352d98da1e8c3755 100644 (file)
@@ -84,7 +84,16 @@ If the host name is a numeric IPv6 address, this field might also be set.
 .IP CURLUPART_PORT
 Port cannot be URL decoded on get.
 .IP CURLUPART_PATH
+\fIpart\fP will be '/' even if no path is supplied in the URL.
 .IP CURLUPART_QUERY
+The initial question mark that denotes the beginning of the query part is
+a delimiter only.
+It is not part of the query contents.
+
+
+A not-present query will lead \fIpart\fP to be set to NULL.
+A zero-length query will lead \fIpart\fP to be set to a zero-length string.
+
 The query part will also get pluses converted to space when asked to URL
 decode on get with the CURLU_URLDECODE bit.
 .IP CURLUPART_FRAGMENT