System.Reflection docs

Author: ericstj

xml/System.Reflection.Metadata/AssemblyNameInfo.xml

@@ -95,7 +95,9 @@
       <Docs>
         <summary>Gets the name of the culture associated with the assembly.</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <para>Do not create a <see cref="T:System.Globalization.CultureInfo" /> instance from this string unless you know the string has originated from a trustworthy source.</para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="Flags">
@@ -251,7 +253,9 @@
       <Docs>
         <summary>Initializes a new instance of the <see cref="T:System.Reflection.AssemblyName" /> class based on the stored information.</summary>
         <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <para>Do not create an <see cref="T:System.Reflection.AssemblyName" /> instance with <see cref="P:System.Reflection.Metadata.AssemblyNameInfo.CultureName" /> string unless you know the string has originated from a trustworthy source.</para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="TryParse">

xml/System.Reflection.Metadata/TypeName.xml

@@ -254,6 +254,9 @@
           inspecting that. "Dictionary<string, List<int[][]>>" has node count 8 because fully visiting it involves inspecting 8
           <see cref="T:System.Reflection.Metadata.TypeName" /> instances total:
           <list type="bullet"><item>Dictionary&lt;string, List&lt;int[][]&gt;&gt; (the original type)</item><item>Dictionary`2 (the generic type definition)</item><item>string (a type argument of Dictionary)</item><item>List&lt;int[][]&gt; (a type argument of Dictionary)</item><item>List`1 (the generic type definition)</item><item>int[][] (a type argument of List)</item><item>int[] (the underlying type of int[][])</item><item>int (the underlying type of int[])</item></list></remarks>
+        <exception cref="T:System.OverflowException">
+          <para>The total number of <see cref="T:System.Reflection.Metadata.TypeName" /> instances that are used to describe this instance exceed <see cref="F:System.Int32.MaxValue" />.</para>
+        </exception>
       </Docs>
     </Member>
     <Member MemberName="IsArray">
@@ -624,9 +627,10 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The namespace of this type; e.g., "System".</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.InvalidOperationException">This instance is a nested type.</exception>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -734,10 +738,13 @@
         <Parameter Name="name" Type="System.String" Index="0" FrameworkAlternate="net-10.0;net-10.0-pp;net-8.0-pp;net-9.0-pp;netframework-4.6.2-pp;netframework-4.7.1-pp;netframework-4.7.2-pp;netframework-4.7-pp;netframework-4.8.1-pp;netframework-4.8-pp;netstandard-2.0-pp" />
       </Parameters>
       <Docs>
-        <param name="name">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="name">The input string containing the name to convert.</param>
+        <summary>Converts any escaped characters in the input type name or namespace.</summary>
+        <returns>A string of characters with any escaped characters converted to their unescaped form.</returns>
+        <remarks>
+          <para>The unescaped string can be used for looking up the type name or namespace in metadata.</para>
+          <para>This method removes escape characters even if they precede a character that does not require escaping.</para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="WithAssemblyName">

xml/System.Reflection/ConstructorInvoker.xml

@@ -24,6 +24,7 @@
   <Docs>
     <summary>Provides methods to invoke the method specified by the provided <see cref="T:System.Reflection.ConstructorInfo" />.</summary>
     <remarks>This class provides better performance than <see cref="M:System.Reflection.ConstructorInfo.Invoke(System.Object[])" /> when compatibility with that method is not necessary and when the caller can cache the ConstructorInvoker instance for additional invoke calls. Unlike <see cref="M:System.Reflection.ConstructorInfo.Invoke(System.Object[])" />, the invoke methods in this class don't look up default values for arguments when <see cref="F:System.Type.Missing" /> is specified. In addition, the target constructor may be inlined for performance and not appear in stack traces.</remarks>
+    <seealso cref="T:System.Reflection.MethodInvoker" />
   </Docs>
   <Members>
     <Member MemberName="Create">

xml/System.Reflection/MethodInvoker.xml

@@ -24,6 +24,7 @@
   <Docs>
     <summary>Provides methods to invoke the method specified by the provided <see cref="T:System.Reflection.MethodBase" />.</summary>
     <remarks>The methods in this class provide better performance than <see cref="M:System.Reflection.MethodBase.Invoke(System.Object,System.Object[])" /> when compatibility with that method isn't necessary and when the caller can cache the MethodInvoker instance for additional invoke calls. Unlike <see cref="M:System.Reflection.MethodBase.Invoke(System.Object,System.Object[])" />, the invoke methods in this class don't look up default values for arguments when <see cref="F:System.Type.Missing" /> is specified. In addition, the target method may be inlined for performance and not appear in stack traces.</remarks>
+    <seealso cref="T:System.Reflection.ConstructorInvoker" />
   </Docs>
   <Members>
     <Member MemberName="Create">