New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
ssl: Update outdated "openssl-only" comments for supported backends #3985
Conversation
include/curl/curl.h
Outdated
void *ssl_ctx, /* actually an | ||
OpenSSL SSL_CTX */ | ||
void *ssl_ctx, /* actually an OpenSSL | ||
or WolfSSL SSL_CTX, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Is there space here within our 80 character limit to align the first character of each addition comment line with the start to actually
?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
For these lines, yes, but the "mbedtls_ssl_config */" line would be too long then. I'll have just that one be "wrong"
include/curl/curl.h
Outdated
in second argument. The function must be matching the | ||
curl_ssl_ctx_callback proto. */ | ||
/* Set the ssl context callback function, currently only for OpenSSL or | ||
WolfSSL ssl_ctx or mbedTLS mbedtls_ssl_config in second argument. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would insert the old "oxford comma" between ssl_ctx
and or
, and a the
between in
and second
.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yes, good point (or comma!)
include/curl/curl.h
Outdated
curl_ssl_ctx_callback proto. */ | ||
/* Set the ssl context callback function, currently only for OpenSSL or | ||
WolfSSL ssl_ctx or mbedTLS mbedtls_ssl_config in second argument. | ||
The function must be matching the curl_ssl_ctx_callback proto. */ |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think the sentence reads better if be matching
is replaced with match
and proto
is expanded to prototype
.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
True, and worth changing while we're at it.
These are for features that used to be openssl-only but were expanded over time.
These are for features that used to be openssl-only but were expanded over
time.