Adding Api-docs for System.Runtime.CompilerServices (#2775)

* Adding docs for undocumented apis

* Adding fullstop and some other feedback

Co-Authored-By: Carlos Sanchez Lopez <1175054+carlossanlop@users.noreply.github.com>

* Addressing feedback

Co-Authored-By: Ron Petrusha <ronpet@microsoft.com>

* correcting switch Expression ctor for unmatched value

* Fixed bad cref.

Author: Anipik

xml/System.Runtime.CompilerServices/CallerArgumentExpressionAttribute.xml

@@ -19,7 +19,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Allows capturing of the expressions passed to a method.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -39,8 +39,8 @@
         <Parameter Name="parameterName" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="parameterName">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="parameterName">The name of the targeted parameter.</param>
+        <summary>Initializes a new instance of the <see cref="T:System.Runtime.CompilerServices.CallerArgumentExpressionAttribute" /> class.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -60,10 +60,10 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets the target parameter name of the CallerArgumentExpression</summary>
+        <value>The name of the targeted parameter of the CallerArgumentExpression</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Runtime.CompilerServices/ConfiguredAsyncDisposable.xml

@@ -48,8 +48,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Asynchronously releases the unmanaged resources used by the <see cref="T:System.Runtime.CompilerServices.ConfiguredAsyncDisposable" />.</summary>
+        <returns>A task that represents the asynchronous dispose operation.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

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

@@ -26,6 +26,7 @@
     </Attribute>
   </Attributes>
   <Docs>
+    <typeparam name="T">The type of values to enumerate.</typeparam>
     <summary>Provides an awaitable async enumerator that enables cancelable iteration and configured awaits.</summary>
     <remarks>To be added.</remarks>
   </Docs>

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

@@ -26,7 +26,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <typeparam name="T">To be added.</typeparam>
+    <typeparam name="T">The type of values to enumerate.</typeparam>
     <summary>Provides an awaitable async enumerable that enables cancelable iteration and configured awaits.</summary>
     <remarks>To be added.</remarks>
   </Docs>
@@ -85,8 +85,8 @@ This will replace any previous value set by <xref:System.Runtime.CompilerService
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Returns an enumerator that iterates asynchronously through collections that enables cancelable iteration and configured awaits.</summary>
+        <returns>An enumerator for the <see cref="T:System.Runtime.CompilerServices.ConfiguredCancelableAsyncEnumerable`1" /> class.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Runtime.CompilerServices/EnumeratorCancellationAttribute.xml

@@ -22,7 +22,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Allows users of async-enumerable methods to mark the parameter that should receive the cancellation token value from <see cref="M:System.Collections.Generic.IAsyncEnumerable`1.GetAsyncEnumerator(System.Threading.CancellationToken)" />.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -42,9 +42,9 @@
       </AssemblyInfo>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.Runtime.CompilerServices.EnumeratorCancellationAttribute" /> class.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Runtime.CompilerServices/MethodImplOptions.xml

@@ -120,7 +120,7 @@
       </ReturnValue>
       <MemberValue>512</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The method contains a hot path and should be optimized.</summary>
       </Docs>
     </Member>
     <Member MemberName="ForwardRef">
@@ -392,4 +392,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Runtime.CompilerServices/RuntimeFeature.xml

@@ -76,9 +76,9 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <summary></summary>
+        <value>Gets a value that determines whether the runtime compiles dynamic code.</value>
+        <remarks><see langword="true" /> if the runtime compiles dynamic code; <see langword="false" /> if it does not compile dynamic code or doesn't know about this property.</remarks>
       </Docs>
     </Member>
     <Member MemberName="IsDynamicCodeSupported">
@@ -104,8 +104,8 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets a value that determines whether the runtime supports dynamic code.</summary>
+        <value> <see langword="true" /> if the runtime supports dynamic code; <see langword="false" /> if it either doesn't support dynamic code or doesn't know about this property.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Runtime.CompilerServices/SwitchExpressionException.xml

@@ -51,7 +51,7 @@ A C# example of an expression that would throw this exception:
       </AssemblyInfo>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.Runtime.CompilerServices.SwitchExpressionException" /> class.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -75,8 +75,8 @@ A C# example of an expression that would throw this exception:
         <Parameter Name="innerException" Type="System.Exception" />
       </Parameters>
       <Docs>
-        <param name="innerException">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="innerException">The exception that is the cause of the current exception. If the <paramref name="innerException" /> parameter is not <see langword="null" />, the current exception is raised in a <see langword="catch" /> block that handles the inner exception.</param>
+        <summary>Initializes a new instance of the <see cref="T:System.Runtime.CompilerServices.SwitchExpressionException" /> class with a specified error message and a reference to the inner exception that is the cause of this exception.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -100,8 +100,8 @@ A C# example of an expression that would throw this exception:
         <Parameter Name="unmatchedValue" Type="System.Object" />
       </Parameters>
       <Docs>
-        <param name="unmatchedValue">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="unmatchedValue">The switch value that does not match any switch cases.</param>
+        <summary>Initializes a new instance of the <see cref="T:System.Runtime.CompilerServices.SwitchExpressionException" /> class with an unmatched switch value.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -125,8 +125,8 @@ A C# example of an expression that would throw this exception:
         <Parameter Name="message" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="message">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="message">The message to display to the end user.</param>
+        <summary>Initializes a new instance of the <see cref="T:System.Runtime.CompilerServices.SwitchExpressionException" /> class with the specified message.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -151,9 +151,9 @@ A C# example of an expression that would throw this exception:
         <Parameter Name="innerException" Type="System.Exception" />
       </Parameters>
       <Docs>
-        <param name="message">To be added.</param>
-        <param name="innerException">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="message">The message to display to the end user.</param>
+        <param name="innerException">A reference to the inner exception that is the cause of this exception.</param>
+        <summary>Initializes a new instance of the <see cref="T:System.Runtime.CompilerServices.SwitchExpressionException" /> class with the specified detailed description and the specified exception.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -181,9 +181,9 @@ A C# example of an expression that would throw this exception:
         <Parameter Name="context" Type="System.Runtime.Serialization.StreamingContext" />
       </Parameters>
       <Docs>
-        <param name="info">To be added.</param>
-        <param name="context">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="info">Stores the data that was being used to serialize or deserialize the object that the <see cref="T:System.ComponentModel.Design.Serialization.CodeDomSerializer" /> was serializing or deserializing.</param>
+        <param name="context">Describes the source and destination of the stream that generated the exception, as well as a means for serialization to retain that context and an additional caller-defined context.</param>
+        <summary>Sets the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> with the parameter name and additional exception information.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -206,8 +206,8 @@ A C# example of an expression that would throw this exception:
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets the exception message.</summary>
+        <value>The complete message string.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -231,8 +231,8 @@ A C# example of an expression that would throw this exception:
         <ReturnType>System.Object</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets the unmatched value associated with the exception.</summary>
+        <value>The unmatched value causing the exception.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>