Add MemberGroup descriptions (System.Reflection)

xml/System.Reflection.Emit/ModuleBuilder.xml

@@ -231,6 +231,11 @@
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
+    <MemberGroup MemberName="DefineDocument">
+      <Docs>
+        <summary>Defines a document for source.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="DefineDocument">
       <MemberSignature Language="C#" Value="public System.Diagnostics.SymbolStore.ISymbolDocumentWriter DefineDocument (string url, Guid language = default);" />
       <MemberSignature Language="ILAsm" Value=".method public hidebysig instance class System.Diagnostics.SymbolStore.ISymbolDocumentWriter DefineDocument(string url, valuetype System.Guid language) cil managed" />
@@ -2691,6 +2696,11 @@
         <altmember cref="T:System.Reflection.ParameterModifier" />
       </Docs>
     </Member>
+    <MemberGroup MemberName="GetMethodMetadataToken">
+      <Docs>
+        <summary>When overridden in a derived class, returns the metadata token for the given <see cref="T:System.Reflection.MethodBase" /> relative to the module.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="GetMethodMetadataToken">
       <MemberSignature Language="C#" Value="public abstract int GetMethodMetadataToken (System.Reflection.ConstructorInfo constructor);" />
       <MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance int32 GetMethodMetadataToken(class System.Reflection.ConstructorInfo constructor) cil managed" />

xml/System.Reflection.Emit/PersistedAssemblyBuilder.xml

@@ -253,6 +253,11 @@ For an alternative way to generate assembly files, see <xref:System.Reflection.M
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
+    <MemberGroup MemberName="GenerateMetadata">
+      <Docs>
+        <summary>Generates the metadata for the <see cref="T:System.Reflection.Emit.PersistedAssemblyBuilder" />.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="GenerateMetadata">
       <MemberSignature Language="C#" Value="public System.Reflection.Metadata.Ecma335.MetadataBuilder GenerateMetadata (out System.Reflection.Metadata.BlobBuilder ilStream, out System.Reflection.Metadata.BlobBuilder mappedFieldData);" />
       <MemberSignature Language="ILAsm" Value=".method public hidebysig instance class System.Reflection.Metadata.Ecma335.MetadataBuilder GenerateMetadata([out] class System.Reflection.Metadata.BlobBuilder&amp; ilStream, [out] class System.Reflection.Metadata.BlobBuilder&amp; mappedFieldData) cil managed" />
@@ -414,6 +419,11 @@ For an alternative way to generate assembly files, see <xref:System.Reflection.M
           <see cref="T:System.Reflection.Emit.PersistedAssemblyBuilder" /> supports only one module per assembly.</remarks>
       </Docs>
     </Member>
+    <MemberGroup MemberName="Save">
+      <Docs>
+        <summary>Saves the assembly to disk.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="Save">
       <MemberSignature Language="C#" Value="public void Save (System.IO.Stream stream);" />
       <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Save(class System.IO.Stream stream) cil managed" />

xml/System.Reflection.Metadata.Ecma335/BlobEncoder.xml

@@ -106,6 +106,11 @@
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
+    <MemberGroup MemberName="CustomAttributeSignature">
+      <Docs>
+        <summary>Encodes custom attribute signature blob.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="CustomAttributeSignature">
       <MemberSignature Language="C#" Value="public void CustomAttributeSignature (Action&lt;System.Reflection.Metadata.Ecma335.FixedArgumentsEncoder&gt; fixedArguments, Action&lt;System.Reflection.Metadata.Ecma335.CustomAttributeNamedArgumentsEncoder&gt; namedArguments);" />
       <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void CustomAttributeSignature(class System.Action`1&lt;valuetype System.Reflection.Metadata.Ecma335.FixedArgumentsEncoder&gt; fixedArguments, class System.Action`1&lt;valuetype System.Reflection.Metadata.Ecma335.CustomAttributeNamedArgumentsEncoder&gt; namedArguments) cil managed" />

xml/System.Reflection.Metadata.Ecma335/EditAndContinueLogEntry.xml

@@ -79,6 +79,11 @@
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
+    <MemberGroup MemberName="Equals">
+      <Docs>
+        <summary>Indicates whether the current object is equal to another object of the same type.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="Equals">
       <MemberSignature Language="C#" Value="public override bool Equals (object? obj);" FrameworkAlternate="net-10.0;net-10.0-pp;net-11.0;net-11.0-pp;net-5.0;net-6.0;net-7.0;net-8.0;net-9.0;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" />
       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance bool Equals(object obj) cil managed" />

xml/System.Reflection.Metadata.Ecma335/InstructionEncoder.xml

@@ -143,6 +143,11 @@ This example shows how to emit a method body using <xref:System.Reflection.Metad
           <paramref name="label" /> has default value.</exception>
       </Docs>
     </Member>
+    <MemberGroup MemberName="Call">
+      <Docs>
+        <summary>Encodes <c>call</c> instruction and its operand.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="Call">
       <MemberSignature Language="C#" Value="public void Call (System.Reflection.Metadata.EntityHandle methodHandle);" />
       <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Call(valuetype System.Reflection.Metadata.EntityHandle methodHandle) cil managed" />
@@ -977,6 +982,11 @@ A single label may be marked multiple times, the last offset wins.
           <see cref="M:System.Reflection.Metadata.Ecma335.SwitchInstructionEncoder.Branch(System.Reflection.Metadata.Ecma335.LabelHandle)" /> was not called on the returned value exactly <paramref name="branchCount" /> times.</exception>
       </Docs>
     </Member>
+    <MemberGroup MemberName="Token">
+      <Docs>
+        <summary>Encodes a token.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="Token">
       <MemberSignature Language="C#" Value="public void Token (int token);" />
       <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Token(int32 token) cil managed" />

xml/System.Reflection.Metadata.Ecma335/LabelHandle.xml

@@ -42,6 +42,11 @@
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
+    <MemberGroup MemberName="Equals">
+      <Docs>
+        <summary>Indicates whether the current object is equal to another object of the same type.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="Equals">
       <MemberSignature Language="C#" Value="public override bool Equals (object? obj);" FrameworkAlternate="net-10.0;net-10.0-pp;net-11.0;net-11.0-pp;net-5.0;net-6.0;net-7.0;net-8.0;net-9.0;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" />
       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance bool Equals(object obj) cil managed" />

xml/System.Reflection.Metadata.Ecma335/LiteralEncoder.xml

@@ -139,6 +139,11 @@
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
+    <MemberGroup MemberName="TaggedScalar">
+      <Docs>
+        <summary>Encodes the type and the value of a literal using the specified delegates.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="TaggedScalar">
       <MemberSignature Language="C#" Value="public void TaggedScalar (Action&lt;System.Reflection.Metadata.Ecma335.CustomAttributeElementTypeEncoder&gt; type, Action&lt;System.Reflection.Metadata.Ecma335.ScalarEncoder&gt; scalar);" />
       <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void TaggedScalar(class System.Action`1&lt;valuetype System.Reflection.Metadata.Ecma335.CustomAttributeElementTypeEncoder&gt; type, class System.Action`1&lt;valuetype System.Reflection.Metadata.Ecma335.ScalarEncoder&gt; scalar) cil managed" />
@@ -215,6 +220,11 @@
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
+    <MemberGroup MemberName="TaggedVector">
+      <Docs>
+        <summary>Encodes the type and the items of a vector literal using the specified delegates.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="TaggedVector">
       <MemberSignature Language="C#" Value="public void TaggedVector (Action&lt;System.Reflection.Metadata.Ecma335.CustomAttributeArrayTypeEncoder&gt; arrayType, Action&lt;System.Reflection.Metadata.Ecma335.VectorEncoder&gt; vector);" />
       <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void TaggedVector(class System.Action`1&lt;valuetype System.Reflection.Metadata.Ecma335.CustomAttributeArrayTypeEncoder&gt; arrayType, class System.Action`1&lt;valuetype System.Reflection.Metadata.Ecma335.VectorEncoder&gt; vector) cil managed" />

xml/System.Reflection.Metadata.Ecma335/MetadataAggregator.xml

@@ -39,6 +39,11 @@
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
+    <MemberGroup MemberName=".ctor">
+      <Docs>
+        <summary>Initializes a new instance of the <see cref="T:System.Reflection.Metadata.Ecma335.MetadataAggregator" /> class.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName=".ctor">
       <MemberSignature Language="C#" Value="public MetadataAggregator (System.Reflection.Metadata.MetadataReader baseReader, System.Collections.Generic.IReadOnlyList&lt;System.Reflection.Metadata.MetadataReader&gt; deltaReaders);" />
       <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Reflection.Metadata.MetadataReader baseReader, class System.Collections.Generic.IReadOnlyList`1&lt;class System.Reflection.Metadata.MetadataReader&gt; deltaReaders) cil managed" />

xml/System.Reflection.Metadata.Ecma335/MetadataBuilder.xml

@@ -2067,6 +2067,11 @@ Entries must be added in the same order as the corresponding type definitions.
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
+    <MemberGroup MemberName="GetOrAddBlob">
+      <Docs>
+        <summary>Adds the specified blob to the Blob heap, if it's not there already.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="GetOrAddBlob">
       <MemberSignature Language="C#" Value="public System.Reflection.Metadata.BlobHandle GetOrAddBlob (byte[] value);" />
       <MemberSignature Language="ILAsm" Value=".method public hidebysig instance valuetype System.Reflection.Metadata.BlobHandle GetOrAddBlob(unsigned int8[] value) cil managed" />
@@ -2600,6 +2605,11 @@ For more information about document name blobs, see: https://github.com/dotnet/r
           <paramref name="length" /> is negative.</exception>
       </Docs>
     </Member>
+    <MemberGroup MemberName="SetCapacity">
+      <Docs>
+        <summary>Sets the capacity of the specified heap.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="SetCapacity">
       <MemberSignature Language="C#" Value="public void SetCapacity (System.Reflection.Metadata.Ecma335.HeapIndex heap, int byteCount);" />
       <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void SetCapacity(valuetype System.Reflection.Metadata.Ecma335.HeapIndex heap, int32 byteCount) cil managed" />

xml/System.Reflection.Metadata.Ecma335/MetadataReaderExtensions.xml

@@ -217,6 +217,11 @@
           <paramref name="heapIndex" /> is not a valid heap index.</exception>
       </Docs>
     </Member>
+    <MemberGroup MemberName="GetNextHandle">
+      <Docs>
+        <summary>Returns the a handle to the string that follows the given one in the string heap, or a null handle if it's the last one.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="GetNextHandle">
       <MemberSignature Language="C#" Value="public static System.Reflection.Metadata.BlobHandle GetNextHandle (this System.Reflection.Metadata.MetadataReader reader, System.Reflection.Metadata.BlobHandle handle);" />
       <MemberSignature Language="ILAsm" Value=".method public static hidebysig valuetype System.Reflection.Metadata.BlobHandle GetNextHandle(class System.Reflection.Metadata.MetadataReader reader, valuetype System.Reflection.Metadata.BlobHandle handle) cil managed" />

xml/System.Reflection.Metadata.Ecma335/MetadataTokens.xml

@@ -372,6 +372,11 @@
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
+    <MemberGroup MemberName="EntityHandle">
+      <Docs>
+        <summary>Creates an entity handle from a token value.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="EntityHandle">
       <MemberSignature Language="C#" Value="public static System.Reflection.Metadata.EntityHandle EntityHandle (int token);" />
       <MemberSignature Language="ILAsm" Value=".method public static hidebysig valuetype System.Reflection.Metadata.EntityHandle EntityHandle(int32 token) cil managed" />
@@ -637,6 +642,11 @@
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
+    <MemberGroup MemberName="GetHeapOffset">
+      <Docs>
+        <summary>Gets the offset of metadata heap data that corresponds to the specified <paramref name="handle" />.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="GetHeapOffset">
       <MemberSignature Language="C#" Value="public static int GetHeapOffset (System.Reflection.Metadata.BlobHandle handle);" FrameworkAlternate="net-10.0;net-10.0-pp;net-11.0;net-11.0-pp;net-5.0;net-6.0;net-7.0;net-8.0;net-9.0;netcore-1.1;netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netcore-3.1;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" />
       <MemberSignature Language="ILAsm" Value=".method public static hidebysig int32 GetHeapOffset(valuetype System.Reflection.Metadata.BlobHandle handle) cil managed" FrameworkAlternate="net-10.0;net-10.0-pp;net-11.0;net-11.0-pp;net-5.0;net-6.0;net-7.0;net-8.0;net-9.0;netcore-1.1;netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netcore-3.1;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" />
@@ -859,6 +869,11 @@
         <exception cref="T:System.ArgumentException">The <paramref name="handle" /> is invalid.</exception>
       </Docs>
     </Member>
+    <MemberGroup MemberName="GetRowNumber">
+      <Docs>
+        <summary>Gets the row number of a metadata table entry that corresponds to the specified <paramref name="handle" />.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="GetRowNumber">
       <MemberSignature Language="C#" Value="public static int GetRowNumber (System.Reflection.Metadata.EntityHandle handle);" />
       <MemberSignature Language="ILAsm" Value=".method public static hidebysig int32 GetRowNumber(valuetype System.Reflection.Metadata.EntityHandle handle) cil managed" />
@@ -937,6 +952,11 @@
         <exception cref="T:System.ArgumentException">The <paramref name="handle" /> is not a valid metadata table handle.</exception>
       </Docs>
     </Member>
+    <MemberGroup MemberName="GetToken">
+      <Docs>
+        <summary>Gets the metadata token of the specified <paramref name="handle" />.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="GetToken">
       <MemberSignature Language="C#" Value="public static int GetToken (System.Reflection.Metadata.EntityHandle handle);" />
       <MemberSignature Language="ILAsm" Value=".method public static hidebysig int32 GetToken(valuetype System.Reflection.Metadata.EntityHandle handle) cil managed" />
@@ -1132,6 +1152,11 @@
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
+    <MemberGroup MemberName="Handle">
+      <Docs>
+        <summary>Creates a handle from a token value.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="Handle">
       <MemberSignature Language="C#" Value="public static System.Reflection.Metadata.Handle Handle (int token);" />
       <MemberSignature Language="ILAsm" Value=".method public static hidebysig valuetype System.Reflection.Metadata.Handle Handle(int32 token) cil managed" />

xml/System.Reflection.Metadata.Ecma335/MethodBodyStreamEncoder.xml

@@ -74,6 +74,11 @@
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
+    <MemberGroup MemberName="AddMethodBody">
+      <Docs>
+        <summary>Encodes a method body and adds it to the method body stream.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="AddMethodBody">
       <MemberSignature Language="C#" Value="public int AddMethodBody (System.Reflection.Metadata.Ecma335.InstructionEncoder instructionEncoder, int maxStack, System.Reflection.Metadata.StandaloneSignatureHandle localVariablesSignature, System.Reflection.Metadata.Ecma335.MethodBodyAttributes attributes);" FrameworkAlternate="net-10.0;net-10.0-pp;net-11.0;net-11.0-pp;net-5.0;net-6.0;net-7.0;net-8.0;net-9.0;netcore-2.1;netcore-2.2;netcore-3.0;netcore-3.1;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" />
       <MemberSignature Language="ILAsm" Value=".method public hidebysig instance int32 AddMethodBody(valuetype System.Reflection.Metadata.Ecma335.InstructionEncoder instructionEncoder, int32 maxStack, valuetype System.Reflection.Metadata.StandaloneSignatureHandle localVariablesSignature, valuetype System.Reflection.Metadata.Ecma335.MethodBodyAttributes attributes) cil managed" />

xml/System.Reflection.Metadata.Ecma335/MethodSignatureEncoder.xml

@@ -140,6 +140,11 @@
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
+    <MemberGroup MemberName="Parameters">
+      <Docs>
+        <summary>Encodes the provided return type and parameters.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="Parameters">
       <MemberSignature Language="C#" Value="public void Parameters (int parameterCount, Action&lt;System.Reflection.Metadata.Ecma335.ReturnTypeEncoder&gt; returnType, Action&lt;System.Reflection.Metadata.Ecma335.ParametersEncoder&gt; parameters);" />
       <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Parameters(int32 parameterCount, class System.Action`1&lt;valuetype System.Reflection.Metadata.Ecma335.ReturnTypeEncoder&gt; returnType, class System.Action`1&lt;valuetype System.Reflection.Metadata.Ecma335.ParametersEncoder&gt; parameters) cil managed" />

xml/System.Reflection.Metadata.Ecma335/NamedArgumentsEncoder.xml

@@ -74,6 +74,11 @@
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
+    <MemberGroup MemberName="AddArgument">
+      <Docs>
+        <summary>Encodes a named argument (a field or property).</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="AddArgument">
       <MemberSignature Language="C#" Value="public void AddArgument (bool isField, Action&lt;System.Reflection.Metadata.Ecma335.NamedArgumentTypeEncoder&gt; type, Action&lt;System.Reflection.Metadata.Ecma335.NameEncoder&gt; name, Action&lt;System.Reflection.Metadata.Ecma335.LiteralEncoder&gt; literal);" />
       <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void AddArgument(bool isField, class System.Action`1&lt;valuetype System.Reflection.Metadata.Ecma335.NamedArgumentTypeEncoder&gt; type, class System.Action`1&lt;valuetype System.Reflection.Metadata.Ecma335.NameEncoder&gt; name, class System.Action`1&lt;valuetype System.Reflection.Metadata.Ecma335.LiteralEncoder&gt; literal) cil managed" />

xml/System.Reflection.Metadata.Ecma335/SignatureTypeEncoder.xml

@@ -74,6 +74,11 @@
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
+    <MemberGroup MemberName="Array">
+      <Docs>
+        <summary>Encodes an array type.</summary>
+      </Docs>
+    </MemberGroup>
     <Member MemberName="Array">
       <MemberSignature Language="C#" Value="public void Array (Action&lt;System.Reflection.Metadata.Ecma335.SignatureTypeEncoder&gt; elementType, Action&lt;System.Reflection.Metadata.Ecma335.ArrayShapeEncoder&gt; arrayShape);" />
       <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Array(class System.Action`1&lt;valuetype System.Reflection.Metadata.Ecma335.SignatureTypeEncoder&gt; elementType, class System.Action`1&lt;valuetype System.Reflection.Metadata.Ecma335.ArrayShapeEncoder&gt; arrayShape) cil managed" />