Navigation Menu

Skip to content
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

Closed
wants to merge 1 commit into from

Conversation

gevaerts
Copy link
Contributor

@gevaerts gevaerts commented Jun 4, 2019

These are for features that used to be openssl-only but were expanded over
time.

void *ssl_ctx, /* actually an
OpenSSL SSL_CTX */
void *ssl_ctx, /* actually an OpenSSL
or WolfSSL SSL_CTX,
Copy link
Contributor

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?

Copy link
Contributor Author

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"

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.
Copy link
Contributor

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.

Copy link
Contributor Author

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!)

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. */
Copy link
Contributor

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.

Copy link
Contributor Author

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.

@captain-caveman2k captain-caveman2k changed the title Adjust some outdated "openssl-only" comments to add more backends. ssl: Update outdated "openssl-only" comments for supported backends Jun 4, 2019
These are for features that used to be openssl-only but were expanded over
time.
@lock lock bot locked as resolved and limited conversation to collaborators Sep 2, 2019
@gevaerts gevaerts deleted the commentfix branch February 5, 2020 13:33
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Development

Successfully merging this pull request may close these issues.

None yet

2 participants