From 85cfc4bb9c200522001874058652aeac9ab1fd44 Mon Sep 17 00:00:00 2001
From: Jeremy Barton <jbarton@microsoft.com>
Date: Tue, 30 Jul 2019 11:20:41 -0700
Subject: [PATCH] Document the new Pkcs12-Mode enumerations

---
 .../Pkcs12ConfidentialityMode.xml                    | 12 ++++++------
 .../Pkcs12IntegrityMode.xml                          | 12 ++++++------
 2 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/xml/System.Security.Cryptography.Pkcs/Pkcs12ConfidentialityMode.xml b/xml/System.Security.Cryptography.Pkcs/Pkcs12ConfidentialityMode.xml
index 6c013616665..2444dd227f4 100644
--- a/xml/System.Security.Cryptography.Pkcs/Pkcs12ConfidentialityMode.xml
+++ b/xml/System.Security.Cryptography.Pkcs/Pkcs12ConfidentialityMode.xml
@@ -14,7 +14,7 @@
     <BaseTypeName>System.Enum</BaseTypeName>
   </Base>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Represents the kind of encryption associated with a PKCS#12 SafeContents value.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -36,7 +36,7 @@
       </ReturnValue>
       <MemberValue>1</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The SafeContents value is not encrypted.</summary>
       </Docs>
     </Member>
     <Member MemberName="Password">
@@ -57,7 +57,7 @@
       </ReturnValue>
       <MemberValue>2</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The SafeContents value is encrypted with a password.</summary>
       </Docs>
     </Member>
     <Member MemberName="PublicKey">
@@ -78,7 +78,7 @@
       </ReturnValue>
       <MemberValue>3</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The SafeContents value is encrypted using public key cryptography.</summary>
       </Docs>
     </Member>
     <Member MemberName="Unknown">
@@ -99,8 +99,8 @@
       </ReturnValue>
       <MemberValue>0</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The kind of encryption applied to the SafeContents is unknown or could not be determined.</summary>
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/xml/System.Security.Cryptography.Pkcs/Pkcs12IntegrityMode.xml b/xml/System.Security.Cryptography.Pkcs/Pkcs12IntegrityMode.xml
index 51d94ad45b5..f264c4c3569 100644
--- a/xml/System.Security.Cryptography.Pkcs/Pkcs12IntegrityMode.xml
+++ b/xml/System.Security.Cryptography.Pkcs/Pkcs12IntegrityMode.xml
@@ -14,7 +14,7 @@
     <BaseTypeName>System.Enum</BaseTypeName>
   </Base>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Represents the type of anti-tampering applied to a PKCS#12 PFX value.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -36,7 +36,7 @@
       </ReturnValue>
       <MemberValue>1</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The PKCS#12 PFX value is not protected from tampering.</summary>
       </Docs>
     </Member>
     <Member MemberName="Password">
@@ -57,7 +57,7 @@
       </ReturnValue>
       <MemberValue>2</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The PKCS#12 PFX value is protected from tampering with a Message Authentication Code (MAC) keyed with a password.</summary>
       </Docs>
     </Member>
     <Member MemberName="PublicKey">
@@ -78,7 +78,7 @@
       </ReturnValue>
       <MemberValue>3</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The PKCS#12 PFX value is protected from tampering with a digital signature using public key cryptography.</summary>
       </Docs>
     </Member>
     <Member MemberName="Unknown">
@@ -99,8 +99,8 @@
       </ReturnValue>
       <MemberValue>0</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The type of anti-tampering applied to the PKCS#12 PFX is unknown or could not be determined.</summary>
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>