Add documentation for PbeParameters (#2786)

* Add documentation for PbeParameters

* Update PbeEncryptionAlgorithm.xml

Author: bartonjs

xml/System.Security.Cryptography/PbeEncryptionAlgorithm.xml

@@ -16,7 +16,7 @@
     <BaseTypeName>System.Enum</BaseTypeName>
   </Base>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Specifies encryption algorithms to be used with Password-Based Encryption (PBE).</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -40,7 +40,7 @@
       </ReturnValue>
       <MemberValue>1</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Indicates the encryption should be performed with the AES-128 algorithm in CBC mode with PKCS#7 padding.</summary>
       </Docs>
     </Member>
     <Member MemberName="Aes192Cbc">
@@ -63,7 +63,7 @@
       </ReturnValue>
       <MemberValue>2</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Indicates the encryption should be performed with the AES-192 algorithm in CBC mode with PKCS#7 padding.</summary>
       </Docs>
     </Member>
     <Member MemberName="Aes256Cbc">
@@ -86,7 +86,7 @@
       </ReturnValue>
       <MemberValue>3</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Indicates that encryption be performed with the AES-256 algorithm in CBC mode with PKCS#7 padding.</summary>
       </Docs>
     </Member>
     <Member MemberName="TripleDes3KeyPkcs12">
@@ -109,7 +109,7 @@
       </ReturnValue>
       <MemberValue>4</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Indicates the encryption should be performed with the TripleDES algorithm in CBC mode with a 192-bit key derived using the Key Derivation Function (KDF) from PKCS#12.</summary>
       </Docs>
     </Member>
     <Member MemberName="Unknown">
@@ -132,8 +132,8 @@
       </ReturnValue>
       <MemberValue>0</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Indicates that no encryption algorithm has been selected.</summary>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Security.Cryptography/PbeParameters.xml

@@ -17,8 +17,9 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Represents parameters to be used for Password-Based Encryption (PBE).</summary>
     <remarks>To be added.</remarks>
+    <threadsafe>All public and protected members of <see cref="T:System.Security.Cryptography.PbeParameters" /> are thread-safe and may be used concurrently from multiple threads.</threadsafe>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
@@ -42,11 +43,12 @@
         <Parameter Name="iterationCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="encryptionAlgorithm">To be added.</param>
-        <param name="hashAlgorithm">To be added.</param>
-        <param name="iterationCount">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="encryptionAlgorithm">The algorithm to use when encrypting data.</param>
+        <param name="hashAlgorithm">The name of a hash algorithm to use with the Key Derivation Function (KDF) to turn a password into an encryption key.</param>
+        <param name="iterationCount">The iteration count to provide to the Key Derivation Function (KDF) to turn a password into an encryption key.</param>
+        <summary>Initializes a new instance of the <see cref="T:System.Security.Cryptography.PbeParameters"/> class.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="iterationCount"/> is less than 1.</exception>
       </Docs>
     </Member>
     <Member MemberName="EncryptionAlgorithm">
@@ -68,8 +70,8 @@
         <ReturnType>System.Security.Cryptography.PbeEncryptionAlgorithm</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets the algorithm to use when encrypting data.</summary>
+        <value>The algorithm to use when encrypting data.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -92,8 +94,8 @@
         <ReturnType>System.Security.Cryptography.HashAlgorithmName</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets the name of the hash algorithm to use with the Key Derivation Function (KDF) to turn a password into an encryption key.</summary>
+        <value>The name of the hash algorithm to use with the Key Derivation Function (KDF) to turn a password into an encryption key.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -116,10 +118,10 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets the iteration count to provide to the Key Derivation Function (KDF) to turn a password into an encryption key.</summary>
+        <value>The iteration count to provide to the Key Derivation Function (KDF) to turn a password into an encryption key.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>