From 2d62b560699fcb56bb08c75c21cc225a3b1e5746 Mon Sep 17 00:00:00 2001
From: Rageking8 <106309953+Rageking8@users.noreply.github.com>
Date: Tue, 4 Mar 2025 00:09:07 +0800
Subject: [PATCH 1/4] Fix example output of `BigInteger(Int64)` (#11035)

* Fix example output of `BigInteger(Int64)`

* Add missing project files

* Resolve `Example` identifier conflict

* Apply suggestions from code review

---------

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>
---
 .../csharp/System.Numerics/BigInteger/.ctor/Example1.cs    | 2 +-
 .../csharp/System.Numerics/BigInteger/.ctor/Example2.cs    | 6 +++---
 .../csharp/System.Numerics/BigInteger/.ctor/Project.csproj | 6 ++++++
 .../fsharp/System.Numerics/BigInteger/.ctor/Example2.fs    | 4 ++--
 .../system.Numerics.BigInteger.ctors/vb/Example1.vb        | 2 +-
 .../system.Numerics.BigInteger.ctors/vb/Example2.vb        | 6 +++---
 .../system.Numerics.BigInteger.ctors/vb/Project.vbproj     | 7 +++++++
 7 files changed, 23 insertions(+), 10 deletions(-)
 create mode 100644 snippets/csharp/System.Numerics/BigInteger/.ctor/Project.csproj
 create mode 100644 snippets/visualbasic/VS_Snippets_CLR_System/system.Numerics.BigInteger.ctors/vb/Project.vbproj

diff --git a/snippets/csharp/System.Numerics/BigInteger/.ctor/Example1.cs b/snippets/csharp/System.Numerics/BigInteger/.ctor/Example1.cs
index abe5043c114..3ca8a377178 100644
--- a/snippets/csharp/System.Numerics/BigInteger/.ctor/Example1.cs
+++ b/snippets/csharp/System.Numerics/BigInteger/.ctor/Example1.cs
@@ -1,7 +1,7 @@
 using System;
 using System.Numerics;
 
-public class Example
+public class Example1
 {
    public static void Main()
    {
diff --git a/snippets/csharp/System.Numerics/BigInteger/.ctor/Example2.cs b/snippets/csharp/System.Numerics/BigInteger/.ctor/Example2.cs
index c9f66fd5150..bc797c9045a 100644
--- a/snippets/csharp/System.Numerics/BigInteger/.ctor/Example2.cs
+++ b/snippets/csharp/System.Numerics/BigInteger/.ctor/Example2.cs
@@ -1,7 +1,7 @@
 using System;
 using System.Numerics;
 
-public class Example
+public class Example2
 {
    public static void Main()
    {
@@ -98,13 +98,13 @@ private static void LongConstructor()
                            constructed.Equals(assigned));
       }
       // The example displays the following output:
-      //       -2147483648 = -2147483648: True
+      //       -9223372036854775808 = -9223372036854775808: True
       //       -10534 = -10534: True
       //       -189 = -189: True
       //       0 = 0: True
       //       17 = 17: True
       //       113439 = 113439: True
-      //       2147483647 = 2147483647: True
+      //       9223372036854775807 = 9223372036854775807: True
       // </Snippet7>
    }
 
diff --git a/snippets/csharp/System.Numerics/BigInteger/.ctor/Project.csproj b/snippets/csharp/System.Numerics/BigInteger/.ctor/Project.csproj
new file mode 100644
index 00000000000..9bb79615f63
--- /dev/null
+++ b/snippets/csharp/System.Numerics/BigInteger/.ctor/Project.csproj
@@ -0,0 +1,6 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <OutputType>Library</OutputType>
+    <TargetFramework>net9.0</TargetFramework>
+  </PropertyGroup>
+</Project>
\ No newline at end of file
diff --git a/snippets/fsharp/System.Numerics/BigInteger/.ctor/Example2.fs b/snippets/fsharp/System.Numerics/BigInteger/.ctor/Example2.fs
index b1b1795d0ba..dc29be16b7d 100644
--- a/snippets/fsharp/System.Numerics/BigInteger/.ctor/Example2.fs
+++ b/snippets/fsharp/System.Numerics/BigInteger/.ctor/Example2.fs
@@ -63,13 +63,13 @@ let longConstructor () =
         let assigned = number
         printfn $"{constructed} = {assigned}: {constructed.Equals assigned}"
     // The example displays the following output:
-    //       -2147483648 = -2147483648: True
+    //       -9223372036854775808 = -9223372036854775808: True
     //       -10534 = -10534: True
     //       -189 = -189: True
     //       0 = 0: True
     //       17 = 17: True
     //       113439 = 113439: True
-    //       2147483647 = 2147483647: True
+    //       9223372036854775807 = 9223372036854775807: True
     // </Snippet7>
 
 let singleConstructor () =
diff --git a/snippets/visualbasic/VS_Snippets_CLR_System/system.Numerics.BigInteger.ctors/vb/Example1.vb b/snippets/visualbasic/VS_Snippets_CLR_System/system.Numerics.BigInteger.ctors/vb/Example1.vb
index a2795960b0d..6b5a2951d09 100644
--- a/snippets/visualbasic/VS_Snippets_CLR_System/system.Numerics.BigInteger.ctors/vb/Example1.vb
+++ b/snippets/visualbasic/VS_Snippets_CLR_System/system.Numerics.BigInteger.ctors/vb/Example1.vb
@@ -3,7 +3,7 @@ Option Strict On
 
 Imports System.Numerics
 
-Module Example
+Module Example1
    Public Sub Main()
       Console.WindowWidth = 90
       CreateSimpleArray()
diff --git a/snippets/visualbasic/VS_Snippets_CLR_System/system.Numerics.BigInteger.ctors/vb/Example2.vb b/snippets/visualbasic/VS_Snippets_CLR_System/system.Numerics.BigInteger.ctors/vb/Example2.vb
index 105da819fa0..3c25a3eb326 100644
--- a/snippets/visualbasic/VS_Snippets_CLR_System/system.Numerics.BigInteger.ctors/vb/Example2.vb
+++ b/snippets/visualbasic/VS_Snippets_CLR_System/system.Numerics.BigInteger.ctors/vb/Example2.vb
@@ -3,7 +3,7 @@ Option Strict On
 
 Imports System.Numerics
 
-Module Example
+Module Example2
    Public Sub Main()
       DecimalConstructor()
       Console.WriteLine("-----")
@@ -92,13 +92,13 @@ Module Example
                            constructed.Equals(assigned)) 
       Next
       ' The example displays the following output:
-      '       -2147483648 = -2147483648: True
+      '       -9223372036854775808 = -9223372036854775808: True
       '       -10534 = -10534: True
       '       -189 = -189: True
       '       0 = 0: True
       '       17 = 17: True
       '       113439 = 113439: True
-      '       2147483647 = 2147483647: True
+      '       9223372036854775807 = 9223372036854775807: True
       ' </Snippet7>
    End Sub   
 
diff --git a/snippets/visualbasic/VS_Snippets_CLR_System/system.Numerics.BigInteger.ctors/vb/Project.vbproj b/snippets/visualbasic/VS_Snippets_CLR_System/system.Numerics.BigInteger.ctors/vb/Project.vbproj
new file mode 100644
index 00000000000..9a84e38014e
--- /dev/null
+++ b/snippets/visualbasic/VS_Snippets_CLR_System/system.Numerics.BigInteger.ctors/vb/Project.vbproj
@@ -0,0 +1,7 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <OutputType>Library</OutputType>
+    <TargetFramework>net9.0</TargetFramework>
+
+  </PropertyGroup>
+</Project>
\ No newline at end of file

From b3fa31e5871b42538d92e011d8a9c6008c6a896d Mon Sep 17 00:00:00 2001
From: Kevin Jones <kevin@vcsjones.com>
Date: Mon, 3 Mar 2025 13:57:45 -0500
Subject: [PATCH 2/4] Add note about disposing certificates in chain elements
 to X509Chain (#11042)

---
 xml/System.Security.Cryptography.X509Certificates/X509Chain.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/xml/System.Security.Cryptography.X509Certificates/X509Chain.xml b/xml/System.Security.Cryptography.X509Certificates/X509Chain.xml
index 86935563554..157cc396c66 100644
--- a/xml/System.Security.Cryptography.X509Certificates/X509Chain.xml
+++ b/xml/System.Security.Cryptography.X509Certificates/X509Chain.xml
@@ -78,7 +78,7 @@
 >   
 >  For apps that target the .NET Framework 4.5.2 and earlier versions, the <xref:System.Security.Cryptography.X509Certificates.X509Chain> class does not implement the <xref:System.IDisposable> interface and therefore does not have a `Dispose` method.  
   
-   
+ When disposing <xref:System.Security.Cryptography.X509Certificates.X509Chain>, the certificates in <xref:System.Security.Cryptography.X509Certificates.X509Chain.ChainElements> are not disposed. You should dispose of the certificates in this collection when the certificate instances are no longer needed.
   
 ## Examples  
  The following code example opens the current user's personal certificate store, allows you to select a certificate, then writes certificate and certificate chain information to the console. The output depends on the certificate you select.  

From 0a42a00caad93670743f46b8658809e928ce7758 Mon Sep 17 00:00:00 2001
From: Rageking8 <106309953+Rageking8@users.noreply.github.com>
Date: Tue, 4 Mar 2025 06:06:12 +0800
Subject: [PATCH 3/4] Elide vector link in returns description for
 `Vector512.Create` (#11033)

---
 xml/System.Runtime.Intrinsics/Vector512.xml | 84 ++++++++++-----------
 1 file changed, 42 insertions(+), 42 deletions(-)

diff --git a/xml/System.Runtime.Intrinsics/Vector512.xml b/xml/System.Runtime.Intrinsics/Vector512.xml
index 5194ff9494e..723ad31d581 100644
--- a/xml/System.Runtime.Intrinsics/Vector512.xml
+++ b/xml/System.Runtime.Intrinsics/Vector512.xml
@@ -2139,7 +2139,7 @@
       <Docs>
         <param name="value">The value that all elements will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with all elements initialized to the specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with all elements initialized to <paramref name="value" />.</returns>
+        <returns>A new vector with all elements initialized to <paramref name="value" />.</returns>
         <remarks>On x86, this method corresponds to __m512i _mm512_set1_epi8</remarks>
       </Docs>
     </Member>
@@ -2166,7 +2166,7 @@
       <Docs>
         <param name="value">The value that all elements will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with all elements initialized to the specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with all elements initialized to <paramref name="value" />.</returns>
+        <returns>A new vector with all elements initialized to <paramref name="value" />.</returns>
         <remarks>On x86, this method corresponds to __m512d _mm512_set1_pd</remarks>
       </Docs>
     </Member>
@@ -2193,7 +2193,7 @@
       <Docs>
         <param name="value">The value that all elements will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with all elements initialized to the specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with all elements initialized to <paramref name="value" />.</returns>
+        <returns>A new vector with all elements initialized to <paramref name="value" />.</returns>
         <remarks>On x86, this method corresponds to __m512i _mm512_set1_epi16</remarks>
       </Docs>
     </Member>
@@ -2220,7 +2220,7 @@
       <Docs>
         <param name="value">The value that all elements will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with all elements initialized to the specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with all elements initialized to <paramref name="value" />.</returns>
+        <returns>A new vector with all elements initialized to <paramref name="value" />.</returns>
         <remarks>On x86, this method corresponds to __m512i _mm512_set1_epi32</remarks>
       </Docs>
     </Member>
@@ -2247,7 +2247,7 @@
       <Docs>
         <param name="value">The value that all elements will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with all elements initialized to the specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with all elements initialized to <paramref name="value" />.</returns>
+        <returns>A new vector with all elements initialized to <paramref name="value" />.</returns>
         <remarks>On x86, this method corresponds to __m512i _mm512_set1_epi64x</remarks>
       </Docs>
     </Member>
@@ -2274,7 +2274,7 @@
       <Docs>
         <param name="value">The value that all elements will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with all elements initialized to the specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with all elements initialized to <paramref name="value" />.</returns>
+        <returns>A new vector with all elements initialized to <paramref name="value" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -2307,7 +2307,7 @@
       <Docs>
         <param name="value">The value that all elements will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with all elements initialized to the specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with all elements initialized to <paramref name="value" />.</returns>
+        <returns>A new vector with all elements initialized to <paramref name="value" />.</returns>
         <remarks>On x86, this method corresponds to __m512i _mm512_set1_epi8</remarks>
       </Docs>
     </Member>
@@ -2334,7 +2334,7 @@
       <Docs>
         <param name="value">The value that all elements will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with all elements initialized to the specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with all elements initialized to <paramref name="value" />.</returns>
+        <returns>A new vector with all elements initialized to <paramref name="value" />.</returns>
         <remarks>On x86, this method corresponds to __m512 _mm512_set1_ps</remarks>
       </Docs>
     </Member>
@@ -2367,7 +2367,7 @@
       <Docs>
         <param name="value">The value that all elements will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with all elements initialized to the specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with all elements initialized to <paramref name="value" />.</returns>
+        <returns>A new vector with all elements initialized to <paramref name="value" />.</returns>
         <remarks>On x86, this method corresponds to __m512i _mm512_set1_epi16</remarks>
       </Docs>
     </Member>
@@ -2400,7 +2400,7 @@
       <Docs>
         <param name="value">The value that all elements will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with all elements initialized to the specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with all elements initialized to <paramref name="value" />.</returns>
+        <returns>A new vector with all elements initialized to <paramref name="value" />.</returns>
         <remarks>On x86, this method corresponds to __m512i _mm512_set1_epi32</remarks>
       </Docs>
     </Member>
@@ -2433,7 +2433,7 @@
       <Docs>
         <param name="value">The value that all elements will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with all elements initialized to the specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with all elements initialized to <paramref name="value" />.</returns>
+        <returns>A new vector with all elements initialized to <paramref name="value" />.</returns>
         <remarks>On x86, this method corresponds to __m512i _mm512_set1_epi64x</remarks>
       </Docs>
     </Member>
@@ -2466,7 +2466,7 @@
       <Docs>
         <param name="value">The value that all elements will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with all elements initialized to the specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with all elements initialized to <paramref name="value" />.</returns>
+        <returns>A new vector with all elements initialized to <paramref name="value" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -2495,7 +2495,7 @@
         <param name="lower">The value that the lower 256-bits will be initialized to.</param>
         <param name="upper">The value that the upper 256-bits will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance from two <see cref="T:System.Runtime.Intrinsics.Vector256`1" /> instances.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
+        <returns>A new vector initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -2524,7 +2524,7 @@
         <param name="lower">The value that the lower 256-bits will be initialized to.</param>
         <param name="upper">The value that the upper 256-bits will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance from two <see cref="T:System.Runtime.Intrinsics.Vector256`1" /> instances.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
+        <returns>A new vector initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
         <remarks>On x86, this method corresponds to __m512d _mm512_setr_m256d (__m256d lo, __m256d hi)</remarks>
       </Docs>
     </Member>
@@ -2553,7 +2553,7 @@
         <param name="lower">The value that the lower 256-bits will be initialized to.</param>
         <param name="upper">The value that the upper 256-bits will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance from two <see cref="T:System.Runtime.Intrinsics.Vector256`1" /> instances.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
+        <returns>A new vector initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -2582,7 +2582,7 @@
         <param name="lower">The value that the lower 256-bits will be initialized to.</param>
         <param name="upper">The value that the upper 256-bits will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance from two <see cref="T:System.Runtime.Intrinsics.Vector256`1" /> instances.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
+        <returns>A new vector initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
         <remarks>On x86, this method corresponds to __m512i _mm512_setr_m256i (__m256i lo, __m256i hi)</remarks>
       </Docs>
     </Member>
@@ -2611,7 +2611,7 @@
         <param name="lower">The value that the lower 256-bits will be initialized to.</param>
         <param name="upper">The value that the upper 256-bits will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance from two <see cref="T:System.Runtime.Intrinsics.Vector256`1" /> instances.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
+        <returns>A new vector initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -2640,7 +2640,7 @@
         <param name="lower">The value that the lower 256-bits will be initialized to.</param>
         <param name="upper">The value that the upper 256-bits will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance from two <see cref="T:System.Runtime.Intrinsics.Vector256`1" /> instances.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
+        <returns>A new vector initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -2675,7 +2675,7 @@
         <param name="lower">The value that the lower 256-bits will be initialized to.</param>
         <param name="upper">The value that the upper 256-bits will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance from two <see cref="T:System.Runtime.Intrinsics.Vector256`1" /> instances.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
+        <returns>A new vector initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -2704,7 +2704,7 @@
         <param name="lower">The value that the lower 256-bits will be initialized to.</param>
         <param name="upper">The value that the upper 256-bits will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance from two <see cref="T:System.Runtime.Intrinsics.Vector256`1" /> instances.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
+        <returns>A new vector initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
         <remarks>On x86, this method corresponds to __m512 _mm512_setr_m256 (__m256 lo, __m256 hi)</remarks>
       </Docs>
     </Member>
@@ -2739,7 +2739,7 @@
         <param name="lower">The value that the lower 256-bits will be initialized to.</param>
         <param name="upper">The value that the upper 256-bits will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance from two <see cref="T:System.Runtime.Intrinsics.Vector256`1" /> instances.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
+        <returns>A new vector initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -2774,7 +2774,7 @@
         <param name="lower">The value that the lower 256-bits will be initialized to.</param>
         <param name="upper">The value that the upper 256-bits will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance from two <see cref="T:System.Runtime.Intrinsics.Vector256`1" /> instances.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
+        <returns>A new vector initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
         <remarks>On x86, this method corresponds to __m512i _mm512_setr_m256i (__m256i lo, __m256i hi)</remarks>
       </Docs>
     </Member>
@@ -2809,7 +2809,7 @@
         <param name="lower">The value that the lower 256-bits will be initialized to.</param>
         <param name="upper">The value that the upper 256-bits will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance from two <see cref="T:System.Runtime.Intrinsics.Vector256`1" /> instances.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
+        <returns>A new vector initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -2844,7 +2844,7 @@
         <param name="lower">The value that the lower 256-bits will be initialized to.</param>
         <param name="upper">The value that the upper 256-bits will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance from two <see cref="T:System.Runtime.Intrinsics.Vector256`1" /> instances.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
+        <returns>A new vector initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -2885,7 +2885,7 @@
         <param name="e6">The value that element 6 will be initialized to.</param>
         <param name="e7">The value that element 7 will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with each element initialized to the corresponding specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with each element initialized to corresponding specified value.</returns>
+        <returns>A new vector with each element initialized to corresponding specified value.</returns>
         <remarks>On x86, this method corresponds to __m512d _mm512_setr_pd</remarks>
       </Docs>
     </Member>
@@ -2926,7 +2926,7 @@
         <param name="e6">The value that element 6 will be initialized to.</param>
         <param name="e7">The value that element 7 will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with each element initialized to the corresponding specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with each element initialized to corresponding specified value.</returns>
+        <returns>A new vector with each element initialized to corresponding specified value.</returns>
         <remarks>On x86, this method corresponds to __m512i _mm512_setr_epi64x</remarks>
       </Docs>
     </Member>
@@ -2973,7 +2973,7 @@
         <param name="e6">The value that element 6 will be initialized to.</param>
         <param name="e7">The value that element 7 will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with each element initialized to the corresponding specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with each element initialized to corresponding specified value.</returns>
+        <returns>A new vector with each element initialized to corresponding specified value.</returns>
         <remarks>On x86, this method corresponds to __m512i _mm512_setr_epi64x</remarks>
       </Docs>
     </Member>
@@ -3030,7 +3030,7 @@
         <param name="e14">The value that element 14 will be initialized to.</param>
         <param name="e15">The value that element 15 will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with each element initialized to the corresponding specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with each element initialized to corresponding specified value.</returns>
+        <returns>A new vector with each element initialized to corresponding specified value.</returns>
         <remarks>On x86, this method corresponds to __m512i _mm512_setr_epi32</remarks>
       </Docs>
     </Member>
@@ -3087,7 +3087,7 @@
         <param name="e14">The value that element 14 will be initialized to.</param>
         <param name="e15">The value that element 15 will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with each element initialized to the corresponding specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with each element initialized to corresponding specified value.</returns>
+        <returns>A new vector with each element initialized to corresponding specified value.</returns>
         <remarks>On x86, this method corresponds to __m512 _mm512_setr_ps</remarks>
       </Docs>
     </Member>
@@ -3150,7 +3150,7 @@
         <param name="e14">The value that element 14 will be initialized to.</param>
         <param name="e15">The value that element 15 will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with each element initialized to the corresponding specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with each element initialized to corresponding specified value.</returns>
+        <returns>A new vector with each element initialized to corresponding specified value.</returns>
         <remarks>On x86, this method corresponds to __m512i _mm512_setr_epi32</remarks>
       </Docs>
     </Member>
@@ -3239,7 +3239,7 @@
         <param name="e30">The value that element 30 will be initialized to.</param>
         <param name="e31">The value that element 31 will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with each element initialized to the corresponding specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with each element initialized to corresponding specified value.</returns>
+        <returns>A new vector with each element initialized to corresponding specified value.</returns>
         <remarks>On x86, this method corresponds to __m512i _mm512_setr_epi16</remarks>
       </Docs>
     </Member>
@@ -3334,7 +3334,7 @@
         <param name="e30">The value that element 30 will be initialized to.</param>
         <param name="e31">The value that element 31 will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with each element initialized to the corresponding specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with each element initialized to corresponding specified value.</returns>
+        <returns>A new vector with each element initialized to corresponding specified value.</returns>
         <remarks>On x86, this method corresponds to __m512i _mm512_setr_epi16</remarks>
       </Docs>
     </Member>
@@ -3487,7 +3487,7 @@
         <param name="e62">The value that element 62 will be initialized to.</param>
         <param name="e63">The value that element 63 will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with each element initialized to the corresponding specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with each element initialized to corresponding specified value.</returns>
+        <returns>A new vector with each element initialized to corresponding specified value.</returns>
         <remarks>On x86, this method corresponds to __m512i _mm512_setr_epi8</remarks>
       </Docs>
     </Member>
@@ -3646,7 +3646,7 @@
         <param name="e62">The value that element 62 will be initialized to.</param>
         <param name="e63">The value that element 63 will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with each element initialized to the corresponding specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with each element initialized to corresponding specified value.</returns>
+        <returns>A new vector with each element initialized to corresponding specified value.</returns>
         <remarks>On x86, this method corresponds to __m512i _mm512_setr_epi8</remarks>
       </Docs>
     </Member>
@@ -3690,7 +3690,7 @@
         <typeparam name="T">The type of the elements in the vector.</typeparam>
         <param name="values">The readonly span from which the vector is created.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> from a given readonly span.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with its elements set to the first <see cref="P:System.Runtime.Intrinsics.Vector512`1.Count" /> elements from <paramref name="values" />.</returns>
+        <returns>A new vector with its elements set to the first <see cref="P:System.Runtime.Intrinsics.Vector512`1.Count" /> elements from <paramref name="values" />.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="values" /> is less than <see cref="P:System.Runtime.Intrinsics.Vector512`1.Count" />.</exception>
         <exception cref="T:System.NotSupportedException">The type of <paramref name="values" /> (<typeparamref name="T" />) is not supported.</exception>
@@ -3735,7 +3735,7 @@
         <typeparam name="T">The type of the elements in the vector.</typeparam>
         <param name="value">The value that the 128-bit parts will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with all 128-bit parts initialized to a specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector128`1" /> with the 128-bit parts initialized to <paramref name="value" />.</returns>
+        <returns>A new vector with the 128-bit parts initialized to <paramref name="value" />.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.NotSupportedException">The type of <paramref name="value" /> (<typeparamref name="T" />) is not supported.</exception>
       </Docs>
@@ -3779,7 +3779,7 @@
         <typeparam name="T">The type of the elements in the vector.</typeparam>
         <param name="value">The value that the lower and upper 256-bits will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with the lower and upper 256-bits initialized to a specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector128`1" /> with the lower and upper 256-bits initialized to <paramref name="value" />.</returns>
+        <returns>A new vector with the lower and upper 256-bits initialized to <paramref name="value" />.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.NotSupportedException">The type of <paramref name="value" /> (<typeparamref name="T" />) is not supported.</exception>
       </Docs>
@@ -3823,7 +3823,7 @@
         <typeparam name="T">The type of the elements in the vector.</typeparam>
         <param name="value">The value that the 64-bit parts will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with all 64-bit parts initialized to a specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector128`1" /> with the 64-bit parts initialized to <paramref name="value" />.</returns>
+        <returns>A new vector with the 64-bit parts initialized to <paramref name="value" />.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.NotSupportedException">The type of <paramref name="value" /> (<typeparamref name="T" />) is not supported.</exception>
       </Docs>
@@ -3868,7 +3868,7 @@
         <typeparam name="T">The type of the elements in the vector.</typeparam>
         <param name="value">The value that all elements will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance with all elements initialized to the specified value.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with all elements initialized to <paramref name="value" />.</returns>
+        <returns>A new vector with all elements initialized to <paramref name="value" />.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.NotSupportedException">The type of <paramref name="value" /> (<typeparamref name="T" />) is not supported.</exception>
       </Docs>
@@ -3913,7 +3913,7 @@
         <typeparam name="T">The type of the elements in the vector.</typeparam>
         <param name="values">The array from which the vector is created.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> from a given array.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with its elements set to the first <see cref="P:System.Runtime.Intrinsics.Vector512`1.Count" /> elements from <paramref name="values" />.</returns>
+        <returns>A new vector with its elements set to the first <see cref="P:System.Runtime.Intrinsics.Vector512`1.Count" /> elements from <paramref name="values" />.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="values" /> is less than <see cref="P:System.Runtime.Intrinsics.Vector512`1.Count" />.</exception>
         <exception cref="T:System.NotSupportedException">The type of <paramref name="values" /> (<typeparamref name="T" />) is not supported.</exception>
@@ -3970,7 +3970,7 @@
         <param name="lower">The value that the lower 256-bits will be initialized to.</param>
         <param name="upper">The value that the upper 256-bits will be initialized to.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> instance from two <see cref="T:System.Runtime.Intrinsics.Vector256`1" /> instances.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
+        <returns>A new vector initialized from <paramref name="lower" /> and <paramref name="upper" />.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.NotSupportedException">The type of <paramref name="lower" /> and <paramref name="upper" /> (<typeparamref name="T" />) is not supported.</exception>
       </Docs>
@@ -4017,7 +4017,7 @@
         <param name="values">The array from which the vector is created.</param>
         <param name="index">The index in <paramref name="values" /> at which to being reading elements.</param>
         <summary>Creates a new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> from a given array.</summary>
-        <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector512`1" /> with its elements set to the first <see cref="P:System.Runtime.Intrinsics.Vector256`1.Count" /> elements from <paramref name="values" />.</returns>
+        <returns>A new vector with its elements set to the first <see cref="P:System.Runtime.Intrinsics.Vector256`1.Count" /> elements from <paramref name="values" />.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="values" />, starting from <paramref name="index" />, is less than <see cref="P:System.Runtime.Intrinsics.Vector512`1.Count" />.</exception>
         <exception cref="T:System.NotSupportedException">The type of <paramref name="values" /> (<typeparamref name="T" />) is not supported.</exception>

From f9285cf94494298ed3b1924d0920ba1dab541779 Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Mon, 3 Mar 2025 14:52:18 -0800
Subject: [PATCH 4/4] Update AppDomain.xml (#11028)

---
 xml/System/AppDomain.xml | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/xml/System/AppDomain.xml b/xml/System/AppDomain.xml
index 8c175403356..52316b288f3 100644
--- a/xml/System/AppDomain.xml
+++ b/xml/System/AppDomain.xml
@@ -94,7 +94,6 @@
 Application domains, which are represented by <xref:System.AppDomain> objects, help provide isolation, unloading, and security boundaries for executing managed code.
 
 - Use application domains to isolate tasks that might bring down a process. If the state of the <xref:System.AppDomain> that's executing a task becomes unstable, the <xref:System.AppDomain> can be unloaded without affecting the process. This is important when a process must run for long periods without restarting. You can also use application domains to isolate tasks that should not share data.
-
 - If an assembly is loaded into the default application domain, it cannot be unloaded from memory while the process is running. However, if you open a second application domain to load and execute the assembly, the assembly is unloaded when that application domain is unloaded. Use this technique to minimize the working set of long-running processes that occasionally use large DLLs.
 
  > [!NOTE]
@@ -5886,9 +5885,8 @@ This method overload uses the <xref:System.AppDomainSetup> information from the
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
- The friendly name of the default application domain is the file name of the process executable. For example, if the executable used to start the process is `"c:\MyAppDirectory\MyAssembly.exe"`, the friendly name of the default application domain is `"MyAssembly.exe"`.
-
 
+The friendly name of the default application domain is the file name of the process executable. For example, if the executable used to start the process is `"c:\MyAppDirectory\MyAssembly.exe"`, the friendly name of the default application domain is `"MyAssembly.exe"`. (In .NET Core and .NET 5+, the friendly name doesn't include the file extension.)
 
 ## Examples
  The following code example uses the <xref:System.AppDomain.FriendlyName%2A> property to get the friendly name of the current application domain. For the default application domain, the friendly name is the name of the application's executable file. The code example also displays additional information about the application domain.