coreclr: Automatic port of triple slash from System.Runtime.CompilerServices.C* (#2715)

* coreclr: Automatic port of triple slash from System.Runtime.CompilerServices.C*

* suggestion by anipik

* Update ConditionalWeakTable`2.xml

* Update ConfiguredCancelableAsyncEnumerable`1+Enumerator.xml

* Update ConfiguredCancelableAsyncEnumerable`1.xml

* Update ConfiguredValueTaskAwaitable+ConfiguredValueTaskAwaiter.xml

* Update ConfiguredValueTaskAwaitable.xml

* Update ConfiguredValueTaskAwaitable`1+ConfiguredValueTaskAwaiter.xml

* Update ConfiguredValueTaskAwaitable`1.xml

Author: carlossanlop

xml/System.Runtime.CompilerServices/ConditionalWeakTable`2.xml

@@ -232,10 +232,11 @@
         <Parameter Name="value" Type="TValue" Index="1" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <param name="key">To be added.</param>
-        <param name="value">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="key">The key to add or update. May not be <see langword="null" />.</param>
+        <param name="value">The value to associate with <paramref name="key" />.</param>
+        <summary>Adds the key and value if the key doesn't exist, or updates the existing key's value if it does exist.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException"><paramref name="key" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="Clear">
@@ -266,7 +267,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Clears all the key/value pairs.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -660,4 +661,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Runtime.CompilerServices/ConfiguredAsyncDisposable.xml

@@ -23,7 +23,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides a type that can be used to configure how awaits on an <see cref="T:System.IAsyncDisposable" /> are performed.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>

xml/System.Runtime.CompilerServices/ConfiguredCancelableAsyncEnumerable`1+Enumerator.xml

@@ -26,7 +26,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides an awaitable async enumerator that enables cancelable iteration and configured awaits.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -50,8 +50,8 @@
         <ReturnType>T</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets the element in the collection at the current position of the enumerator.</summary>
+        <value>The element in the collection at the current position of the enumerator.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -76,8 +76,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources asynchronously.</summary>
+        <returns>A task that represents the asynchronous dispose operation.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -102,10 +102,10 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Advances the enumerator asynchronously to the next element of the collection.</summary>
+        <returns>A <see cref="T:System.Runtime.CompilerServices.ConfiguredValueTaskAwaitable`1" /> that will complete with a result of <see langword="true" /> if the enumerator was successfully advanced to the next element, or <see langword="false" /> if the enumerator has passed the end of the collection.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Runtime.CompilerServices/ConfiguredCancelableAsyncEnumerable`1.xml

@@ -27,7 +27,7 @@
   </Attributes>
   <Docs>
     <typeparam name="T">To be added.</typeparam>
-    <summary>To be added.</summary>
+    <summary>Provides an awaitable async enumerable that enables cancelable iteration and configured awaits.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -54,10 +54,14 @@
         <Parameter Name="continueOnCapturedContext" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <param name="continueOnCapturedContext">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="continueOnCapturedContext"><see langword="true" /> to capture and marshal back to the current context; otherwise, <see langword="false" />.</param>
+        <summary>Configures how awaits on the tasks returned from an async iteration will be performed.</summary>
+        <returns>The configured enumerable.</returns>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+This will replace any previous value set by <xref:System.Runtime.CompilerServices.ConfiguredCancelableAsyncEnumerable`1.ConfigureAwait(System.Boolean)> for this iteration.
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="GetAsyncEnumerator">
@@ -108,11 +112,15 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <param name="cancellationToken">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="cancellationToken">The cancellation token to use.</param>
+        <summary>Sets the <see cref="T:System.Threading.CancellationToken" /> to be passed to <see cref="M:System.Collections.Generic.IAsyncEnumerable`1.GetAsyncEnumerator(System.Threading.CancellationToken)" /> when iterating.</summary>
+        <returns>The configured enumerable.</returns>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+This will replace any previous <xref:System.Threading.CancellationToken> set by <xref:System.Runtime.CompilerServices.ConfiguredCancelableAsyncEnumerable`1.WithCancellation(System.Threading.CancellationToken)> for this iteration.
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Runtime.CompilerServices/ConfiguredValueTaskAwaitable+ConfiguredValueTaskAwaiter.xml

@@ -30,7 +30,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides an awaiter for a <see cref="T:System.Runtime.CompilerServices.ConfiguredValueTaskAwaitable" />.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -55,7 +55,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the result of the ValueTask.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -79,8 +79,8 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets a value that indicates whether the <see cref="T:System.Runtime.CompilerServices.ConfiguredValueTaskAwaitable" /> has completed.</summary>
+        <value><see langword="true" /> if the <see cref="T:System.Runtime.CompilerServices.ConfiguredValueTaskAwaitable" /> has completed; otherwise, <see langword="false" />.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -110,8 +110,8 @@
         <Parameter Name="continuation" Type="System.Action" />
       </Parameters>
       <Docs>
-        <param name="continuation">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="continuation">The continuation action for the <see cref="T:System.Runtime.CompilerServices.ConfiguredValueTaskAwaitable" />.</param>
+        <summary>Schedules the continuation action for the <see cref="T:System.Runtime.CompilerServices.ConfiguredValueTaskAwaitable" />.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -141,10 +141,10 @@
         <Parameter Name="continuation" Type="System.Action" />
       </Parameters>
       <Docs>
-        <param name="continuation">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="continuation">The continuation action for the <see cref="T:System.Runtime.CompilerServices.ConfiguredValueTaskAwaitable" />.</param>
+        <summary>Schedules the continuation action for the <see cref="T:System.Runtime.CompilerServices.ConfiguredValueTaskAwaitable" />.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Runtime.CompilerServices/ConfiguredValueTaskAwaitable.xml

@@ -26,7 +26,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides an awaitable type that enables configured awaits on a <see cref="T:System.Threading.Tasks.ValueTask" />.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -54,10 +54,10 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Returns an awaiter for this <see cref="T:System.Runtime.CompilerServices.ConfiguredValueTaskAwaitable" /> instance.</summary>
+        <returns>The awaiter for this instance.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Runtime.CompilerServices/ConfiguredValueTaskAwaitable`1+ConfiguredValueTaskAwaiter.xml

@@ -39,7 +39,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides an awaiter for a <see cref="T:System.Runtime.CompilerServices.ConfiguredValueTaskAwaitable`1" />.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -70,8 +70,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Gets the result of the <see cref="T:System.Threading.Tasks.ValueTask`1" />.</summary>
+        <returns>The result of the <see cref="T:System.Threading.Tasks.ValueTask`1" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -101,8 +101,8 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets a value that indicates whether the <see cref="T:System.Runtime.CompilerServices.ConfiguredValueTaskAwaitable`1" /> has completed.</summary>
+        <value><see langword="true" /> if the <see cref="T:System.Runtime.CompilerServices.ConfiguredValueTaskAwaitable`1" /> has completed; otherwise, <see langword="false" />.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -138,8 +138,8 @@
         <Parameter Name="continuation" Type="System.Action" />
       </Parameters>
       <Docs>
-        <param name="continuation">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="continuation">The continuation action for the <see cref="T:System.Runtime.CompilerServices.ConfiguredValueTaskAwaitable`1" />.</param>
+        <summary>Schedules the continuation action for the <see cref="T:System.Runtime.CompilerServices.ConfiguredValueTaskAwaitable`1" />.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -175,10 +175,10 @@
         <Parameter Name="continuation" Type="System.Action" />
       </Parameters>
       <Docs>
-        <param name="continuation">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="continuation">The continuation action for the <see cref="T:System.Runtime.CompilerServices.ConfiguredValueTaskAwaitable`1" />.</param>
+        <summary>Schedules the continuation action for the <see cref="T:System.Runtime.CompilerServices.ConfiguredValueTaskAwaitable`1" />.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Runtime.CompilerServices/ConfiguredValueTaskAwaitable`1.xml

@@ -32,8 +32,8 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <typeparam name="TResult">To be added.</typeparam>
-    <summary>To be added.</summary>
+    <typeparam name="TResult">The type of the produced result.</typeparam>
+    <summary>Provides an awaitable type that enables configured awaits on a <see cref="T:System.Threading.Tasks.ValueTask`1" />.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -64,10 +64,10 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Returns an awaiter for this <see cref="T:System.Runtime.CompilerServices.ConfiguredValueTaskAwaitable`1" /> instance.</summary>
+        <returns>The awaiter for this instance.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>