docs/libcurl: clarify some timeout option behavior

Closes #18569

docs/libcurl/opts/CURLOPT_ACCEPTTIMEOUT_MS.md

@@ -8,6 +8,7 @@ See-also:
   - CURLOPT_CONNECTTIMEOUT_MS (3)
   - CURLOPT_DEBUGFUNCTION (3)
   - CURLOPT_STDERR (3)
+  - CURLOPT_FTPPORT (3)
 Protocol:
   - FTP
 Added-in: 7.24.0
@@ -28,7 +29,11 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_ACCEPTTIMEOUT_MS, long ms);
 # DESCRIPTION
 
 Pass a long telling libcurl the maximum number of milliseconds to wait for a
-server to connect back to libcurl when an active FTP connection is used.
+server to connect back to libcurl when an active FTP connection is used. When
+active FTP is used, the client (libcurl) tells the server to do a TCP connect
+back to the client, instead of vice versa for passive FTP.
+
+This option has no purpose for passive FTP.
 
 # DEFAULT
 
@@ -45,7 +50,7 @@ int main(void)
   if(curl) {
     curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/path/file");
 
-    /* wait no more than 5 seconds for FTP server responses */
+    /* wait no more than 5 seconds for the FTP server to connect */
     curl_easy_setopt(curl, CURLOPT_ACCEPTTIMEOUT_MS, 5000L);
 
     curl_easy_perform(curl);

docs/libcurl/opts/CURLOPT_FTPPORT.md

@@ -9,6 +9,7 @@ Protocol:
 See-also:
   - CURLOPT_FTP_USE_EPRT (3)
   - CURLOPT_FTP_USE_EPSV (3)
+  - CURLOPT_ACCEPTTIMEOUT_MS (3)
 Added-in: 7.1
 ---
 

docs/libcurl/opts/CURLOPT_SERVER_RESPONSE_TIMEOUT.md

@@ -33,13 +33,12 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SERVER_RESPONSE_TIMEOUT,
 
 # DESCRIPTION
 
-Pass a long. Causes libcurl to set a *timeout* period (in seconds) on the
+Pass a long. It tells libcurl to wait no longer than *timeout* seconds for
-amount of time that the server is allowed to take in order to send a response
+responses on sent commands. If no response is received within this period, the
-message for a command before the session is considered dead. While libcurl is
+connection is considered dead and the transfer fails.
-waiting for a response, this value overrides CURLOPT_TIMEOUT(3). It is
+
-recommended that if used in conjunction with CURLOPT_TIMEOUT(3), you set
+It is recommended that if used in conjunction with CURLOPT_TIMEOUT(3), you set
-CURLOPT_SERVER_RESPONSE_TIMEOUT(3) to a value smaller than
+CURLOPT_SERVER_RESPONSE_TIMEOUT(3) to a value smaller than CURLOPT_TIMEOUT(3).
-CURLOPT_TIMEOUT(3).
 
 This option was formerly known as CURLOPT_FTP_RESPONSE_TIMEOUT.
 

docs/libcurl/opts/CURLOPT_SERVER_RESPONSE_TIMEOUT_MS.md

@@ -33,11 +33,11 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SERVER_RESPONSE_TIMEOUT_MS,
 
 # DESCRIPTION
 
-Pass a long. Causes libcurl to set a *timeout* period (in milliseconds) on the
+Pass a long. It tells libcurl to wait no longer than *timeout* milliseconds
-amount of time that the server is allowed to take in order to send a response
+for responses on sent commands. If no response is received within this period,
-message for a command before the session is considered dead. While libcurl is
+the connection is considered dead and the transfer fails.
-waiting for a response, this value overrides CURLOPT_TIMEOUT(3). It is
+
-recommended that if used in conjunction with CURLOPT_TIMEOUT(3), you set
+It is recommended that if used in conjunction with CURLOPT_TIMEOUT(3), you set
 CURLOPT_SERVER_RESPONSE_TIMEOUT_MS(3) to a value smaller than
 CURLOPT_TIMEOUT(3).