Merge pull request #11321 from dotnet/main

Merge main into live

Author: dotnet-policy-service[bot]

xml/System.Text/Ascii.xml

@@ -16,8 +16,8 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>Provides helper methods for working with ASCII-encoded text as bytes or characters.</summary>
+    <remarks>For APIs that take both a source and a destination buffer, the behavior of the method is undefined if the source and destination buffers overlap, unless the description specifies otherwise. The behavior of all APIs is undefined if another thread mutates the buffers while these APIs are operating on them. All case-conversion APIs are culture-unaware.</remarks>
   </Docs>
   <Members>
     <Member MemberName="Equals">

xml/System/Double.xml

@@ -872,8 +872,8 @@ This computes `arctan(x) / π` in the interval `[-0.5, +0.5]`.
       </Parameters>
       <Docs>
         <param name="x">The value to be bitwise decremented.</param>
-        <summary>Decrements a value to the smallest value that compares less than a given value.</summary>
-        <returns>The smallest value that compares less than <paramref name="x" />.</returns>
+        <summary>Returns the largest value that compares less than a specified value.</summary>
+        <returns>The largest value that compares less than <paramref name="x" />.</returns>
         <remarks>To be added.</remarks>
         <inheritdoc cref="M:System.Numerics.IFloatingPointIeee754`1.BitDecrement(`0)" />
       </Docs>
@@ -910,7 +910,7 @@ This computes `arctan(x) / π` in the interval `[-0.5, +0.5]`.
       </Parameters>
       <Docs>
         <param name="x">The value to be bitwise incremented.</param>
-        <summary>Increments a value to the smallest value that compares greater than a given value.</summary>
+        <summary>Returns the smallest value that compares greater than a specified value.</summary>
         <returns>The smallest value that compares greater than <paramref name="x" />.</returns>
         <remarks>To be added.</remarks>
         <inheritdoc cref="M:System.Numerics.IFloatingPointIeee754`1.BitIncrement(`0)" />

xml/System/Single.xml

@@ -870,8 +870,8 @@ This computes `arctan(x) / π` in the interval `[-0.5, +0.5]`.
       </Parameters>
       <Docs>
         <param name="x">The value to be bitwise decremented.</param>
-        <summary>Decrements a value to the smallest value that compares less than a given value.</summary>
-        <returns>The smallest value that compares less than <paramref name="x" />.</returns>
+        <summary>Returns the largest value that compares less than a specified value.</summary>
+        <returns>The largest value that compares less than <paramref name="x" />.</returns>
         <remarks>To be added.</remarks>
         <inheritdoc cref="M:System.Numerics.IFloatingPointIeee754`1.BitDecrement(`0)" />
       </Docs>
@@ -908,7 +908,7 @@ This computes `arctan(x) / π` in the interval `[-0.5, +0.5]`.
       </Parameters>
       <Docs>
         <param name="x">The value to be bitwise incremented.</param>
-        <summary>Increments a value to the smallest value that compares greater than a given value.</summary>
+        <summary>Returns the smallest value that compares greater than a specified value.</summary>
         <returns>The smallest value that compares greater than <paramref name="x" />.</returns>
         <remarks>To be added.</remarks>
         <inheritdoc cref="M:System.Numerics.IFloatingPointIeee754`1.BitIncrement(`0)" />