diff --git a/src/Microsoft.VisualStudio.Threading/AsyncReaderWriterLock.cs b/src/Microsoft.VisualStudio.Threading/AsyncReaderWriterLock.cs index 5ada7bbec..8abf33a65 100644 --- a/src/Microsoft.VisualStudio.Threading/AsyncReaderWriterLock.cs +++ b/src/Microsoft.VisualStudio.Threading/AsyncReaderWriterLock.cs @@ -414,6 +414,7 @@ protected virtual bool IsUnsupportedSynchronizationContext /// a canceled token will cause the code that is waiting for the lock to resume with an . /// /// An awaitable object whose result is the lock releaser. + /// Thrown when has been called and this is a new top-level lock request. public Awaitable ReadLockAsync(CancellationToken cancellationToken = default(CancellationToken)) { return new Awaitable(this, LockKind.Read, LockFlags.None, cancellationToken); @@ -428,13 +429,14 @@ protected virtual bool IsUnsupportedSynchronizationContext /// a canceled token will cause the code that is waiting for the lock to resume with an . /// /// An awaitable object whose result is the lock releaser. + /// Thrown when has been called and this is a new top-level lock request. public Awaitable UpgradeableReadLockAsync(CancellationToken cancellationToken = default(CancellationToken)) { return new Awaitable(this, LockKind.UpgradeableRead, LockFlags.None, cancellationToken); } /// - /// Obtains a read lock, asynchronously awaiting for the lock if it is not immediately available. + /// Obtains an upgradeable read lock, asynchronously awaiting for the lock if it is not immediately available. /// /// Modifications to normal lock behavior. /// @@ -443,6 +445,7 @@ protected virtual bool IsUnsupportedSynchronizationContext /// a canceled token will cause the code that is waiting for the lock to resume with an . /// /// An awaitable object whose result is the lock releaser. + /// Thrown when has been called and this is a new top-level lock request. public Awaitable UpgradeableReadLockAsync(LockFlags options, CancellationToken cancellationToken = default(CancellationToken)) { return new Awaitable(this, LockKind.UpgradeableRead, options, cancellationToken); @@ -457,6 +460,7 @@ protected virtual bool IsUnsupportedSynchronizationContext /// a canceled token will cause the code that is waiting for the lock to resume with an . /// /// An awaitable object whose result is the lock releaser. + /// Thrown when has been called and this is a new top-level lock request. public Awaitable WriteLockAsync(CancellationToken cancellationToken = default(CancellationToken)) { return new Awaitable(this, LockKind.Write, LockFlags.None, cancellationToken); @@ -472,6 +476,7 @@ protected virtual bool IsUnsupportedSynchronizationContext /// a canceled token will cause the code that is waiting for the lock to resume with an . /// /// An awaitable object whose result is the lock releaser. + /// Thrown when has been called and this is a new top-level lock request. public Awaitable WriteLockAsync(LockFlags options, CancellationToken cancellationToken = default(CancellationToken)) { return new Awaitable(this, LockKind.Write, options, cancellationToken);