Skip to content

Fix misuse of *usage* throughout the Reference#2222

Merged
ehuss merged 2 commits intomasterfrom
TC/fix-misuse-of-usage
Apr 7, 2026
Merged

Fix misuse of *usage* throughout the Reference#2222
ehuss merged 2 commits intomasterfrom
TC/fix-misuse-of-usage

Conversation

@traviscross
Copy link
Copy Markdown
Contributor

Usage means a customary pattern of use (as in "regional usage varies") or a rate or quantity of use (as in "disk usage"). It doesn't mean use. Whenever use works, usage shouldn't appear.

Let's fix each incorrect use of usage -- i.e., adopt better usage of usage -- throughout the Reference.

cc @ehuss

*Usage* means a customary pattern of use (as in "regional usage
varies") or a rate or quantity of use (as in "disk usage").  It
doesn't mean *use*.  Whenever *use* works, *usage* shouldn't appear.

Let's fix each incorrect use of *usage* -- i.e., adopt better *usage*
of *usage* -- throughout the prose of the Reference.
In the prior commit, we fixed prose occurrences of *usage*.  The same
reasoning applies to the rule identifiers.

These rules describe where the language permits a construct to appear.
On the surface, that may seem to be a kind of pattern of use, but it's
not (in the sense implied by *usage*), and ultimately *use* is still
the right word.  The word *usage* describes conventions and customs --
i.e., *customary* patterns of use.  It describes how a community uses
something and how that varies, e.g., across regions.

That's not what we're doing here.  We're not describing better or
worse Rust idioms.  There's no "nonstandard usage" of Rust grammatical
constructs -- that's not what we're defining, at least.

Let's fix each rule identifier to use `use` instead.

(None of these identifiers were referenced elsewhere in
the Reference.)
@rustbot rustbot added the S-waiting-on-review Status: The marked PR is awaiting review from a maintainer label Apr 4, 2026
Copy link
Copy Markdown
Contributor

@ehuss ehuss left a comment

Choose a reason for hiding this comment

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

@ehuss ehuss added this pull request to the merge queue Apr 7, 2026
Merged via the queue into master with commit 6d20724 Apr 7, 2026
6 checks passed
@rustbot rustbot removed the S-waiting-on-review Status: The marked PR is awaiting review from a maintainer label Apr 7, 2026
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