From: Daniel Stenberg <daniel@haxx.se>
Date: Sat, 28 May 2022 23:47:50 +0000 (+0200)
Subject: CURLINFO_CAINFO/PATH.3: clarify the multiple TLS situation
X-Git-Tag: curl-7_84_0~126
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=22eab9d4132a53ffa0d6c11126a2460a9d567f64;p=thirdparty%2Fcurl.git

CURLINFO_CAINFO/PATH.3: clarify the multiple TLS situation

Spell out the multi-TLS situation.

Reported-by: Dan Fandrich
Fixes #8926
Closes #8932
---

diff --git a/docs/libcurl/opts/CURLINFO_CAINFO.3 b/docs/libcurl/opts/CURLINFO_CAINFO.3
index e0a0476829..004cd2c89c 100644
--- a/docs/libcurl/opts/CURLINFO_CAINFO.3
+++ b/docs/libcurl/opts/CURLINFO_CAINFO.3
@@ -34,6 +34,10 @@ Pass a pointer to a char pointer to receive the pointer to a null-terminated
 string holding the default built-in path used for the \fICURLOPT_CAINFO(3)\fP
 option unless set by the user.
 
+Note that in a situation where libcurl has been built to support multiple TLS
+libraries, this option might return a string even if the specific TLS library
+currently set to be used does not support \fICURLOPT_CAINFO(3)\fP.
+
 This is a path identifying a single file containing CA certificates.
 
 The \fBpath\fP pointer will be NULL if there is no default path.
diff --git a/docs/libcurl/opts/CURLINFO_CAPATH.3 b/docs/libcurl/opts/CURLINFO_CAPATH.3
index f694186e16..0d9ea654b0 100644
--- a/docs/libcurl/opts/CURLINFO_CAPATH.3
+++ b/docs/libcurl/opts/CURLINFO_CAPATH.3
@@ -34,6 +34,10 @@ Pass a pointer to a char pointer to receive the pointer to a null-terminated
 string holding the default built-in path used for the \fICURLOPT_CAPATH(3)\fP
 option unless set by the user.
 
+Note that in a situation where libcurl has been built to support multiple TLS
+libraries, this option might return a string even if the specific TLS library
+currently set to be used does not support \fICURLOPT_CAPATH(3)\fP.
+
 This is a path identifying a directory.
 
 The \fBpath\fP pointer will be NULL if there is no default path.