From: Daniel Stenberg <daniel@haxx.se>
Date: Sun, 22 Dec 2024 21:56:52 +0000 (+0100)
Subject: CURLOPT_PROXY.md: clarify the crendential support in proxy URLs
X-Git-Tag: curl-8_12_0~282
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=0ebd286aa3365def7ae0126b2e0cba363518e498;p=thirdparty%2Fcurl.git

CURLOPT_PROXY.md: clarify the crendential support in proxy URLs

Ref: #15802
Closes #15805
---

diff --git a/docs/libcurl/opts/CURLOPT_PROXY.md b/docs/libcurl/opts/CURLOPT_PROXY.md
index 7c84556024..e7c3d96ff9 100644
--- a/docs/libcurl/opts/CURLOPT_PROXY.md
+++ b/docs/libcurl/opts/CURLOPT_PROXY.md
@@ -90,9 +90,6 @@ proxy. Such tunneling is activated with CURLOPT_HTTPPROXYTUNNEL(3).
 Setting the proxy string to "" (an empty string) explicitly disables the use
 of a proxy, even if there is an environment variable set for it.
 
-A proxy host string can also include protocol scheme (http://) and embedded
-user + password.
-
 Unix domain sockets are supported for socks proxies since 7.84.0. Set
 localhost for the host part. e.g. socks5h://localhost/path/to/socket.sock
 
@@ -106,6 +103,14 @@ Doing FTP over an HTTP proxy without CURLOPT_HTTPPROXYTUNNEL(3) set makes
 libcurl do HTTP with an FTP URL over the proxy. For such transfers, common FTP
 specific options do not work, for example CURLOPT_USE_SSL(3).
 
+# Authentication
+
+The proxy can also be specified with its associated credentials like for
+ordinary URLs in the style: `scheme://username:password@hostname`
+
+Alternatively, set them using CURLOPT_PROXYUSERNAME(3) and
+CURLOPT_PROXYPASSWORD(3).
+
 # Environment variables
 
 libcurl respects the proxy environment variables named **http_proxy**,