nomicon icon indicating copy to clipboard operation
nomicon copied to clipboard
verified publisher icon rust-lang

Phrasing of Sync and Send

Open richard-hajek opened this issue 4 months ago • 4 comments

The current documentation describes Send and Sync in this way:

  • A type is Send if it is safe to send it to another thread.

  • A type is Sync if it is safe to share between threads (T is Sync if and only if &T is Send).

This wording is unclear to me, overly formal yet vague (what does it mean, exactly, "send to another thread"?)

Proposed change:

  • Send: A type is Send if it can be moved into another thread.

  • Sync: A type is Sync if it can be borrowed into another thread. (T is Sync if and only if &T is Send)

This phrasing doesn't change the meaning but makes it much more clear IMHO.

richard-hajek avatar Oct 03 '25 18:10 richard-hajek

Requesting permission to work on this

shoebilyas123 avatar Dec 13 '25 09:12 shoebilyas123

Is it up to me to give this permission? sorry I was unaware, go ahead sure

richard-hajek avatar Dec 13 '25 11:12 richard-hajek

Thank you very much! I will take out time this Sunday to raise a PR

shoebilyas123 avatar Dec 13 '25 12:12 shoebilyas123

Tag me when you do!

richard-hajek avatar Dec 13 '25 23:12 richard-hajek