From: Emil Engler <me@emilengler.com>
Date: Fri, 13 Aug 2021 07:22:05 +0000 (+0200)
Subject: curl_url_get.3: clarify about path and query
X-Git-Tag: curl-7_79_0~124
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=116856b9d5c31791e5fd673490c76b11e9d38750;p=thirdparty%2Fcurl.git

curl_url_get.3: clarify about path and query

The current man-page lacks some details regarding the obtained path and
query.

Closes #7563
---

diff --git a/docs/libcurl/curl_url_get.3 b/docs/libcurl/curl_url_get.3
index 3eb3288b3a..a61157275e 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