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

Optimize out exhortations about being careful #14148

Conversation

zookoatleastauthoritycom

No description provided.

Zooko Wilcox-O'Hearn added 2 commits May 12, 2014 15:38
Yes, it is important to be careful, but repeated emphasis about it is probably
not helpful — it starts to sound like you came for a tutorial but found a
finger-wagging lecture.

Even after I removed a few of these comments, there are still several left in
the text. That's probably fine! A couple of mentions of how this is dangerous
and you ought to be careful may be a good reminder to the reader.

Note: this patch doesn't do any reflowing of text, so that you can more easily
see the semantic content of this change. I'll follow this up with a patch that
reflows the paragraphs that I touched.
using emacs's text-reflowing capabilities
@zookoatleastauthoritycom
Copy link
Author

Oh, I also did some other English editing work in this branch besides the part that I described in the commit message.

These restrictions on `&` have huge advantages. However, they also
constrain how we can use them. For example, `&` doesn't behave
identically to C's pointers, and so cannot be used for pointers in
foreign function interface (FFI). Additionally, both immutable (`&`)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"interfaces"

@huonw
Copy link
Member

huonw commented Jun 7, 2014

Thanks for this! I'm sorry that no-one responded to you for so long.

It looks good except for one tiny little nit.

@alexcrichton
Copy link
Member

Closing due to inactivity, but feel free to reopen with @huonw's comment!

bors added a commit to rust-lang-ci/rust that referenced this pull request Feb 20, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants