-
Notifications
You must be signed in to change notification settings - Fork 2.4k
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
subtle documentation ambiguity #12112
Comments
Thanks for the report. If I recall correctly, caret That being said, I feel like we missed a clear mention of “default strategy” in the paragraph above, as well as encourage people to avoid prefixes unless really needed. We can perhaps disambiguate the sentence with something like
|
I'm wondering if the confusion is also rooted with the use of the word "exactly"? Maybe phrasing it as: |
Problem
The Cargo Book says:
This phrasing has an unfortunate interpretation for Rust newbies, who may take the statement to mean that caret means the exact version identifier.
A very careful reading reveals that caret is merely the default semantic, but is not exactly equivalent to any fixed version. Some users may get tripped up by this ambiguity.
Possible Solution(s)
We can help the reader to disambiguate Cargo syntax and semantics. For example, adjust the section to say something like:
The text was updated successfully, but these errors were encountered: