From 965119855d74c918372099bdcf81efa76b7a6988 Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Sun, 12 Jun 2022 12:53:54 +0200 Subject: [PATCH] curl_url_set.3: clarify by default using known schemes only Closes #8994 --- docs/libcurl/curl_url_set.3 | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/libcurl/curl_url_set.3 b/docs/libcurl/curl_url_set.3 index 68b1456548..bbea5de4b1 100644 --- a/docs/libcurl/curl_url_set.3 +++ b/docs/libcurl/curl_url_set.3 @@ -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 -- 2.47.3