Merge pull request #12057 from dotnet/main

Merge main into live

Author: gewarren

xml/System.Numerics/Vector.xml

@@ -3982,7 +3982,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <summary>To be added.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
-        <inheritdoc cref="M:System.Numerics.Vector.ExtractMostSignificantBits(System.Numerics.Vector4)" />
+        <inheritdoc cref="M:System.Runtime.Intrinsics.Vector128.ExtractMostSignificantBits``1(System.Runtime.Intrinsics.Vector128{``0})" />
       </Docs>
     </Member>
     <Member MemberName="ExtractMostSignificantBits">
@@ -4017,7 +4017,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <summary>To be added.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
-        <inheritdoc cref="M:System.Numerics.Vector.ExtractMostSignificantBits(System.Numerics.Vector4)" />
+        <inheritdoc cref="M:System.Runtime.Intrinsics.Vector128.ExtractMostSignificantBits``1(System.Runtime.Intrinsics.Vector128{``0})" />
       </Docs>
     </Member>
     <Member MemberName="ExtractMostSignificantBits">
@@ -4243,7 +4243,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <summary>To be added.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
-        <inheritdoc cref="M:System.Numerics.Vector.GetElement(System.Numerics.Vector4,System.Int32)" />
+        <inheritdoc cref="M:System.Runtime.Intrinsics.Vector128.GetElement``1(System.Runtime.Intrinsics.Vector128{``0},System.Int32)" />
       </Docs>
     </Member>
     <Member MemberName="GetElement">
@@ -4274,7 +4274,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <summary>To be added.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
-        <inheritdoc cref="M:System.Numerics.Vector.GetElement(System.Numerics.Vector4,System.Int32)" />
+        <inheritdoc cref="M:System.Runtime.Intrinsics.Vector128.GetElement``1(System.Runtime.Intrinsics.Vector128{``0},System.Int32)" />
       </Docs>
     </Member>
     <Member MemberName="GetElement">
@@ -11279,7 +11279,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <summary>To be added.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
-        <inheritdoc cref="M:System.Numerics.Vector.ToScalar(System.Numerics.Vector4)" />
+        <inheritdoc cref="M:System.Runtime.Intrinsics.Vector128.ToScalar``1(System.Runtime.Intrinsics.Vector128{``0})" />
       </Docs>
     </Member>
     <Member MemberName="ToScalar">
@@ -11308,7 +11308,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <summary>To be added.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
-        <inheritdoc cref="M:System.Numerics.Vector.ToScalar(System.Numerics.Vector4)" />
+        <inheritdoc cref="M:System.Runtime.Intrinsics.Vector128.ToScalar``1(System.Runtime.Intrinsics.Vector128{``0})" />
       </Docs>
     </Member>
     <Member MemberName="ToScalar">
@@ -12314,7 +12314,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <summary>To be added.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
-        <inheritdoc cref="M:System.Numerics.Vector.WithElement(System.Numerics.Vector4,System.Int32,System.Single)" />
+        <inheritdoc cref="M:System.Runtime.Intrinsics.Vector128.WithElement``1(System.Runtime.Intrinsics.Vector128{``0},System.Int32,``0)" />
       </Docs>
     </Member>
     <Member MemberName="WithElement">
@@ -12347,7 +12347,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <summary>To be added.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
-        <inheritdoc cref="M:System.Numerics.Vector.WithElement(System.Numerics.Vector4,System.Int32,System.Single)" />
+        <inheritdoc cref="M:System.Runtime.Intrinsics.Vector128.WithElement``1(System.Runtime.Intrinsics.Vector128{``0},System.Int32,``0)" />
       </Docs>
     </Member>
     <Member MemberName="WithElement">

xml/System.Numerics/Vector2.xml

@@ -2016,7 +2016,7 @@
         <summary>To be added.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
-        <inheritdoc cref="M:System.Runtime.Intrinsics.Vector128.MultiplyAddEstimate(System.Runtime.Intrinsics.Vector128{System.Single},System.Runtime.Intrinsics.Vector128{System.Single},System.Runtime.Intrinsics.Vector128{System.Single})" />
+        <inheritdoc cref="M:System.Runtime.Intrinsics.Vector128.FusedMultiplyAdd(System.Runtime.Intrinsics.Vector128{System.Single},System.Runtime.Intrinsics.Vector128{System.Single},System.Runtime.Intrinsics.Vector128{System.Single})" />
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -3100,7 +3100,6 @@ The behavior of this method changed in .NET 5. For more information, see [Behavi
  
           ]]></format>
         </remarks>
-        <inheritdoc cref="M:System.Numerics.Vector4.Lerp(System.Numerics.Vector4,System.Numerics.Vector4,System.Numerics.Vector4)" />
       </Docs>
     </Member>
     <Member MemberName="LessThan">

xml/System.Numerics/Vector3.xml

@@ -2257,9 +2257,9 @@ The type `T` can be any of the following numeric types:
       <Docs>
         <param name="left">The first vector to compare.</param>
         <param name="right">The second vector to compare.</param>
-        <summary>Returns a value that indicates whether any single pair of elements in the specified vectors is equal.</summary>
+        <summary>Returns a value that indicates whether any single pair of elements in the specified vectors is not equal.</summary>
         <returns>
-          <see langword="true" /> if any element pairs in left and right are equal. <see langword="false" /> if no element pairs are equal.</returns>
+          <see langword="true" /> if any element pairs in left and right are not equal. <see langword="false" /> if all element pairs are equal.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.NotSupportedException">.NET 5 and later: Type <see langword="T" /> is not supported.</exception>
       </Docs>

xml/System.Numerics/Vector4.xml

@@ -55,7 +55,12 @@
       <format type="text/markdown"><![CDATA[
 
 ## Remarks
- The <xref:System.Reflection.IReflect> interface is used to interoperate with the [IDispatch interface](/windows/win32/api/oaidl/nn-oaidl-idispatch). <xref:System.Reflection.IReflect> defines a subset of the <xref:System.Type> reflection methods. Implementing this interface enables a type to customize its behavior when the object is being accessed from COM as an `IDispatch` object. The <xref:System.Runtime.InteropServices.CustomMarshalers.ExpandoToDispatchExMarshaler> class can be used to marshal an object that implements <xref:System.Reflection.IReflect> or <xref:System.Runtime.InteropServices.Expando.IExpando> as a COM `IDispatch` object, and vice versa.
+
+In .NET 10 and later versions, no COM object casts successfully to this interface. If you need access, it's recommended to project and define a managed definition of `IDispatch` or `IDispatchEx`.
+
+In .NET 5 through .NET 9, COM objects that implement `IDispatchEx` can be cast to this interface, but all methods throw `TypeLoadException`.
+
+On .NET Framework, the <xref:System.Reflection.IReflect> interface is used to interoperate with the [IDispatch interface](/windows/win32/api/oaidl/nn-oaidl-idispatch). <xref:System.Reflection.IReflect> defines a subset of the <xref:System.Type> reflection methods. Implementing this interface enables a type to customize its behavior when the object is being accessed from COM as an `IDispatch` object. The <xref:System.Runtime.InteropServices.CustomMarshalers.ExpandoToDispatchExMarshaler> class can be used to marshal an object that implements <xref:System.Reflection.IReflect> or <xref:System.Runtime.InteropServices.Expando.IExpando> as a COM `IDispatch` object, and vice versa.
 
  ]]></format>
     </remarks>