Automatic port of System.Threading exceptions (dotnet#4656)

* Automatic port of System.Threading exceptions

* Apply suggestions from code review

Co-authored-by: Genevieve Warren <[email protected]>

* Update xml/System.Threading.Tasks/TaskCompletionSource.xml

Co-authored-by: carlossanlop <[email protected]>
Co-authored-by: Genevieve Warren <[email protected]>

Author: carlossanlop

xml/System.Threading.Channels/ChannelReader`1.xml

@@ -1,4 +1,4 @@
-<Type Name="ChannelReader&lt;T&gt;" FullName="System.Threading.Channels.ChannelReader&lt;T&gt;">
+<Type Name="ChannelReader&lt;T&gt;" FullName="System.Threading.Channels.ChannelReader&lt;T&gt;">
   <TypeSignature Language="C#" Value="public abstract class ChannelReader&lt;T&gt;" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi abstract beforefieldinit ChannelReader`1&lt;T&gt; extends System.Object" />
   <TypeSignature Language="DocId" Value="T:System.Threading.Channels.ChannelReader`1" />
@@ -110,6 +110,7 @@
         <summary>Gets the current number of items available from this channel reader.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.NotSupportedException">Counting is not supported on this instance.</exception>
       </Docs>
     </Member>
     <Member MemberName="ReadAllAsync">

xml/System.Threading.Tasks/Task.xml

@@ -1,4 +1,4 @@
-<Type Name="Task" FullName="System.Threading.Tasks.Task">
+<Type Name="Task" FullName="System.Threading.Tasks.Task">
   <TypeSignature Language="C#" Value="public class Task : IAsyncResult" FrameworkAlternate="dotnet-uwp-10.0;netcore-1.0;netcore-1.1;netstandard-1.0;netstandard-1.1;netstandard-1.2;netstandard-1.3;netstandard-1.4;netstandard-1.6" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit Task extends System.Object implements class System.IAsyncResult" FrameworkAlternate="dotnet-uwp-10.0;netcore-1.0;netcore-1.1;netstandard-1.0;netstandard-1.1;netstandard-1.2;netstandard-1.3;netstandard-1.4;netstandard-1.6" />
   <TypeSignature Language="DocId" Value="T:System.Threading.Tasks.Task" />
@@ -5671,6 +5671,8 @@ The returned task will complete when any of the supplied tasks has completed.  T
 
           ]]></format>
         </remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="task1" /> or <paramref name="task2" /> was <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="WhenAny&lt;TResult&gt;">
@@ -5838,6 +5840,8 @@ The returned task will complete when any of the supplied tasks has completed.  T
 
           ]]></format>
         </remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="task1" /> or <paramref name="task2" /> was <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="Yield">

xml/System.Threading.Tasks/TaskCompletionSource.xml

@@ -1,4 +1,4 @@
-<Type Name="TaskCompletionSource" FullName="System.Threading.Tasks.TaskCompletionSource">
+<Type Name="TaskCompletionSource" FullName="System.Threading.Tasks.TaskCompletionSource">
   <TypeSignature Language="C#" Value="public class TaskCompletionSource" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit TaskCompletionSource extends System.Object" />
   <TypeSignature Language="DocId" Value="T:System.Threading.Tasks.TaskCompletionSource" />
@@ -94,6 +94,8 @@ The <xref:System.Threading.Tasks.Task> created by this instance and accessible t
 
           ]]></format>
         </remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException">One or more of the specified <paramref name="creationOptions" /> are invalid for use with a <see cref="T:System.Threading.Tasks.TaskCompletionSource" />.
+</exception>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -117,6 +119,8 @@ The <xref:System.Threading.Tasks.Task> created by this instance and accessible t
         <param name="creationOptions">The options to use when creating the underlying <see cref="T:System.Threading.Tasks.Task" />.</param>
         <summary>Creates a <see cref="T:System.Threading.Tasks.TaskCompletionSource" /> with the specified state and options.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException">One or more of the specified <paramref name="creationOptions" /> are invalid for use with a <see cref="T:System.Threading.Tasks.TaskCompletionSource" />.
+</exception>
       </Docs>
     </Member>
     <Member MemberName="SetCanceled">
@@ -138,6 +142,7 @@ The <xref:System.Threading.Tasks.Task> created by this instance and accessible t
       <Docs>
         <summary>Transitions the underlying <see cref="T:System.Threading.Tasks.Task" /> into the <see cref="F:System.Threading.Tasks.TaskStatus.Canceled" /> state.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.InvalidOperationException">The underlying <see cref="T:System.Threading.Tasks.Task" /> is already in one of the three final states: <see cref="F:System.Threading.Tasks.TaskStatus.RanToCompletion" />, <see cref="F:System.Threading.Tasks.TaskStatus.Faulted" />, or <see cref="F:System.Threading.Tasks.TaskStatus.Canceled" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="SetCanceled">
@@ -162,6 +167,7 @@ The <xref:System.Threading.Tasks.Task> created by this instance and accessible t
         <param name="cancellationToken">The cancellation token with which to cancel the <see cref="T:System.Threading.Tasks.Task" />.</param>
         <summary>Transitions the underlying <see cref="T:System.Threading.Tasks.Task" /> into the <see cref="F:System.Threading.Tasks.TaskStatus.Canceled" /> state using the specified token.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.InvalidOperationException">The underlying <see cref="T:System.Threading.Tasks.Task" /> is already in one of the three final states: <see cref="F:System.Threading.Tasks.TaskStatus.RanToCompletion" />, <see cref="F:System.Threading.Tasks.TaskStatus.Faulted" />, or <see cref="F:System.Threading.Tasks.TaskStatus.Canceled" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="SetException">
@@ -186,6 +192,10 @@ The <xref:System.Threading.Tasks.Task> created by this instance and accessible t
         <param name="exceptions">The collection of exceptions to bind to this <see cref="T:System.Threading.Tasks.Task" />.</param>
         <summary>Transitions the underlying <see cref="T:System.Threading.Tasks.Task" /> into the <see cref="F:System.Threading.Tasks.TaskStatus.Faulted" /> state.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="exceptions" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.ArgumentException">There are one or more <see langword="null" /> elements in <paramref name="exceptions" />.</exception>
+        <exception cref="T:System.InvalidOperationException">The underlying <see cref="T:System.Threading.Tasks.Task" /> is already in one of the three final states: <see cref="F:System.Threading.Tasks.TaskStatus.RanToCompletion" />, <see cref="F:System.Threading.Tasks.TaskStatus.Faulted" />, or <see cref="F:System.Threading.Tasks.TaskStatus.Canceled" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="SetException">
@@ -210,6 +220,9 @@ The <xref:System.Threading.Tasks.Task> created by this instance and accessible t
         <param name="exception">The exception to bind to this <see cref="T:System.Threading.Tasks.Task" />.</param>
         <summary>Transitions the underlying <see cref="T:System.Threading.Tasks.Task" /> into the <see cref="F:System.Threading.Tasks.TaskStatus.Faulted" /> state.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="exception" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.InvalidOperationException">The underlying <see cref="T:System.Threading.Tasks.Task" /> is already in one of the three final states: <see cref="F:System.Threading.Tasks.TaskStatus.RanToCompletion" />, <see cref="F:System.Threading.Tasks.TaskStatus.Faulted" />, or <see cref="F:System.Threading.Tasks.TaskStatus.Canceled" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="SetResult">
@@ -231,6 +244,7 @@ The <xref:System.Threading.Tasks.Task> created by this instance and accessible t
       <Docs>
         <summary>Transitions the underlying <see cref="T:System.Threading.Tasks.Task" /> into the <see cref="F:System.Threading.Tasks.TaskStatus.RanToCompletion" /> state.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.InvalidOperationException">The underlying <see cref="T:System.Threading.Tasks.Task" /> is already in one of the three final states: <see cref="F:System.Threading.Tasks.TaskStatus.RanToCompletion" />, <see cref="F:System.Threading.Tasks.TaskStatus.Faulted" />, or <see cref="F:System.Threading.Tasks.TaskStatus.Canceled" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="Task">
@@ -363,6 +377,10 @@ This operation will return `false` if the <xref:System.Threading.Tasks.Task> is
 
           ]]></format>
         </remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="exceptions" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.ArgumentException">There are one or more <see langword="null" /> elements in <paramref name="exceptions" />.</exception>
+        <exception cref="T:System.ArgumentException">The <paramref name="exceptions" /> collection is empty.</exception>
       </Docs>
     </Member>
     <Member MemberName="TrySetException">
@@ -398,6 +416,8 @@ This operation will return `false` if the <xref:System.Threading.Tasks.Task> is
 
           ]]></format>
         </remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="exception" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="TrySetResult">

xml/System.Threading.Tasks/TaskCompletionSource`1.xml

@@ -1,4 +1,4 @@
-<Type Name="TaskCompletionSource&lt;TResult&gt;" FullName="System.Threading.Tasks.TaskCompletionSource&lt;TResult&gt;">
+<Type Name="TaskCompletionSource&lt;TResult&gt;" FullName="System.Threading.Tasks.TaskCompletionSource&lt;TResult&gt;">
   <TypeSignature Language="C#" Value="public class TaskCompletionSource&lt;TResult&gt;" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit TaskCompletionSource`1&lt;TResult&gt; extends System.Object" />
   <TypeSignature Language="DocId" Value="T:System.Threading.Tasks.TaskCompletionSource`1" />
@@ -323,6 +323,7 @@
         <param name="cancellationToken">The cancellation token with which to cancel the <see cref="T:System.Threading.Tasks.Task`1" />.</param>
         <summary>Transitions the underlying <see cref="T:System.Threading.Tasks.Task`1" /> into the <see cref="F:System.Threading.Tasks.TaskStatus.Canceled" /> state using the specified token.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.InvalidOperationException">The underlying <see cref="T:System.Threading.Tasks.Task`1" /> is already in one of the three final states: <see cref="F:System.Threading.Tasks.TaskStatus.RanToCompletion" />, <see cref="F:System.Threading.Tasks.TaskStatus.Faulted" />, or <see cref="F:System.Threading.Tasks.TaskStatus.Canceled" />.</exception>
       </Docs>
     </Member>
     <MemberGroup MemberName="SetException">