Automatic port of System.Formats.Asn1 documentation (dotnet#4668)

* Automatic port of System.Formats.As1 documentation

* Apply suggestions from code review

Co-authored-by: Jeremy Barton <[email protected]>

Co-authored-by: carlossanlop <[email protected]>
Co-authored-by: Jeremy Barton <[email protected]>

Author: carlossanlop

xml/System.Formats.Asn1/Asn1Tag.xml

@@ -13,7 +13,7 @@
     <BaseTypeName>System.Enum</BaseTypeName>
   </Base>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>The encoding ruleset for an <see cref="T:System.Formats.Asn1.AsnReader" /> or <see cref="T:System.Formats.Asn1.AsnWriter" />.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -34,7 +34,8 @@
       </ReturnValue>
       <MemberValue>0</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>ITU-T X.690 Basic Encoding Rules</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="CER">
@@ -54,7 +55,8 @@
       </ReturnValue>
       <MemberValue>1</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>ITU-T X.690 Canonical Encoding Rules</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="DER">
@@ -74,7 +76,8 @@
       </ReturnValue>
       <MemberValue>2</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>ITU-T X.690 Distinguished Encoding Rules</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
   </Members>

xml/System.Formats.Asn1/AsnDecoder.xml

@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Specifies options that modify the behavior of an <see cref="T:System.Formats.Asn1.AsnReader" />.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -34,8 +34,10 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets or sets a value that indicates whether the reader should bypass sort ordering on a Set or Set-Of value.</summary>
+        <value>
+          <see langword="true" /> if the reader should not validate that a Set or Set-Of value is sorted correctly for the current encoding rules; otherwise <see langword="false" />.
+              The default is <see langword="false" />.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -55,8 +57,8 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets or sets the largest year to represent with a UtcTime value.</summary>
+        <value>The largest year to represent with a UtcTime value. The default is 2049.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Formats.Asn1/AsnEncodingRules.xml

@@ -42,7 +42,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Formats.Asn1/AsnReader.xml

@@ -13,7 +13,7 @@
     <BaseTypeName>System.Enum</BaseTypeName>
   </Base>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>The tag class for a particular ASN.1 tag.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -34,7 +34,8 @@
       </ReturnValue>
       <MemberValue>64</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The Application tag class</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="ContextSpecific">
@@ -54,7 +55,8 @@
       </ReturnValue>
       <MemberValue>128</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The Context-Specific tag class</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Private">
@@ -74,7 +76,8 @@
       </ReturnValue>
       <MemberValue>192</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The Private tag class</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Universal">
@@ -94,7 +97,8 @@
       </ReturnValue>
       <MemberValue>0</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The Universal tag class</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
   </Members>