Port System.Threading.Tasks source comments to Docs (#2312)

* Port System.Threading.Tasks source comments to Docs

* Update xml/System.Threading.Tasks.Dataflow/BatchedJoinBlock`2.xml

Makes sense.

Co-Authored-By: carlossanlop <[email protected]>

* Update xml/System.Threading.Tasks.Dataflow/BatchedJoinBlock`2.xml

Makes sense. Thanks for the explanation.

Co-Authored-By: carlossanlop <[email protected]>

* Update xml/System.Threading.Tasks.Dataflow/DataflowBlockOptions.xml

Co-Authored-By: carlossanlop <[email protected]>

* Update xml/System.Threading.Tasks.Dataflow/DataflowBlockOptions.xml

Nice catch. This was not among the /// comments apparently.

Co-Authored-By: carlossanlop <[email protected]>

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

Co-Authored-By: carlossanlop <[email protected]>

* undo formatting change

* change formatting

Author: carlossanlop

xml/System.Threading.Tasks.Dataflow/BatchedJoinBlock`2.xml

@@ -111,7 +111,10 @@
         <param name="dataflowBlockOptions">The options with which to configure this <see cref="T:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2" />.</param>
         <summary>Initializes a new <see cref="T:System.Threading.Tasks.Dataflow.BatchedJoinBlock`2" /> with the specified configuration.</summary>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.ArgumentNullException">The <paramref name="dataflowBlockOptions" /> is <see langword="null" />.</exception>
+         <exception cref="T:System.ArgumentNullException">
+           <paramref name="dataflowBlockOptions" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="batchSize" /> is less than one.</exception>
       </Docs>
     </Member>
     <Member MemberName="BatchSize">
@@ -578,4 +581,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Threading.Tasks.Dataflow/DataflowBlockOptions.xml

@@ -276,4 +276,4 @@ is more important than maintaining the input-to-output ordering.
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Threading.Tasks/Parallel.xml

@@ -1014,6 +1014,7 @@
 
  The <see cref="M:System.Collections.Concurrent.Partitioner`1.GetPartitions(System.Int32)" /> method in the <paramref name="source" /> partitioner does not return the correct number of partitions.</exception>
         <related type="Article" href="https://docs.microsoft.com/previous-versions/msp-n-p/ff963552(v=pandp.10)">Parallel Loops</related>
+        <exception cref="T:System.AggregateException">The exception that is thrown to contain an exception thrown from one of the specified delegates.</exception>
       </Docs>
     </Member>
     <Member MemberName="ForEach&lt;TSource&gt;">
@@ -1086,6 +1087,7 @@
 
  The <see cref="M:System.Collections.Concurrent.Partitioner`1.GetPartitions(System.Int32)" /> method in the <paramref name="source" /> partitioner does not return the correct number of partitions.</exception>
         <related type="Article" href="https://docs.microsoft.com/previous-versions/msp-n-p/ff963552(v=pandp.10)">Parallel Loops</related>
+        <exception cref="T:System.AggregateException">The exception that is thrown to contain an exception thrown from one of the specified delegates.</exception>
       </Docs>
     </Member>
     <Member MemberName="ForEach&lt;TSource&gt;">
@@ -1333,6 +1335,7 @@
 
  The exception that is thrown when any methods in the <paramref name="source" /> orderable partitioner return <see langword="null" />.</exception>
         <related type="Article" href="https://docs.microsoft.com/previous-versions/msp-n-p/ff963552(v=pandp.10)">Parallel Loops</related>
+        <exception cref="T:System.AggregateException">The exception that is thrown to contain an exception thrown from one of the specified delegates.</exception>
       </Docs>
     </Member>
     <Member MemberName="ForEach&lt;TSource&gt;">
@@ -1400,6 +1403,7 @@
 
  The exception that is thrown when any methods in the <paramref name="source" /> partitioner return <see langword="null" />.</exception>
         <related type="Article" href="https://docs.microsoft.com/previous-versions/msp-n-p/ff963552(v=pandp.10)">Parallel Loops</related>
+        <exception cref="T:System.AggregateException">The exception that is thrown to contain an exception thrown from one of the specified delegates.</exception>
       </Docs>
     </Member>
     <Member MemberName="ForEach&lt;TSource&gt;">
@@ -1467,6 +1471,7 @@
 
  The exception that is thrown when any methods in the <paramref name="source" /> partitioner return <see langword="null" />.</exception>
         <related type="Article" href="https://docs.microsoft.com/previous-versions/msp-n-p/ff963552(v=pandp.10)">Parallel Loops</related>
+        <exception cref="T:System.AggregateException">The exception that is thrown to contain an exception thrown from one of the specified delegates.</exception>
       </Docs>
     </Member>
     <Member MemberName="ForEach&lt;TSource&gt;">
@@ -2422,4 +2427,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>