summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEmil Engler <me@emilengler.com>2021-08-13 09:22:05 +0200
committerDaniel Stenberg <daniel@haxx.se>2021-08-13 17:38:23 +0200
commit116856b9d5c31791e5fd673490c76b11e9d38750 (patch)
treecae3563a13d2132f4ff262050670fdc7540adb3e
parent1e0b6f705e7e12165328d6ef2e3ec178a0ba47f4 (diff)
downloadcurl-116856b9d5c31791e5fd673490c76b11e9d38750.tar.gz
curl_url_get.3: clarify about path and query
The current man-page lacks some details regarding the obtained path and query. Closes #7563
-rw-r--r--docs/libcurl/curl_url_get.39
1 files changed, 9 insertions, 0 deletions
diff --git a/docs/libcurl/curl_url_get.3 b/docs/libcurl/curl_url_get.3
index 3eb3288b3..a61157275 100644
--- a/docs/libcurl/curl_url_get.3
+++ b/docs/libcurl/curl_url_get.3
@@ -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