Merge pull request #10578 from dotnet/main

dotnet-policy-service[bot] · web-flow · commit 11d9bfe9b0a6 · 2024-10-17T14:15:03.000Z
Merge main into live
diff --git a/.github/policies/auto-merge.yml b/.github/policies/auto-merge.yml
@@ -18,9 +18,7 @@ configuration:
             branch: main
         - or:
             - isActivitySender:
-                user: dependabot
-            - isActivitySender:
-                user: dependabot[bot]
+                user: dotnet-policy-service[bot]
       then:
         - enableAutoMerge:
             mergeMethod: Squash
diff --git a/xml/System.Formats.Asn1/AsnDecoder.xml b/xml/System.Formats.Asn1/AsnDecoder.xml
@@ -43,12 +43,25 @@
         <Parameter Name="bytesConsumed" Type="System.Int32" RefType="out" Index="2" FrameworkAlternate="net-8.0;net-9.0;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8;netframework-4.8.1;netstandard-2.0" />
       </Parameters>
       <Docs>
-        <param name="source">To be added.</param>
-        <param name="ruleSet">To be added.</param>
-        <param name="bytesConsumed">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="source">The buffer containing encoded data.</param>
+        <param name="ruleSet">The encoding constraints to use when interpreting the data.</param>
+        <param name="bytesConsumed">
+          <para>When this method returns, contains the number of bytes from the beginning of <paramref name="source" /> that contributed to the length.</para>
+          <para>This parameter is treated as uninitialized.</para>
+        </param>
+        <summary>
+          <para>Decodes the data in <paramref name="source" /> as a length value under the specified encoding rules.</para>
+        </summary>
+        <returns>
+          <para>The decoded value of the length, or <see langword="null" /> if the encoded length represents the indefinite length.</para>
+        </returns>
+        <remarks>
+          <para>This method only processes the length portion of an ASN.1/BER Tag-Length-Value triplet, so <paramref name="source" /> needs to have already sliced off the encoded tag.</para>
+        </remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="ruleSet" /> is not a known <see cref="T:System.Formats.Asn1.AsnEncodingRules" /> value.</exception>
+        <exception cref="T:System.Formats.Asn1.AsnContentException">
+          <paramref name="source" /> does not decode as a length under the specified encoding rules.</exception>
       </Docs>
     </Member>
     <Member MemberName="ReadBitString">
@@ -1165,13 +1178,28 @@ The contents are not valid under the current encoding rules.</exception>
         <Parameter Name="bytesConsumed" Type="System.Int32" RefType="out" Index="3" FrameworkAlternate="net-8.0;net-9.0;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8;netframework-4.8.1;netstandard-2.0" />
       </Parameters>
       <Docs>
-        <param name="source">To be added.</param>
-        <param name="ruleSet">To be added.</param>
-        <param name="decodedLength">To be added.</param>
-        <param name="bytesConsumed">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="source">The buffer containing encoded data.</param>
+        <param name="ruleSet">The encoding constraints to use when interpreting the data.</param>
+        <param name="decodedLength">
+          <para>When this method returns, contains the decoded value of the length, or <see langword="null" /> if the encoded length represents the indefinite length.</para>
+          <para>This parameter is treated as uninitialized.</para>
+        </param>
+        <param name="bytesConsumed">
+          <para>When this method returns, contains the number of bytes from the beginning of <paramref name="source" /> that contributed to the length.</para>
+          <para>This parameter is treated as uninitialized.</para>
+        </param>
+        <summary>
+          <para>Attempts to decode the data in <paramref name="source" /> as a length value under the specified encoding rules.</para>
+        </summary>
+        <returns>
+          <para>
+            <see langword="true" /> if the buffer represents a valid length under the specified encoding rules; otherwise, <see langword="false" /></para>
+        </returns>
+        <remarks>
+          <para>This method only processes the length portion of an ASN.1/BER Tag-Length-Value triplet, so <paramref name="source" /> needs to have already sliced off the encoded tag.</para>
+        </remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="ruleSet" /> is not a known <see cref="T:System.Formats.Asn1.AsnEncodingRules" /> value.</exception>
       </Docs>
     </Member>
     <Member MemberName="TryReadBitString">
diff --git a/xml/System.Numerics/INumberBase`1.xml b/xml/System.Numerics/INumberBase`1.xml
@@ -758,6 +758,8 @@ A return value of `false` does not imply that <xref:System.Numerics.INumberBase%
 
 This function returns `true` for a complex number `a + bi` where `b` is zero.
 
+This function checks values against the extended real number line, thus returns `true` for positive and negative infinity.
+
           ]]></format>
         </remarks>
       </Docs>
diff --git a/xml/System.Runtime.InteropServices/NFloat.xml b/xml/System.Runtime.InteropServices/NFloat.xml
@@ -2372,6 +2372,8 @@ A return value of `false` does not imply that <xref:System.Numerics.INumberBase%
 
 This function returns `true` for a complex number `a + bi` where `b` is zero.
 
+This function checks values against the extended real number line, thus returns `true` for <xref:System.Runtime.InteropServices.NFloat.PositiveInfinity> and <xref:System.Runtime.InteropServices.NFloat.NegativeInfinity>.
+
           ]]></format>
         </remarks>
         <inheritdoc cref="M:System.Numerics.INumberBase`1.IsRealNumber(`0)" />
diff --git a/xml/System.Threading/Lock.xml b/xml/System.Threading/Lock.xml
@@ -30,7 +30,7 @@ It is recommended to use the <xref:System.Threading.Lock.EnterScope%2A> method w
 
 :::code language="csharp" source="~/snippets/csharp/System.Threading/Lock/Overview/UsagePatterns.cs" id="Snippet1":::
 
-When using the C# `lock` keyword or similar to enter and exit a lock, the type of the expression must be precisely `System.Threading.Lock`. If the type of the expression is anything else, such as `Object` or a generic type like `T`, a different implementation that is not interchangeable can be used instead (such as <xref:System.Threading.Monitor>). For more information, see the relevant [compiler speclet](https://github.com/dotnet/csharplang/blob/main/proposals/lock-object.md).
+When using the C# `lock` keyword or similar to enter and exit a lock, the type of the expression must be precisely `System.Threading.Lock`. If the type of the expression is anything else, such as `Object` or a generic type like `T`, a different implementation that is not interchangeable can be used instead (such as <xref:System.Threading.Monitor>). For more information, see the relevant [compiler speclet](https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/proposals/csharp-13.0/lock-object).
 
 <xref:System.Threading.Thread.Interrupt%2A> can interrupt threads that are waiting to enter a lock. On Windows STA threads, waits for locks allow message pumping that can run other code on the same thread during a wait. Some features of the waits can be overridden by a custom <xref:System.Threading.SynchronizationContext>.
 
diff --git a/xml/System/Double.xml b/xml/System/Double.xml
@@ -3112,6 +3112,8 @@ A return value of `false` does not imply that <xref:System.Numerics.INumberBase%
 
 This function returns `true` for a complex number `a + bi` where `b` is zero.
 
+This function checks values against the extended real number line, thus returns `true` for <xref:System.Double.PositiveInfinity> and <xref:System.Double.NegativeInfinity>.
+
           ]]></format>
         </remarks>
         <inheritdoc cref="M:System.Numerics.INumberBase`1.IsRealNumber(`0)" />
diff --git a/xml/System/Half.xml b/xml/System/Half.xml
@@ -2318,6 +2318,8 @@ A return value of `false` does not imply that <xref:System.Numerics.INumberBase%
 
 This function returns `true` for a complex number `a + bi` where `b` is zero.
 
+This function checks values against the extended real number line, thus returns `true` for <xref:System.Half.PositiveInfinity> and <xref:System.Half.NegativeInfinity>.
+
           ]]></format>
         </remarks>
         <inheritdoc cref="M:System.Numerics.INumberBase`1.IsRealNumber(`0)" />
diff --git a/xml/System/Single.xml b/xml/System/Single.xml
@@ -3129,6 +3129,8 @@ A return value of `false` does not imply that <xref:System.Numerics.INumberBase%
 
 This function returns `true` for a complex number `a + bi` where `b` is zero.
 
+This function checks values against the extended real number line, thus returns `true` for <xref:System.Single.PositiveInfinity> and <xref:System.Single.NegativeInfinity>.
+
           ]]></format>
         </remarks>
         <inheritdoc cref="M:System.Numerics.INumberBase`1.IsRealNumber(`0)" />
