docs/libcurl: unify WARNING use

Consistently use bold and colon.

Closes #20561
This commit is contained in:
Daniel Stenberg 2026-02-11 09:33:35 +01:00
parent 434e5312f4
commit 6d2e9926d7
No known key found for this signature in database
GPG key ID: 5CC908FDB71E12C2
9 changed files with 17 additions and 15 deletions

View file

@ -76,7 +76,7 @@ option.
Using this option multiple times makes the last set string override the Using this option multiple times makes the last set string override the
previous ones. previous ones.
**WARNING**: when decompressing data, even tiny transfers might be expanded **WARNING:** when decompressing data, even tiny transfers might be expanded
and generate a huge amount of bytes. and generate a huge amount of bytes.
# HISTORY # HISTORY

View file

@ -56,7 +56,7 @@ specified in the *type* argument. This function must return 0. The *data*
pointed to by the char * passed to this function is not null-terminated, but pointed to by the char * passed to this function is not null-terminated, but
is exactly of the *size* as told by the *size* argument. is exactly of the *size* as told by the *size* argument.
**WARNING** this callback may receive sensitive contents from headers and **WARNING:** this callback may receive sensitive contents from headers and
data, including information sent as **CURLINFO_TEXT**. data, including information sent as **CURLINFO_TEXT**.
The *clientp* argument is the pointer set with CURLOPT_DEBUGDATA(3). The *clientp* argument is the pointer set with CURLOPT_DEBUGDATA(3).
@ -96,8 +96,8 @@ The data is SSL/TLS (binary) data received from the peer.
## ##
WARNING: This callback may be called with the curl *handle* set to an internal **WARNING:** This callback may be called with the curl *handle* set to an
handle. (Added in 8.4.0) internal handle. (Added in 8.4.0)
If you need to distinguish your curl *handle* from internal handles then set If you need to distinguish your curl *handle* from internal handles then set
CURLOPT_PRIVATE(3) on your handle. CURLOPT_PRIVATE(3) on your handle.

View file

@ -62,7 +62,7 @@ talking to. Use CURLOPT_DOH_SSL_VERIFYHOST(3) for that. The check that the
hostname in the certificate is valid for the hostname you are connecting to hostname in the certificate is valid for the hostname you are connecting to
is done independently of the CURLOPT_DOH_SSL_VERIFYPEER(3) option. is done independently of the CURLOPT_DOH_SSL_VERIFYPEER(3) option.
WARNING: disabling verification of the certificate allows bad guys to **WARNING:** disabling verification of the certificate allows bad guys to
man-in-the-middle the communication without you knowing it. Disabling man-in-the-middle the communication without you knowing it. Disabling
verification makes the communication insecure. Just having encryption on a verification makes the communication insecure. Just having encryption on a
transfer is not enough as you cannot be sure that you are communicating with transfer is not enough as you cannot be sure that you are communicating with

View file

@ -40,9 +40,10 @@ Tells libcurl to not attempt to use any workarounds for a security flaw in the
SSL3 and TLS1.0 protocols. If this option is not used or this bit is set to 0, SSL3 and TLS1.0 protocols. If this option is not used or this bit is set to 0,
the SSL layer libcurl uses may use a work-around for this flaw although it the SSL layer libcurl uses may use a work-around for this flaw although it
might cause interoperability problems with some (older) SSL implementations. might cause interoperability problems with some (older) SSL implementations.
WARNING: avoiding this work-around lessens the security, and by setting this
option to 1 you ask for exactly that. This option is only supported for Secure **WARNING:** avoiding this work-around lessens the security, and by setting
Transport and OpenSSL. this option to 1 you ask for exactly that. This option is only supported for
Secure Transport and OpenSSL.
## CURLSSLOPT_NO_REVOKE ## CURLSSLOPT_NO_REVOKE

View file

@ -57,7 +57,7 @@ talking to. Use CURLOPT_PROXY_SSL_VERIFYHOST(3) for that. The check that the
hostname in the certificate is valid for the hostname you are connecting to is hostname in the certificate is valid for the hostname you are connecting to is
done independently of the CURLOPT_PROXY_SSL_VERIFYPEER(3) option. done independently of the CURLOPT_PROXY_SSL_VERIFYPEER(3) option.
WARNING: disabling verification of the certificate allows bad guys to **WARNING:** disabling verification of the certificate allows bad guys to
man-in-the-middle the communication without you knowing it. Disabling man-in-the-middle the communication without you knowing it. Disabling
verification makes the communication insecure. Just having encryption on a verification makes the communication insecure. Just having encryption on a
transfer is not enough as you cannot be sure that you are communicating with transfer is not enough as you cannot be sure that you are communicating with

View file

@ -38,9 +38,10 @@ Tells libcurl to not attempt to use any workarounds for a security flaw in the
SSL3 and TLS1.0 protocols. If this option is not used or this bit is set to 0, SSL3 and TLS1.0 protocols. If this option is not used or this bit is set to 0,
the SSL layer libcurl uses may use a work-around for this flaw although it the SSL layer libcurl uses may use a work-around for this flaw although it
might cause interoperability problems with some (older) SSL implementations. might cause interoperability problems with some (older) SSL implementations.
WARNING: avoiding this work-around lessens the security, and by setting this
option to 1 you ask for exactly that. This option is only supported for Secure **WARNING:** avoiding this work-around lessens the security, and by setting
Transport and OpenSSL. this option to 1 you ask for exactly that. This option is only supported for
Secure Transport and OpenSSL.
## CURLSSLOPT_NO_REVOKE ## CURLSSLOPT_NO_REVOKE

View file

@ -53,7 +53,7 @@ This option controls checking the server's certificate's claimed identity. The
separate CURLOPT_SSL_VERIFYPEER(3) options enables/disables verification that separate CURLOPT_SSL_VERIFYPEER(3) options enables/disables verification that
the certificate is signed by a trusted Certificate Authority. the certificate is signed by a trusted Certificate Authority.
WARNING: disabling verification of the certificate allows bad guys to **WARNING:** disabling verification of the certificate allows bad guys to
man-in-the-middle the communication without you knowing it. Disabling man-in-the-middle the communication without you knowing it. Disabling
verification makes the communication insecure. Just having encryption on a verification makes the communication insecure. Just having encryption on a
transfer is not enough as you cannot be sure that you are communicating with transfer is not enough as you cannot be sure that you are communicating with

View file

@ -58,7 +58,7 @@ talking to. Use CURLOPT_SSL_VERIFYHOST(3) for that. The check that the host
name in the certificate is valid for the hostname you are connecting to is name in the certificate is valid for the hostname you are connecting to is
done independently of the CURLOPT_SSL_VERIFYPEER(3) option. done independently of the CURLOPT_SSL_VERIFYPEER(3) option.
WARNING: disabling verification of the certificate allows bad guys to **WARNING:** disabling verification of the certificate allows bad guys to
man-in-the-middle the communication without you knowing it. Disabling man-in-the-middle the communication without you knowing it. Disabling
verification makes the communication insecure. Just having encryption on a verification makes the communication insecure. Just having encryption on a
transfer is not enough as you cannot be sure that you are communicating with transfer is not enough as you cannot be sure that you are communicating with

View file

@ -39,7 +39,7 @@ this used when you debug/report problems.
To also get all the protocol data sent and received, consider using the To also get all the protocol data sent and received, consider using the
CURLOPT_DEBUGFUNCTION(3). CURLOPT_DEBUGFUNCTION(3).
**WARNING** this may show sensitive contents from headers and data. **WARNING:** this may show sensitive contents from headers and data.
# DEFAULT # DEFAULT