diff --git a/src/pkg/sync/cond.go b/src/pkg/sync/cond.go index 75494b53536..44f19fae3ee 100644 --- a/src/pkg/sync/cond.go +++ b/src/pkg/sync/cond.go @@ -43,9 +43,10 @@ func NewCond(l Locker) *Cond { // Wait atomically unlocks c.L and suspends execution // of the calling goroutine. After later resuming execution, -// Wait locks c.L before returning. +// Wait locks c.L before returning. Unlike in other systems, +// Wait cannot return unless awoken by Broadcast or Signal. // -// Because L is not locked when Wait first resumes, the caller +// Because c.L is not locked when Wait first resumes, the caller // typically cannot assume that the condition is true when // Wait returns. Instead, the caller should Wait in a loop: //