From: Daniel Stenberg <daniel@haxx.se>
Date: Sat, 26 Oct 2024 21:13:02 +0000 (+0200)
Subject: docs: clarify FTP over HTTP proxy functionality somewhat
X-Git-Tag: curl-8_11_0~53
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=1160380e5035bef181f60911a45ad41b39fa02a0;p=thirdparty%2Fcurl.git

docs: clarify FTP over HTTP proxy functionality somewhat

Reported-by: newfunction

Closes #15417
---

diff --git a/docs/cmdline-opts/proxy.md b/docs/cmdline-opts/proxy.md
index 529d3369fb..afaa29837e 100644
--- a/docs/cmdline-opts/proxy.md
+++ b/docs/cmdline-opts/proxy.md
@@ -56,3 +56,7 @@ password.
 
 When a proxy is used, the active FTP mode as set with --ftp-port, cannot be
 used.
+
+Doing FTP over an HTTP proxy without --proxytunnel makes curl do HTTP with an
+FTP URL over the proxy. For such transfers, common FTP specific options do not
+work, including --ftp-ssl-reqd and --ftp-ssl-control.
diff --git a/docs/libcurl/opts/CURLOPT_PROXY.md b/docs/libcurl/opts/CURLOPT_PROXY.md
index c414f4f512..7c84556024 100644
--- a/docs/libcurl/opts/CURLOPT_PROXY.md
+++ b/docs/libcurl/opts/CURLOPT_PROXY.md
@@ -102,6 +102,10 @@ single port number used widely for proxies. Specify it.
 When a proxy is used, the active FTP mode as set with *CUROPT_FTPPORT(3)*,
 cannot be used.
 
+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).
+
 # Environment variables
 
 libcurl respects the proxy environment variables named **http_proxy**,