-
Notifications
You must be signed in to change notification settings - Fork 13k
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
Fix typo in hint::black_box docs #109634
Fix typo in hint::black_box docs #109634
Conversation
situ, -> situations
Thanks for the pull request, and welcome! The Rust team is excited to review your changes, and you should hear from @m-ou-se (or someone else) soon. Please see the contribution instructions for more information. Namely, in order to ensure the minimum review times lag, PR authors and assigned reviewers should ensure that the review label (
|
Hey! It looks like you've submitted a new PR for the library teams! If this PR contains changes to any Examples of
|
Thanks for the contribution. |
I do agree that in situ fits quite oddly here. I'd rather myself go with something along the lines of:
This seems to be, a priori, the intent the original author had (given the comma they wrote), and using in situ/"in the [very] place" is convoluted at best. By using "actually", it will be English rather than Latin, and in this case, simple English, which is a fortiori more accessible. Ergo, removing that usage of in situ is an improvement, ceteris paribus 🙃: the author going and submitting a PR, motu propio, to discuss it, was thus the right move (although I agree with @Dylan-DPC that "situations where", although not wrong per se, is not what the original author intended). |
I thought that this is what the original author intended but apparently I can't read |
Co-authored-by: Chris Denton <christophersdenton@gmail.com>
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'm the one who originally wrote this and meant "in situ" as "in its natural place"/"in position", i.e., how you would come across this function when it's used in real code. But I see that apparently came off a bit abstract, so might as well KISS 🙂.
This definitely isn't a two commit kind of update though, so please squash and correct the commit message @4gboframram
There hasn't been much interest in this and I think the change doesn't clarify the wording more than the original. Closing this as it's been inactive for a while |
Improve wording of `hint::black_box` docs The wording is a bit confusing. squash of rust-lang#109634
Rollup merge of rust-lang#116350 - Nilstrieb:in-situ, r=Dylan-DPC Improve wording of `hint::black_box` docs The wording is a bit confusing. squash of rust-lang#109634
situ, -> situations