Merge pull request #8464 from dakersnar/fix-72402

Fix api documentation for System.Runtime.Intrinsics

Author: dakersnar

xml/System.Numerics/Vector.xml

@@ -35,7 +35,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>Provides a collection of static convenience methods for creating, manipulating, combining, and converting generic vectors.</summary>
+    <summary>Provides a collection of static methods for creating, manipulating, and otherwise operating on generic vectors.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>

xml/System.Numerics/Vector`1.xml

@@ -57,7 +57,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <typeparam name="T">The vector type. <c>T</c> can be any primitive numeric type.</typeparam>
+    <typeparam name="T">The type of the elements in the vector. <typeparamref name="T" /> can be any primitive numeric type.</typeparam>
     <summary>Represents a single vector of a specified numeric type that is suitable for low-level optimization of parallel algorithms.</summary>
     <remarks>
       <format type="text/markdown"><![CDATA[  
@@ -67,21 +67,8 @@
   
  The <xref:System.Numerics.Vector%601> structure provides support for hardware acceleration.
  
- The term *primitive numeric data type* in this article refers to numeric data types that are directly supported by the CPU and have instructions that can manipulate those data types. The following table shows which primitive numeric data type and operation combination uses intrinsic instructions for faster execution:
+ The term *primitive numeric data type* in this article refers to numeric data types that are directly supported by the CPU and have instructions that can manipulate those data types.
  
-| Primitive type | `+` | `-` | `*` | `/` |
-| --- | :---: | :---: | :---: | :---: |
-|`sbyte` | Yes | Yes | No | No |
-|`byte` | Yes | Yes | No | No |
-|`short` | Yes | Yes | Yes | No |
-|`ushort` | Yes | Yes | No | No |
-| `int` | Yes | Yes | Yes | No |
-| `uint` | Yes | Yes | No | No |
-| `long` | Yes | Yes | No | No |
-| `ulong` | Yes | Yes | No | No |
-| `float` | Yes | Yes | Yes | Yes |
-| `double` | Yes | Yes | Yes | Yes |
-
  ]]></format>
     </remarks>
   </Docs>

xml/System.Runtime.Intrinsics/Vector128.xml

@@ -18,7 +18,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides a collection of static methods for creating, manipulating, and otherwise operating on 128-bit vectors.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -2838,7 +2838,7 @@ On x86, this method corresponds to __m128i _mm_setr_epi8
         <Parameter Name="value" Type="T" Index="0" FrameworkAlternate="net-7.0" />
       </Parameters>
       <Docs>
-        <typeparam name="T">To be added.</typeparam>
+        <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.Vector128`1" /> instance with all elements initialized to the specified value.</summary>
         <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector128`1" /> with all elements initialized to <paramref name="value" />.</returns>
@@ -6723,7 +6723,7 @@ This method may bypass the cache on certain platforms.
         <Parameter Name="destination" Type="System.Span&lt;T&gt;" Index="1" FrameworkAlternate="net-7.0" />
       </Parameters>
       <Docs>
-        <typeparam name="T">To be added.</typeparam>
+        <typeparam name="T">The type of the input vector.</typeparam>
         <param name="vector">The vector to copy.</param>
         <param name="destination">The span to which <paramref name="destination" /> is copied.</param>
         <summary>Tries to copy a <see cref="T:System.Numerics.Vector`1" /> to a given span.</summary>

xml/System.Runtime.Intrinsics/Vector128`1.xml

@@ -37,8 +37,8 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <typeparam name="T">To be added.</typeparam>
-    <summary>To be added.</summary>
+    <typeparam name="T">The type of the elements in the vector.</typeparam>
+    <summary>Represents a 128-bit vector of a specified numeric type that is suitable for low-level optimization of parallel algorithms.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -232,10 +232,13 @@
         <Parameter Name="index" Type="System.Int32" Index="0" FrameworkAlternate="net-7.0" />
       </Parameters>
       <Docs>
-        <param name="index">To be added.</param>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <param name="index">The index of the element to get.</param>
+        <summary>Gets the element at the specified index.</summary>
+        <value>The value of the element at <paramref name="index" />.</value>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="index" /> was less than zero or greater than the number of elements.</exception>
+        <exception cref="T:System.NotSupportedException">The type of the vector (<typeparamref name="T" />) is not supported.</exception>
       </Docs>
     </Member>
     <Member MemberName="op_Addition">

xml/System.Runtime.Intrinsics/Vector256.xml

@@ -18,7 +18,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides a collection of static methods for creating, manipulating, and otherwise operating on 256-bit vectors.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -6623,7 +6623,7 @@ This method may bypass the cache on certain platforms.
         <Parameter Name="destination" Type="System.Span&lt;T&gt;" Index="1" FrameworkAlternate="net-7.0" />
       </Parameters>
       <Docs>
-        <typeparam name="T">To be added.</typeparam>
+        <typeparam name="T">The type of the input vector.</typeparam>
         <param name="vector">The vector to copy.</param>
         <param name="destination">The span to which <paramref name="destination" /> is copied.</param>
         <summary>Tries to copy a <see cref="T:System.Numerics.Vector`1" /> to a given span.</summary>

xml/System.Runtime.Intrinsics/Vector256`1.xml

@@ -37,8 +37,8 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <typeparam name="T">To be added.</typeparam>
-    <summary>To be added.</summary>
+    <typeparam name="T">The type of the elements in the vector.</typeparam>
+    <summary>Represents a 256-bit vector of a specified numeric type that is suitable for low-level optimization of parallel algorithms.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -232,10 +232,13 @@
         <Parameter Name="index" Type="System.Int32" Index="0" FrameworkAlternate="net-7.0" />
       </Parameters>
       <Docs>
-        <param name="index">To be added.</param>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <param name="index">The index of the element to get.</param>
+        <summary>Gets the element at the specified index.</summary>
+        <value>The value of the element at <paramref name="index" />.</value>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="index" /> was less than zero or greater than the number of elements.</exception>
+        <exception cref="T:System.NotSupportedException">The type of the vector (<typeparamref name="T" />) is not supported.</exception>
       </Docs>
     </Member>
     <Member MemberName="op_Addition">

xml/System.Runtime.Intrinsics/Vector64.xml

@@ -18,7 +18,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides a collection of static methods for creating, manipulating, and otherwise operating on 64-bit vectors.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -2019,7 +2019,7 @@ On x86, this method corresponds to __m64 _mm_setr_pi8
         <Parameter Name="value" Type="T" Index="0" FrameworkAlternate="net-7.0" />
       </Parameters>
       <Docs>
-        <typeparam name="T">To be added.</typeparam>
+        <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.Vector64`1" /> instance with all elements initialized to the specified value.</summary>
         <returns>A new <see cref="T:System.Runtime.Intrinsics.Vector64`1" /> with all elements initialized to <paramref name="value" />.</returns>
@@ -5638,7 +5638,7 @@ This method may bypass the cache on certain platforms.
         <Parameter Name="destination" Type="System.Span&lt;T&gt;" Index="1" FrameworkAlternate="net-7.0" />
       </Parameters>
       <Docs>
-        <typeparam name="T">To be added.</typeparam>
+        <typeparam name="T">The type of the input vector.</typeparam>
         <param name="vector">The vector to copy.</param>
         <param name="destination">The span to which <paramref name="destination" /> is copied.</param>
         <summary>Tries to copy a <see cref="T:System.Numerics.Vector`1" /> to a given span.</summary>

xml/System.Runtime.Intrinsics/Vector64`1.xml

@@ -37,8 +37,8 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <typeparam name="T">To be added.</typeparam>
-    <summary>To be added.</summary>
+    <typeparam name="T">The type of the elements in the vector.</typeparam>
+    <summary>Represents a 64-bit vector of a specified numeric type that is suitable for low-level optimization of parallel algorithms.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -232,10 +232,13 @@
         <Parameter Name="index" Type="System.Int32" Index="0" FrameworkAlternate="net-7.0" />
       </Parameters>
       <Docs>
-        <param name="index">To be added.</param>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <param name="index">The index of the element to get.</param>
+        <summary>Gets the element at the specified index.</summary>
+        <value>The value of the element at <paramref name="index" />.</value>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="index" /> was less than zero or greater than the number of elements.</exception>
+        <exception cref="T:System.NotSupportedException">The type of the vector (<typeparamref name="T" />) is not supported.</exception>
       </Docs>
     </Member>
     <Member MemberName="op_Addition">