From 116856b9d5c31791e5fd673490c76b11e9d38750 Mon Sep 17 00:00:00 2001 From: Emil Engler Date: Fri, 13 Aug 2021 09:22:05 +0200 Subject: [PATCH] curl_url_get.3: clarify about path and query The current man-page lacks some details regarding the obtained path and query. Closes #7563 --- docs/libcurl/curl_url_get.3 | 9 +++++++++ 1 file changed, 9 insertions(+) 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 -- 2.47.3