IntelliSense review fixes (dotnet#3485)

Author: mairaw

xml/System.Security.Cryptography.Pkcs/CmsRecipientCollection.xml

@@ -234,11 +234,12 @@
         <param name="index">The zero-based index in <paramref name="array" /> where the <see cref="T:System.Security.Cryptography.Pkcs.CmsRecipientCollection" /> collection is copied.</param>
         <summary>The <see cref="M:System.Security.Cryptography.Pkcs.CmsRecipientCollection.CopyTo(System.Array,System.Int32)" /> method copies the <see cref="T:System.Security.Cryptography.Pkcs.CmsRecipientCollection" /> collection to an array.</summary>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.ArgumentException">-   <paramref name="array" /> is not large enough to hold the specified elements.  
-  
--   -or-  
-  
--   <paramref name="array" /> does not contain the proper number of dimensions.</exception>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="array" /> is not large enough to hold the specified elements.  
+
+-or-
+
+<paramref name="array" /> does not contain the proper number of dimensions.</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -281,11 +282,12 @@
         <param name="index">The zero-based index for the array of <see cref="T:System.Security.Cryptography.Pkcs.CmsRecipient" /> objects in <paramref name="array" /> to which the <see cref="T:System.Security.Cryptography.Pkcs.CmsRecipientCollection" /> collection is copied.</param>
         <summary>The <see cref="M:System.Security.Cryptography.Pkcs.CmsRecipientCollection.CopyTo(System.Security.Cryptography.Pkcs.CmsRecipient[],System.Int32)" /> method copies the <see cref="T:System.Security.Cryptography.Pkcs.CmsRecipientCollection" /> collection to a <see cref="T:System.Security.Cryptography.Pkcs.CmsRecipient" /> array.</summary>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.ArgumentException">-   <paramref name="array" /> is not large enough to hold the specified elements.  
-  
--   -or-  
-  
--   <paramref name="array" /> does not contain the proper number of dimensions.</exception>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="array" /> is not large enough to hold the specified elements.  
+
+-or-
+
+<paramref name="array" /> does not contain the proper number of dimensions.</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">

xml/System.Security.Cryptography.Pkcs/Pkcs12CertBag.xml

@@ -107,7 +107,7 @@ For X.509 public-key certificates, the value of this property is a BER-encoded O
         <summary>Gets the contents of the CertBag interpreted as an X.509 public key certificate.</summary>
         <returns>A certificate decoded from the contents of the CertBag.</returns>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.InalidOperationException">The content type is not the X.509 public key certificate content type.</exception>
+        <exception cref="T:System.InvalidOperationException">The content type is not the X.509 public key certificate content type.</exception>
         <exception cref="T:System.Security.Cryptography.CryptographicException">The contents were not valid for the X.509 certificate content type.</exception>
         <altmember cref="P:System.Security.Cryptography.Pkcs.Pkcs12CertBag.IsX509Certificate" />
       </Docs>

xml/System.Security.Cryptography.Pkcs/Pkcs12Info.xml

@@ -149,7 +149,7 @@
       </Parameters>
       <Docs>
         <param name="password">The password to use to attempt to verify integrity.</param>
-        <summary>Attempts to verify the integrity of the <see cref="P:System.Security.Cryptography.Pkcs.Pkcs12Info.AuthenticatedSafe" /> contents with a password represented by a <see cref="T:System.ReadOnlySpan{System.Char}" />.</summary>
+        <summary>Attempts to verify the integrity of the <see cref="P:System.Security.Cryptography.Pkcs.Pkcs12Info.AuthenticatedSafe" /> contents with a password represented by a <c>System.ReadOnlySpan{System.Char}</c>.</summary>
         <returns>
           <see langword="true" /> if the password successfully verifies the integrity of the <see cref="P:System.Security.Cryptography.Pkcs.Pkcs12Info.AuthenticatedSafe" /> contents; <see langword="false" /> if the password is not correct or the contents have been altered.</returns>
         <remarks>

xml/System.Security.Cryptography.X509Certificates/CertificateRequest.xml

@@ -343,8 +343,7 @@
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="issuerCertificate" /> is <see langword="null" />.</exception>
-        <exception cref="T:System.ArgumentException">
-          The <paramref name="issuerCertificate" /> doesn't contain a private key.
+        <exception cref="T:System.ArgumentException">The <paramref name="issuerCertificate" /> doesn't contain a private key.
 
  -or-
 

xml/System.Security.Principal/NTAccount.xml

@@ -228,9 +228,9 @@
       <Docs>
         <param name="targetType">The type being queried for validity to serve as a conversion from <see cref="T:System.Security.Principal.NTAccount" />. The following target types are valid:  
 
- \- <see cref="T:System.Security.Principal.NTAccount" />  
+ - <see cref="T:System.Security.Principal.NTAccount" />  
 
- \- <see cref="T:System.Security.Principal.SecurityIdentifier" /></param>
+ - <see cref="T:System.Security.Principal.SecurityIdentifier" /></param>
         <summary>Returns a value that indicates whether the specified type is a valid translation type for the <see cref="T:System.Security.Principal.NTAccount" /> class.</summary>
         <returns>
           <see langword="true" /> if <paramref name="targetType" /> is a valid translation type for the <see cref="T:System.Security.Principal.NTAccount" /> class; otherwise <see langword="false" />.</returns>

xml/System.Security.Principal/SecurityIdentifier.xml

@@ -178,31 +178,31 @@
         <param name="sidType">One of the enumeration values. This value must not be <see cref="F:System.Security.Principal.WellKnownSidType.LogonIdsSid" />.</param>
         <param name="domainSid">The domain SID. This value is required for the following <see cref="T:System.Security.Principal.WellKnownSidType" /> values. This parameter is ignored for any other <see cref="T:System.Security.Principal.WellKnownSidType" /> values.  
 
- \- <see cref="F:System.Security.Principal.WellKnownSidType.AccountAdministratorSid" />  
+ - <see cref="F:System.Security.Principal.WellKnownSidType.AccountAdministratorSid" />  
 
- \- <see cref="F:System.Security.Principal.WellKnownSidType.AccountGuestSid" />  
+ - <see cref="F:System.Security.Principal.WellKnownSidType.AccountGuestSid" />  
 
- \- <see cref="F:System.Security.Principal.WellKnownSidType.AccountKrbtgtSid" />  
+ - <see cref="F:System.Security.Principal.WellKnownSidType.AccountKrbtgtSid" />  
 
- \- <see cref="F:System.Security.Principal.WellKnownSidType.AccountDomainAdminsSid" />  
+ - <see cref="F:System.Security.Principal.WellKnownSidType.AccountDomainAdminsSid" />  
 
- \- <see cref="F:System.Security.Principal.WellKnownSidType.AccountDomainUsersSid" />  
+ - <see cref="F:System.Security.Principal.WellKnownSidType.AccountDomainUsersSid" />  
 
- \- <see cref="F:System.Security.Principal.WellKnownSidType.AccountDomainGuestsSid" />  
+ - <see cref="F:System.Security.Principal.WellKnownSidType.AccountDomainGuestsSid" />  
 
- \- <see cref="F:System.Security.Principal.WellKnownSidType.AccountComputersSid" />  
+ - <see cref="F:System.Security.Principal.WellKnownSidType.AccountComputersSid" />  
 
- \- <see cref="F:System.Security.Principal.WellKnownSidType.AccountControllersSid" />  
+ - <see cref="F:System.Security.Principal.WellKnownSidType.AccountControllersSid" />  
 
- \- <see cref="F:System.Security.Principal.WellKnownSidType.AccountCertAdminsSid" />  
+ - <see cref="F:System.Security.Principal.WellKnownSidType.AccountCertAdminsSid" />  
 
- \- <see cref="F:System.Security.Principal.WellKnownSidType.AccountSchemaAdminsSid" />  
+ - <see cref="F:System.Security.Principal.WellKnownSidType.AccountSchemaAdminsSid" />  
 
- \- <see cref="F:System.Security.Principal.WellKnownSidType.AccountEnterpriseAdminsSid" />  
+ - <see cref="F:System.Security.Principal.WellKnownSidType.AccountEnterpriseAdminsSid" />  
 
- \- <see cref="F:System.Security.Principal.WellKnownSidType.AccountPolicyAdminsSid" />  
+ - <see cref="F:System.Security.Principal.WellKnownSidType.AccountPolicyAdminsSid" />  
 
- \- <see cref="F:System.Security.Principal.WellKnownSidType.AccountRasAndIasServersSid" /></param>
+ - <see cref="F:System.Security.Principal.WellKnownSidType.AccountRasAndIasServersSid" /></param>
         <summary>Initializes a new instance of the <see cref="T:System.Security.Principal.SecurityIdentifier" /> class by using the specified well known security identifier (SID) type and domain SID.</summary>
         <remarks>To be added.</remarks>
       </Docs>
@@ -570,9 +570,9 @@
       <Docs>
         <param name="targetType">The type being queried for validity to serve as a conversion from <see cref="T:System.Security.Principal.SecurityIdentifier" />. The following target types are valid:  
 
- \- <see cref="T:System.Security.Principal.NTAccount" />  
+ - <see cref="T:System.Security.Principal.NTAccount" />  
 
- \- <see cref="T:System.Security.Principal.SecurityIdentifier" /></param>
+ - <see cref="T:System.Security.Principal.SecurityIdentifier" /></param>
         <summary>Returns a value that indicates whether the specified type is a valid translation type for the <see cref="T:System.Security.Principal.SecurityIdentifier" /> class.</summary>
         <returns>
           <see langword="true" /> if <paramref name="targetType" /> is a valid translation type for the <see cref="T:System.Security.Principal.SecurityIdentifier" /> class; otherwise, <see langword="false" />.</returns>

xml/System.ServiceModel.Dispatcher/XPathMessageFilter.xml

@@ -215,8 +215,7 @@
           <paramref name="reader" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="reader" /> is not positioned on the starting element.</exception>
-        <exception cref="T:System.InvalidOperationException">
-          There were problems reading the dialect attribute or namespace URI, or duplicate attributes were found.
+        <exception cref="T:System.InvalidOperationException">There were problems reading the dialect attribute or namespace URI, or duplicate attributes were found.
 
 -or-
 

xml/System.ServiceModel/WorkflowServiceHost.xml

@@ -465,8 +465,7 @@ The workflow service does not implement <paramref name="implementedContract" />.
 -or-
 
 <paramref name="address" /> is <see langword="null" />.</exception>
-        <exception cref="T:System.InvalidOperationException">
-          The workflow service does not implement <paramref name="implementedContract" />.
+        <exception cref="T:System.InvalidOperationException">The workflow service does not implement <paramref name="implementedContract" />.
 
 -or-
 
@@ -508,8 +507,7 @@ The workflow service does not implement <paramref name="implementedContract" />.
 -or-
 
 <paramref name="address" /> is <see langword="null" />.</exception>
-        <exception cref="T:System.InvalidOperationException">
-          The workflow service does not implement <paramref name="implementedContract" />.
+        <exception cref="T:System.InvalidOperationException">The workflow service does not implement <paramref name="implementedContract" />.
 
 -or-
 

xml/System.Text.Json/Utf8JsonReader.xml

@@ -386,7 +386,7 @@ This method only creates a <xref:System.DateTime> representation of JSON strings
 
 -or-
 
-The entire UTF-8 encoded token value cannot be parsed to a <see cref="System.DateTime" /> value.</exception>
+The entire UTF-8 encoded token value cannot be parsed to a <see cref="T:System.DateTime" /> value.</exception>
         <altmember cref="P:System.Text.Json.Utf8JsonReader.TokenType" />
       </Docs>
     </Member>
@@ -423,7 +423,7 @@ This method only creates a <xref:System.DateTimeOffset> representation of JSON s
 
 -or-
 
-The entire UTF-8 encoded token value cannot be parsed to a <see cref="System.DateTimeOffset" /> value.</exception>
+The entire UTF-8 encoded token value cannot be parsed to a <see cref="T:System.DateTimeOffset" /> value.</exception>
         <altmember cref="P:System.Text.Json.Utf8JsonReader.TokenType" />
       </Docs>
     </Member>
@@ -502,7 +502,7 @@ The entire UTF-8 encoded token value cannot be parsed to a <see cref="System.Dat
 
 -or-
 
-The entire UTF-8 encoded token value cannot be parsed to a <see cref="System.Guid" /> value.</exception>
+The entire UTF-8 encoded token value cannot be parsed to a <see cref="T:System.Guid" /> value.</exception>
         <altmember cref="P:System.Text.Json.Utf8JsonReader.TokenType" />
       </Docs>
     </Member>

xml/System.Text.Json/Utf8JsonWriter.xml

@@ -289,7 +289,7 @@ In the case of <xref:System.IO.Stream>, this writes the data to the stream and f
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="T:System.Threading.CancellationToken.None" />.</param>
+        <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None" />.</param>
         <summary>Asynchronously commits the JSON text written so far, which makes it visible to the output destination.</summary>
         <returns>A task representing the asynchronous flush operation.</returns>
         <remarks>