Skip to content

Commit

Permalink
curl_url_set.3: docuemtned CURLU_APPENDQUERY proper
Browse files Browse the repository at this point in the history
Listed among the other support flags.

Reported-by: Robby Simpson
Fixes #9628
  • Loading branch information
bagder committed Sep 30, 2022
1 parent 1cbbffd commit bd06ff1
Showing 1 changed file with 10 additions and 7 deletions.
17 changes: 10 additions & 7 deletions docs/libcurl/curl_url_set.3
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down

0 comments on commit bd06ff1

Please sign in to comment.