Explain event waited for specified number of ms (#5434)

Author: monty241

xml/System.Collections.Concurrent/BlockingCollection`1.xml

@@ -1334,8 +1334,8 @@ This member is an explicit interface member implementation. It can be used only
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Removes  an item from the <see cref="T:System.Collections.Concurrent.BlockingCollection`1" />.</summary>
-        <returns>The item removed from the collection.</returns>
+        <summary>Removes an item from the <see cref="T:System.Collections.Concurrent.BlockingCollection`1" />.</summary>
+        <returns>The item that was removed from the collection.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
@@ -1386,9 +1386,9 @@ This member is an explicit interface member implementation. It can be used only
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <param name="cancellationToken">Object that can be used to cancel the take operation.</param>
+        <param name="cancellationToken">A token that can be used to cancel the "take" operation.</param>
         <summary>Removes an item from the <see cref="T:System.Collections.Concurrent.BlockingCollection`1" />.</summary>
-        <returns>The item removed from the collection.</returns>
+        <returns>The item that was removed from the collection.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
@@ -1461,7 +1461,7 @@ This member is an explicit interface member implementation. It can be used only
       </Parameters>
       <Docs>
         <param name="collections">The array of collections.</param>
-        <param name="item">The item removed from one of the collections.</param>
+        <param name="item">The item that was removed from one of the collections.</param>
         <summary>Takes an item from any one of the specified <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> instances.</summary>
         <returns>The index of the collection in the <paramref name="collections" /> array from which the item was removed.</returns>
         <remarks>
@@ -1524,7 +1524,7 @@ This member is an explicit interface member implementation. It can be used only
       </Parameters>
       <Docs>
         <param name="collections">The array of collections.</param>
-        <param name="item">The item removed from one of the collections.</param>
+        <param name="item">The item that was removed from one of the collections.</param>
         <param name="cancellationToken">A cancellation token to observe.</param>
         <summary>Takes an item from any one of the specified <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> instances while observing the specified cancellation token.</summary>
         <returns>The index of the collection in the <paramref name="collections" /> array from which the item was removed.</returns>
@@ -1695,7 +1695,7 @@ This member is an explicit interface member implementation. It can be used only
       </Parameters>
       <Docs>
         <param name="item">The item to be added to the collection.</param>
-        <param name="millisecondsTimeout">The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely.</param>
+        <param name="millisecondsTimeout">The number of milliseconds to wait for the collection to accept the item, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely.</param>
         <summary>Tries to add the specified item to the <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> within the specified time period.</summary>
         <returns>
           <see langword="true" /> if the <paramref name="item" /> could be added to the collection within the specified time; otherwise, false. If the item is a duplicate, and the underlying collection does not accept duplicate items, then an <see cref="T:System.InvalidOperationException" /> is thrown.</returns>
@@ -1800,7 +1800,7 @@ This member is an explicit interface member implementation. It can be used only
       </Parameters>
       <Docs>
         <param name="item">The item to be added to the collection.</param>
-        <param name="millisecondsTimeout">The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely.</param>
+        <param name="millisecondsTimeout">The number of milliseconds to wait for the collection to accept the item, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely.</param>
         <param name="cancellationToken">A cancellation token to observe.</param>
         <summary>Tries to add the specified item to the <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> within the specified time period, while observing a cancellation token.</summary>
         <returns>
@@ -1915,7 +1915,7 @@ This member is an explicit interface member implementation. It can be used only
       <Docs>
         <param name="collections">The array of collections.</param>
         <param name="item">The item to be added to one of the collections.</param>
-        <param name="millisecondsTimeout">The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely.</param>
+        <param name="millisecondsTimeout">The number of milliseconds to wait for the collection to accept the item, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely.</param>
         <summary>Tries to add the specified item to any one of the specified <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> instances.</summary>
         <returns>The index of the collection in the <paramref name="collections" /> array to which the item was added, or -1 if the item could not be added.</returns>
         <remarks>To be added.</remarks>
@@ -2033,7 +2033,7 @@ This member is an explicit interface member implementation. It can be used only
       <Docs>
         <param name="collections">The array of collections.</param>
         <param name="item">The item to be added to one of the collections.</param>
-        <param name="millisecondsTimeout">The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely.</param>
+        <param name="millisecondsTimeout">The number of milliseconds to wait for the collection to accept the item, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely.</param>
         <param name="cancellationToken">A cancellation token to observe.</param>
         <summary>Tries to add the specified item to any one of the specified <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> instances.</summary>
         <returns>The index of the collection in the <paramref name="collections" /> array to which the item was added, or -1 if the item could not be added.</returns>
@@ -2164,7 +2164,7 @@ This member is an explicit interface member implementation. It can be used only
       </Parameters>
       <Docs>
         <param name="item">The item to be removed from the collection.</param>
-        <param name="millisecondsTimeout">The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely.</param>
+        <param name="millisecondsTimeout">The number of milliseconds to wait for the item to be removed, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely.</param>
         <summary>Tries to remove an item from the <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> in the specified time period.</summary>
         <returns>
           <see langword="true" /> if an item could be removed from the collection within the specified  time; otherwise, <see langword="false" />.</returns>
@@ -2219,10 +2219,10 @@ This member is an explicit interface member implementation. It can be used only
       </Parameters>
       <Docs>
         <param name="item">The item to be removed from the collection.</param>
-        <param name="timeout">An object that represents the number of milliseconds to wait, or an object that represents -1 milliseconds to wait indefinitely.</param>
+        <param name="timeout">A <see cref="T:System.TimeSpan" /> that represents the number of milliseconds to wait for the item to be removed, or a <see cref="T:System.TimeSpan" /> that represents -1 milliseconds to wait indefinitely.</param>
         <summary>Tries to remove an item from the <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> in the specified time period.</summary>
         <returns>
-          <see langword="true" /> if an item could be removed from the collection within the specified  time; otherwise, <see langword="false" />.</returns>
+          <see langword="true" /> if an item could be removed from the collection within the specified time; otherwise, <see langword="false" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
@@ -2279,7 +2279,7 @@ This member is an explicit interface member implementation. It can be used only
       </Parameters>
       <Docs>
         <param name="item">The item to be removed from the collection.</param>
-        <param name="millisecondsTimeout">The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely.</param>
+        <param name="millisecondsTimeout">The number of milliseconds to wait for the item to be removed, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely.</param>
         <param name="cancellationToken">A cancellation token to observe.</param>
         <summary>Tries to remove an item from the <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> in the specified time period while observing a cancellation token.</summary>
         <returns>
@@ -2354,7 +2354,7 @@ This member is an explicit interface member implementation. It can be used only
       </Parameters>
       <Docs>
         <param name="collections">The array of collections.</param>
-        <param name="item">The item removed from one of the collections.</param>
+        <param name="item">The item that was removed from one of the collections.</param>
         <summary>Tries to remove an item from any one of the specified <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> instances.</summary>
         <returns>The index of the collection in the <paramref name="collections" /> array from which the item was removed, or -1 if an item could not be removed.</returns>
         <remarks>
@@ -2418,9 +2418,9 @@ This member is an explicit interface member implementation. It can be used only
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="collections">The array of collections.</param>
-        <param name="item">The item removed from one of the collections.</param>
-        <param name="millisecondsTimeout">The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely.</param>
+        <param name="collections">The array of collections to remove an item from.</param>
+        <param name="item">The item that was removed from one of the collections.</param>
+        <param name="millisecondsTimeout">The number of milliseconds to wait for the item to be removed, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely.</param>
         <summary>Tries to remove an item from any one of the specified <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> instances.</summary>
         <returns>The index of the collection in the <paramref name="collections" /> array from which the item was removed, or -1 if an item could not be removed.</returns>
         <remarks>
@@ -2482,7 +2482,7 @@ This member is an explicit interface member implementation. It can be used only
       </Parameters>
       <Docs>
         <param name="collections">The array of collections.</param>
-        <param name="item">The item removed from one of the collections.</param>
+        <param name="item">The item that was removed from one of the collections.</param>
         <param name="timeout">A <see cref="T:System.TimeSpan" /> that represents the number of milliseconds to wait, or a <see cref="T:System.TimeSpan" /> that represents -1 milliseconds to wait indefinitely.</param>
         <summary>Tries to remove an item from any one of the specified <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> instances.</summary>
         <returns>The index of the collection in the <paramref name="collections" /> array from which the item was removed, or -1 if an item could not be removed.</returns>
@@ -2545,9 +2545,9 @@ This member is an explicit interface member implementation. It can be used only
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <param name="collections">The array of collections.</param>
-        <param name="item">The item removed from one of the collections.</param>
-        <param name="millisecondsTimeout">The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely.</param>
+        <param name="collections">The array of collections to remove an item from.</param>
+        <param name="item">The item that was removed from one of the collections.</param>
+        <param name="millisecondsTimeout">The number of milliseconds to wait for the item to be removed, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely.</param>
         <param name="cancellationToken">A cancellation token to observe.</param>
         <summary>Tries to remove an item from any one of the specified <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> instances.</summary>
         <returns>The index of the collection in the <paramref name="collections" /> array from which the item was removed, or -1 if an item could not be removed.</returns>