Port System.Security new docs (#10156)

* System.Security.Cryptography

* System.Security.Cryptography.X509Certificates

Author: carlossanlop

xml/System.Security.Cryptography.X509Certificates/X509SubjectKeyIdentifierHashAlgorithm.xml

@@ -169,7 +169,7 @@
       </ReturnValue>
       <MemberValue>3</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The SHA-256 hash over the SubjectPublicKeyInfo as described in RFC 7093.</summary>
       </Docs>
     </Member>
     <Member MemberName="Sha384">
@@ -195,7 +195,7 @@
       </ReturnValue>
       <MemberValue>4</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The SHA-384 hash over the SubjectPublicKeyInfo as described in RFC 7093.</summary>
       </Docs>
     </Member>
     <Member MemberName="Sha512">
@@ -221,7 +221,7 @@
       </ReturnValue>
       <MemberValue>5</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The SHA-512 hash over the SubjectPublicKeyInfo as described in RFC 7093.</summary>
       </Docs>
     </Member>
     <Member MemberName="ShortSha1">
@@ -290,7 +290,7 @@
       </ReturnValue>
       <MemberValue>6</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The SHA-256 hash over the subjectPublicKey truncated to the leftmost 160-bits as described in RFC 7093.</summary>
       </Docs>
     </Member>
     <Member MemberName="ShortSha384">
@@ -316,7 +316,7 @@
       </ReturnValue>
       <MemberValue>7</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The SHA-384 hash over the subjectPublicKey truncated to the leftmost 160-bits as described in RFC 7093.</summary>
       </Docs>
     </Member>
     <Member MemberName="ShortSha512">
@@ -342,7 +342,7 @@
       </ReturnValue>
       <MemberValue>8</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The SHA-512 hash over the subjectPublicKey truncated to the leftmost 160-bits as described in RFC 7093.</summary>
       </Docs>
     </Member>
   </Members>

xml/System.Security.Cryptography/CryptographicOperations.xml

@@ -307,9 +307,11 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Creates a new instance of <see cref="T:System.Security.Cryptography.IncrementalHash" /> with the existing appended data preserved.</summary>
+        <returns>A clone of the current instance.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.Security.Cryptography.CryptographicException">An error has occurred during the operation.</exception>
+        <exception cref="T:System.ObjectDisposedException">The object has already been disposed.</exception>
       </Docs>
     </Member>
     <Member MemberName="CreateHash">

xml/System.Security.Cryptography/IncrementalHash.xml

@@ -39,7 +39,7 @@
       <Docs>
         <summary>Initializes a new instance of the <see cref="T:System.Security.Cryptography.Shake128" /> class.</summary>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.PlatformNotSupportedException">The platform does not support SHAKE128. Callers can use the <see cref="P:System.Security.Cryptography.Shake128.IsSupported" /> property
+        <exception cref="T:System.PlatformNotSupportedException">The platform does not support SHAKE128. Callers can use the <see cref="P:System.Security.Cryptography.Shake128.IsSupported" /> property
               to determine if the platform supports SHAKE128.</exception>
       </Docs>
     </Member>
@@ -126,9 +126,12 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Creates a new instance of <see cref="T:System.Security.Cryptography.Shake128" /> with the existing appended data preserved.</summary>
+        <returns>A clone of the current instance.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.Security.Cryptography.CryptographicException">An error has occurred during the operation.</exception>
+        <exception cref="T:System.InvalidOperationException">The current instance is being read from and cannot be cloned.</exception>
+        <exception cref="T:System.ObjectDisposedException">The object has already been disposed.</exception>
       </Docs>
     </Member>
     <Member MemberName="Dispose">
@@ -314,7 +317,7 @@
           <paramref name="outputLength" /> is negative.</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="source" /> is <see langword="null" />.</exception>
-        <exception cref="T:System.PlatformNotSupportedException">The platform does not support SHAKE128. Callers can use the <see cref="P:System.Security.Cryptography.Shake128.IsSupported" /> property
+        <exception cref="T:System.PlatformNotSupportedException">The platform does not support SHAKE128. Callers can use the <see cref="P:System.Security.Cryptography.Shake128.IsSupported" /> property
               to determine if the platform supports SHAKE128.</exception>
       </Docs>
     </Member>
@@ -356,7 +359,7 @@
           <paramref name="outputLength" /> is negative.</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="source" /> is <see langword="null" />.</exception>
-        <exception cref="T:System.PlatformNotSupportedException">The platform does not support SHAKE128. Callers can use the <see cref="P:System.Security.Cryptography.Shake128.IsSupported" /> property
+        <exception cref="T:System.PlatformNotSupportedException">The platform does not support SHAKE128. Callers can use the <see cref="P:System.Security.Cryptography.Shake128.IsSupported" /> property
               to determine if the platform supports SHAKE128.</exception>
       </Docs>
     </Member>
@@ -396,7 +399,7 @@
           <paramref name="source" /> does not support reading.</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="source" /> is <see langword="null" />.</exception>
-        <exception cref="T:System.PlatformNotSupportedException">The platform does not support SHAKE128. Callers can use the <see cref="P:System.Security.Cryptography.Shake128.IsSupported" /> property
+        <exception cref="T:System.PlatformNotSupportedException">The platform does not support SHAKE128. Callers can use the <see cref="P:System.Security.Cryptography.Shake128.IsSupported" /> property
               to determine if the platform supports SHAKE128.</exception>
       </Docs>
     </Member>
@@ -434,7 +437,7 @@
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="outputLength" /> is negative.</exception>
-        <exception cref="T:System.PlatformNotSupportedException">The platform does not support SHAKE128. Callers can use the <see cref="P:System.Security.Cryptography.Shake128.IsSupported" /> property
+        <exception cref="T:System.PlatformNotSupportedException">The platform does not support SHAKE128. Callers can use the <see cref="P:System.Security.Cryptography.Shake128.IsSupported" /> property
               to determine if the platform supports SHAKE128.</exception>
       </Docs>
     </Member>
@@ -463,7 +466,7 @@
         <param name="destination">The buffer to fill with the hash.</param>
         <summary>Computes the hash of data using the SHAKE128 algorithm.</summary>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.PlatformNotSupportedException">The platform does not support SHAKE128. Callers can use the <see cref="P:System.Security.Cryptography.Shake128.IsSupported" /> property
+        <exception cref="T:System.PlatformNotSupportedException">The platform does not support SHAKE128. Callers can use the <see cref="P:System.Security.Cryptography.Shake128.IsSupported" /> property
               to determine if the platform supports SHAKE128.</exception>
       </Docs>
     </Member>
@@ -502,7 +505,7 @@
       <Docs>
         <param name="source">The stream to hash.</param>
         <param name="outputLength">The size of the hash to produce.</param>
-        <param name="cancellationToken">The token to monitor for cancellation requests.
+        <param name="cancellationToken">The token to monitor for cancellation requests.
               The default value is <see cref="P:System.Threading.CancellationToken.None" />.</param>
         <summary>Asynchronously computes the hash of a stream using the SHAKE128 algorithm.</summary>
         <returns>A <see cref="T:System.Threading.Tasks.ValueTask`1" /> that completes with the computed hash.</returns>
@@ -515,7 +518,7 @@
           <paramref name="source" /> is <see langword="null" />.</exception>
         <exception cref="T:System.OperationCanceledException">
           <paramref name="cancellationToken" /> has been canceled.</exception>
-        <exception cref="T:System.PlatformNotSupportedException">The platform does not support SHAKE128. Callers can use the <see cref="P:System.Security.Cryptography.Shake128.IsSupported" /> property
+        <exception cref="T:System.PlatformNotSupportedException">The platform does not support SHAKE128. Callers can use the <see cref="P:System.Security.Cryptography.Shake128.IsSupported" /> property
               to determine if the platform supports SHAKE128.</exception>
       </Docs>
     </Member>
@@ -549,7 +552,7 @@
       <Docs>
         <param name="source">The stream to hash.</param>
         <param name="destination">The buffer to fill with the hash.</param>
-        <param name="cancellationToken">The token to monitor for cancellation requests.
+        <param name="cancellationToken">The token to monitor for cancellation requests.
               The default value is <see cref="P:System.Threading.CancellationToken.None" />.</param>
         <summary>Asynchronously computes the hash of a stream using the SHAKE128 algorithm.</summary>
         <returns>A <see cref="T:System.Threading.Tasks.ValueTask" /> that represents the asynchronous operation.</returns>
@@ -560,7 +563,7 @@
           <paramref name="source" /> does not support reading.</exception>
         <exception cref="T:System.OperationCanceledException">
           <paramref name="cancellationToken" /> has been canceled.</exception>
-        <exception cref="T:System.PlatformNotSupportedException">The platform does not support SHAKE128. Callers can use the <see cref="P:System.Security.Cryptography.Shake128.IsSupported" /> property
+        <exception cref="T:System.PlatformNotSupportedException">The platform does not support SHAKE128. Callers can use the <see cref="P:System.Security.Cryptography.Shake128.IsSupported" /> property
               to determine if the platform supports SHAKE128.</exception>
       </Docs>
     </Member>
@@ -612,10 +615,16 @@
         <Parameter Name="outputLength" Type="System.Int32" Index="0" FrameworkAlternate="net-9.0" />
       </Parameters>
       <Docs>
-        <param name="outputLength">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="outputLength">The size of the hash to produce.</param>
+        <summary>Retrieves the hash for the data accumulated from prior calls to the <c>AppendData</c> methods without resetting the object to its initial state and allowing additional calls to continue retrieving the hash.</summary>
+        <returns>The computed hash.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="outputLength" /> is negative.</exception>
+        <exception cref="T:System.Security.Cryptography.CryptographicException">An error has occurred during the operation.</exception>
+        <exception cref="T:System.ObjectDisposedException">The object has already been disposed.</exception>
+        <exception cref="T:System.PlatformNotSupportedException">The platform does not support multiple reads of the hash. <see cref="M:System.Security.Cryptography.Shake128.GetHashAndReset(System.Int32)" /> can be used
+              to perform a single operation.</exception>
       </Docs>
     </Member>
     <Member MemberName="Read">
@@ -637,9 +646,13 @@
         <Parameter Name="destination" Type="System.Span&lt;System.Byte&gt;" Index="0" FrameworkAlternate="net-9.0" />
       </Parameters>
       <Docs>
-        <param name="destination">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="destination">The buffer to fill with the hash.</param>
+        <summary>Fills the buffer with the hash for the data accumulated from prior calls to the <c>AppendData</c> methods without resetting the object to its initial state and allowing additional calls to continue retrieving the hash.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.Security.Cryptography.CryptographicException">An error has occurred during the operation.</exception>
+        <exception cref="T:System.ObjectDisposedException">The object has already been disposed.</exception>
+        <exception cref="T:System.PlatformNotSupportedException">The platform does not support multiple reads of the hash. <see cref="M:System.Security.Cryptography.Shake128.GetHashAndReset(System.Span{System.Byte})" /> can be used
+              to perform a single operation.</exception>
       </Docs>
     </Member>
     <Member MemberName="Reset">
@@ -659,8 +672,10 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Resets the instance back to its initial state.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.Security.Cryptography.CryptographicException">An error has occurred during the operation.</exception>
+        <exception cref="T:System.ObjectDisposedException">The object has already been disposed.</exception>
       </Docs>
     </Member>
   </Members>