curl_url_set.3: clarify by default using known schemes only

Closes #8994
This commit is contained in:
Daniel Stenberg 2022-06-12 12:53:54 +02:00
parent 18a01e3229
commit 965119855d
No known key found for this signature in database
GPG Key ID: 5CC908FDB71E12C2

View File

@ -18,6 +18,8 @@
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_url_set 3 "6 Aug 2018" "libcurl" "libcurl Manual"
.SH NAME
@ -46,6 +48,12 @@ call.
Setting a part to a NULL pointer will effectively remove that part's contents
from the CURLU handle.
By default, this API only accepts URLs using schemes for protocols that are
supported built-in. To make libcurl parse URLs generically even for schemes it
does not know about, the \fBCURLU_NON_SUPPORT_SCHEME\fP flags bit must be
set. Otherwise, this function returns \fICURLUE_UNSUPPORTED_SCHEME\fP on URL
schemes it does not recognize.
The \fIflags\fP argument is a bitmask with independent features.
.SH PARTS
.IP CURLUPART_URL