From: Daniel Stenberg Date: Fri, 30 Sep 2022 21:41:18 +0000 (+0200) Subject: curl_url_set.3: document CURLU_APPENDQUERY proper X-Git-Tag: curl-7_86_0~134 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=f77bde42d5ecde9a1da212785c9a714064b29adb;p=thirdparty%2Fcurl.git curl_url_set.3: document CURLU_APPENDQUERY proper Listed among the other supported flags. Reported-by: Robby Simpson Fixes #9628 Closes #9629 --- diff --git a/docs/libcurl/curl_url_set.3 b/docs/libcurl/curl_url_set.3 index f2f2e5df26..03a223b79f 100644 --- a/docs/libcurl/curl_url_set.3 +++ b/docs/libcurl/curl_url_set.3 @@ -89,19 +89,22 @@ automatically when this URL is read from the handle. The query part will also get spaces converted to pluses when asked to URL encode on set with the \fICURLU_URLENCODE\fP bit. -If used together with the \fICURLU_APPENDQUERY\fP bit, the provided part will -be appended on the end of the existing query - and if the previous part did not -end with an ampersand (&), an ampersand will be inserted before the new -appended part. - -When \fICURLU_APPENDQUERY\fP is used together with \fICURLU_URLENCODE\fP, the -first '=' symbol will not be URL encoded. +If used together with the \fICURLU_APPENDQUERY\fP bit, the provided part is +appended on the end of the existing query. The question mark in the URL is not part of the actual query contents. .IP CURLUPART_FRAGMENT The hash sign in the URL is not part of the actual fragment contents. .SH FLAGS The flags argument is zero, one or more bits set in a bitmask. +.IP CURLU_APPENDQUERY +Can be used when setting the \fICURLUPART_QUERY\fP component. The provided new +part will then instead be appended at the end of the existing query - and if +the previous part did not end with an ampersand (&), an ampersand gets +inserted before the new appended part. + +When \fICURLU_APPENDQUERY\fP is used together with \fICURLU_URLENCODE\fP, the +first '=' symbol will not be URL encoded. .IP CURLU_NON_SUPPORT_SCHEME If set, allows \fIcurl_url_set(3)\fP to set a non-supported scheme. .IP CURLU_URLENCODE