Un-encode characters in xref links (Numerics/Collections/Buffers/Globalization/ComponentModel) (#12461)

Author: gewarren

xml/System.Buffers/ArrayBufferWriter`1.xml

@@ -314,7 +314,7 @@ You must clear the <xref:System.Buffers.ArrayBufferWriter`1> before trying to re
         <returns>A <see cref="T:System.Memory`1" /> whose length is at least <paramref name="sizeHint" />.  If <paramref name="sizeHint" /> is not provided or is equal to 0, some non-empty buffer is returned.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
-This method never returns <xref:System.Memory%601.Empty?displayProperty=nameWithType>.
+This method never returns <xref:System.Memory`1.Empty?displayProperty=nameWithType>.
           ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">
@@ -366,7 +366,7 @@ This method never returns <xref:System.Memory%601.Empty?displayProperty=nameWith
         <returns>A span of at least <paramref name="sizeHint" /> in length. If <paramref name="sizeHint" /> is not provided or is equal to 0, some non-empty buffer is returned.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
-This method never returns <xref:System.Span%601.Empty?displayProperty=nameWithType>.
+This method never returns <xref:System.Span`1.Empty?displayProperty=nameWithType>.
           ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">

xml/System.Buffers/ArrayPool`1.xml

@@ -68,12 +68,12 @@
     <typeparam name="T">The type of the objects that are in the resource pool.</typeparam>
     <summary>Provides a resource pool that enables reusing instances of type T[].</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
-  
- Using the <xref:System.Buffers.ArrayPool%601> class to rent and return buffers (using the <xref:System.Buffers.ArrayPool%601.Rent%2A> and <xref:System.Buffers.ArrayPool%601.Return%2A> methods) can improve performance in situations where arrays are created and destroyed frequently, resulting in significant memory pressure on the garbage collector.
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+ Using the <xref:System.Buffers.ArrayPool`1> class to rent and return buffers (using the <xref:System.Buffers.ArrayPool`1.Rent*> and <xref:System.Buffers.ArrayPool`1.Return*> methods) can improve performance in situations where arrays are created and destroyed frequently, resulting in significant memory pressure on the garbage collector.
+
  ]]></format>
     </remarks>
     <threadsafe>This class is thread-safe. All members may be used by multiple threads concurrently.</threadsafe>
@@ -113,11 +113,11 @@
       <Docs>
         <summary>Initializes a new instance of the <see cref="T:System.Buffers.ArrayPool`1" /> class.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
-  
-Note that this constructor is protected; it can only be called by classes derived from the <xref:System.Buffers.ArrayPool%601> class. 
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+Note that this constructor is protected; it can only be called by classes derived from the <xref:System.Buffers.ArrayPool`1> class.
  ]]></format>
         </remarks>
       </Docs>
@@ -208,11 +208,11 @@ Note that this constructor is protected; it can only be called by classes derive
         <summary>Creates a new instance of the <see cref="T:System.Buffers.ArrayPool`1" /> class using the specified configuration.</summary>
         <returns>A new instance of the <see cref="T:System.Buffers.ArrayPool`1" /> class with the specified configuration.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
-  
-The instance of the <xref:System.Buffers.ArrayPool%601> class created by this method will group arrays into buckets, with no more than `maxArraysPerBucket` in each bucket, and with those arrays not exceeding `maxArrayLength` in length.
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+The instance of the <xref:System.Buffers.ArrayPool`1> class created by this method will group arrays into buckets, with no more than `maxArraysPerBucket` in each bucket, and with those arrays not exceeding `maxArrayLength` in length.
  ]]></format>
         </remarks>
       </Docs>
@@ -259,13 +259,13 @@ The instance of the <xref:System.Buffers.ArrayPool%601> class created by this me
         <summary>Retrieves a buffer that is at least the requested length.</summary>
         <returns>An array of type T that is at least <paramref name="minimumLength" /> in length.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
 
-This buffer is loaned to the caller and should be returned to the same pool using the <xref:System.Buffers.ArrayPool%601.Return%2A> method, so that it can be reused in subsequent calls to the <xref:System.Buffers.ArrayPool%601.Rent%2A> method. Failure to return a rented buffer is not a fatal error. However, it may lead to decreased application performance, as the pool may need to create a new buffer to replace the lost one.
+This buffer is loaned to the caller and should be returned to the same pool using the <xref:System.Buffers.ArrayPool`1.Return*> method, so that it can be reused in subsequent calls to the <xref:System.Buffers.ArrayPool`1.Rent*> method. Failure to return a rented buffer is not a fatal error. However, it may lead to decreased application performance, as the pool may need to create a new buffer to replace the lost one.
 
-The array returned by this method may not be zero-initialized. 
+The array returned by this method may not be zero-initialized.
 ]]></format>
         </remarks>
       </Docs>
@@ -312,11 +312,11 @@ The array returned by this method may not be zero-initialized.
         <param name="clearArray">Indicates whether the contents of the buffer should be cleared before reuse. If <paramref name="clearArray" /> is set to <see langword="true" />, and if the pool will store the buffer to enable subsequent reuse, the <see cref="M:System.Buffers.ArrayPool`1.Return(`0[],System.Boolean)" /> method will clear the <paramref name="array" /> of its contents so that a subsequent caller using the <see cref="M:System.Buffers.ArrayPool`1.Rent(System.Int32)" /> method will not see the content of the previous caller. If <paramref name="clearArray" /> is set to <see langword="false" /> or if the pool will release the buffer, the array's contents are left unchanged.</param>
         <summary>Returns an array to the pool that was previously obtained using the <see cref="M:System.Buffers.ArrayPool`1.Rent(System.Int32)" /> method on the same <see cref="T:System.Buffers.ArrayPool`1" /> instance.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
+          <format type="text/markdown"><![CDATA[
 
-Once a buffer has been returned to the pool, the caller gives up all ownership of the buffer and must not use it. The reference returned from a given call to the <xref:System.Buffers.ArrayPool%601.Rent%2A> method must only be returned using the <xref:System.Buffers.ArrayPool%601.Return%2A> method once. The default <xref:System.Buffers.ArrayPool%601> may hold onto the returned buffer in order to rent it again, or it may release the returned buffer if it's determined that the pool already has enough buffers stored.
+## Remarks
+
+Once a buffer has been returned to the pool, the caller gives up all ownership of the buffer and must not use it. The reference returned from a given call to the <xref:System.Buffers.ArrayPool`1.Rent*> method must only be returned using the <xref:System.Buffers.ArrayPool`1.Return*> method once. The default <xref:System.Buffers.ArrayPool`1> may hold onto the returned buffer in order to rent it again, or it may release the returned buffer if it's determined that the pool already has enough buffers stored.
 
 > [!IMPORTANT]
 > Returning the same array reference twice or continuing to use the array reference after it has been returned is a high-severity security issue. These actions can lead to [double-free](https://cwe.mitre.org/data/definitions/415.html) and [use-after-free](https://cwe.mitre.org/data/definitions/416.html) vulnerabilities, which might result in data corruption, data leaks, and denial of service.
@@ -362,11 +362,11 @@ Once a buffer has been returned to the pool, the caller gives up all ownership o
         <summary>Gets a shared <see cref="T:System.Buffers.ArrayPool`1" /> instance.</summary>
         <value>A shared <see cref="T:System.Buffers.ArrayPool`1" /> instance.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
 
-The shared pool provides a default implementation of the <xref:System.Buffers.ArrayPool%601> class that's intended for general applicability. A shared class maintains arrays of multiple sizes, and may hand back a larger array than was actually requested, but it will never hand back a smaller array than was requested. Renting a buffer from a shared class using the <xref:System.Buffers.ArrayPool%601.Rent%2A> method will result in an existing buffer being taken from the pool if an appropriate buffer is available or in a new buffer being allocated if one is not available.
+The shared pool provides a default implementation of the <xref:System.Buffers.ArrayPool`1> class that's intended for general applicability. A shared class maintains arrays of multiple sizes, and may hand back a larger array than was actually requested, but it will never hand back a smaller array than was requested. Renting a buffer from a shared class using the <xref:System.Buffers.ArrayPool`1.Rent*> method will result in an existing buffer being taken from the pool if an appropriate buffer is available or in a new buffer being allocated if one is not available.
  ]]></format>
         </remarks>
       </Docs>

xml/System.Buffers/IBufferWriter`1.xml

@@ -124,11 +124,11 @@
         <summary>Returns a <see cref="T:System.Memory`1" /> to write to that is at least the requested size (specified by <paramref name="sizeHint" />).</summary>
         <returns>A <see cref="T:System.Memory`1" /> of at least the size <paramref name="sizeHint" />. If <paramref name="sizeHint" /> is 0, returns a non-empty buffer.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
+          <format type="text/markdown"><![CDATA[
 
 There is no guarantee that successive calls will return the same buffer or the same-sized buffer.
 
-This must never return <xref:System.Span%601.Empty?displayProperty=nameWithType>, but it can throw if the requested buffer size is not available.
+This must never return <xref:System.Span`1.Empty?displayProperty=nameWithType>, but it can throw if the requested buffer size is not available.
 
 You must request a new buffer after calling `Advance` to continue writing more data; you cannot write to a previously acquired buffer.
 
@@ -179,10 +179,10 @@ You must request a new buffer after calling `Advance` to continue writing more d
         <returns>A <see cref="T:System.Span`1" /> of at least the size <paramref name="sizeHint" />. If <paramref name="sizeHint" /> is 0, returns a non-empty buffer.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
-  
+
 There is no guarantee that successive calls will return the same buffer or the same-sized buffer.
 
-This method must never return <xref:System.Span%601.Empty?displayProperty=nameWithType>, but it can throw if the requested buffer size is not available.
+This method must never return <xref:System.Span`1.Empty?displayProperty=nameWithType>, but it can throw if the requested buffer size is not available.
 
 You must request a new buffer after calling `Advance` to continue writing more data; you cannot write to a previously acquired buffer.
          ]]></format>

xml/System.Buffers/IMemoryOwner`1.xml

@@ -67,9 +67,9 @@
     <typeparam name="T">The type of elements to store in memory.</typeparam>
     <summary>Identifies the owner of a block of memory who is responsible for disposing of the underlying memory appropriately. </summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
+      <format type="text/markdown"><![CDATA[
 
-The `IMemoryOwner<T>` interface is used to define the owner responsible for the lifetime management of a <xref:System.Memory%601> buffer. An instance of the `IMemoryOwner<T>` interface is returned by the <xref:System.Buffers.MemoryPool%601.Rent%2A?displayProperty=nameWithType> method. 
+The `IMemoryOwner<T>` interface is used to define the owner responsible for the lifetime management of a <xref:System.Memory`1> buffer. An instance of the `IMemoryOwner<T>` interface is returned by the <xref:System.Buffers.MemoryPool`1.Rent*?displayProperty=nameWithType> method.
 
 While a buffer can have multiple consumers, it can only have a single owner at any given time. The owner can:
 
@@ -79,7 +79,7 @@ While a buffer can have multiple consumers, it can only have a single owner at a
 
 - Destroy the buffer when it is no longer in use.
 
-Because the `IMemoryOwner<T>` object implements the <xref:System.IDisposable> interface, you should call its <xref:System.IDisposable.Dispose%2A> method only after the memory buffer is no longer needed and you have destroyed it. You should *not* dispose of the `IMemoryOwner<T>` object while a reference to its memory is available. This means that the type in which `IMemoryOwner<T>` is declared should not have a <xref:System.Object.Finalize%2A> method.
+Because the `IMemoryOwner<T>` object implements the <xref:System.IDisposable> interface, you should call its <xref:System.IDisposable.Dispose*> method only after the memory buffer is no longer needed and you have destroyed it. You should *not* dispose of the `IMemoryOwner<T>` object while a reference to its memory is available. This means that the type in which `IMemoryOwner<T>` is declared should not have a <xref:System.Object.Finalize*> method.
 
    ]]></format>
     </remarks>

xml/System.Buffers/IPinnable.xml

@@ -52,11 +52,11 @@
   <Docs>
     <summary>Provides a mechanism for pinning and unpinning objects to prevent the garbage collector from moving them.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
+      <format type="text/markdown"><![CDATA[
 
-The <xref:System.Buffers.MemoryManager%601> class implements the `IPinnable` interface.
+## Remarks
+
+The <xref:System.Buffers.MemoryManager`1> class implements the `IPinnable` interface.
 
        ]]></format>
     </remarks>
@@ -104,11 +104,11 @@ The <xref:System.Buffers.MemoryManager%601> class implements the `IPinnable` int
         <summary>Pins a block of memory.</summary>
         <returns>A handle to the block of memory.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
 
-A developer can access an object that implements the <xref:System.Buffers.IPinnable> interface without pinning it only through managed APIs. Pinning is required for access by unmanaged APIs. 
+A developer can access an object that implements the <xref:System.Buffers.IPinnable> interface without pinning it only through managed APIs. Pinning is required for access by unmanaged APIs.
 
 Call this method to indicate that the <xref:System.Buffers.IPinnable> object cannot be moved by the garbage collector so that the address of the pinned object can be used.
 
@@ -155,9 +155,9 @@ Call this method to indicate that the <xref:System.Buffers.IPinnable> object can
       <Docs>
         <summary>Frees a block of pinned memory.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
 
 Call this method to indicate that the <xref:System.Buffers.IPinnable> object no longer needs to be pinned, and that the garbage collector can now move the object.
 

xml/System.Buffers/MemoryHandle.xml

@@ -64,10 +64,10 @@
 
 A `MemoryHandle` instance represents a handle to a pinned block of memory. It is returned by the following methods:
 
-- <xref:System.Buffers.IPinnable.Pin%2A?displayProperty=nameWithType>.
-- <xref:System.Memory%601.Pin%2A?displayProperty=nameWithType>
-- <xref:System.ReadOnlyMemory%601.Pin%2A?displayProperty=nameWithType>.
-- <xref:System.Buffers.MemoryManager%601.Pin%2A?displayProperty=nameWithType>
+- <xref:System.Buffers.IPinnable.Pin*?displayProperty=nameWithType>.
+- <xref:System.Memory`1.Pin*?displayProperty=nameWithType>
+- <xref:System.ReadOnlyMemory`1.Pin*?displayProperty=nameWithType>.
+- <xref:System.Buffers.MemoryManager`1.Pin*?displayProperty=nameWithType>
 
  ]]></format>
     </remarks>

xml/System.Buffers/MemoryManager`1.xml

@@ -75,9 +75,9 @@
     <typeparam name="T">The type of items in the memory buffer managed by this memory manager.</typeparam>
     <summary>An abstract base class that is used to replace the implementation of <see cref="T:System.Memory`1" />.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
+      <format type="text/markdown"><![CDATA[
 
-The `MemoryManager<T>` class is used to extend the knowledge of types that <xref:System.Memory%601> is able to represent. For example, you can derive from `MemoryManager<T>` to allow <xref:System.Memory%601> to be backed by a <xref:System.Runtime.InteropServices.SafeHandle>.
+The `MemoryManager<T>` class is used to extend the knowledge of types that <xref:System.Memory`1> is able to represent. For example, you can derive from `MemoryManager<T>` to allow <xref:System.Memory`1> to be backed by a <xref:System.Runtime.InteropServices.SafeHandle>.
 
 > [!NOTE]
 > The `MemoryManager<T>` class is intended for advanced scenarios. Most developers do not need to use it.