Confusing @return in LockBackendInterface::wait()

Documentation:

Return value

bool
TRUE if the wait operation was successful and lock may be available. You
still need to acquire the lock manually and it may fail again.

Implementation:

...
    if ($this->lockMayBeAvailable($name)) {
      // No longer need to wait.
      return FALSE;
    }
  }
  // The caller must still wait longer to get the lock.
  return TRUE;
}