Merge pull request #3801 from dotnet/master

Update live with current master

Author: mairaw

xml/System.IO/Path.xml

@@ -1513,7 +1513,7 @@ For more information on file paths on Windows, see [File path formats on Windows
 
  -or-
 
-<see cref="P:System.String.Empty" /> if <paramref name="path" /> does not contain root directory information.
+<see cref="F:System.String.Empty" /> if <paramref name="path" /> does not contain root directory information.
 
  -or-
 

xml/System.IdentityModel.Protocols.WSTrust/KeyTypes.xml

@@ -34,7 +34,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>A URI that represents the asymmetric key type; http://schemas.System.com/idfx/keytype/asymmetric.</summary>
+        <summary>A URI that represents the asymmetric key type; <c>http://schemas.System.com/idfx/keytype/asymmetric</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -54,7 +54,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>A URI that represents the bearer key type; http://schemas.System.com/idfx/keytype/bearer.</summary>
+        <summary>A URI that represents the bearer key type; <c>http://schemas.System.com/idfx/keytype/bearer</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -74,7 +74,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>A URI that represents the symmetric key type; http://schemas.System.com/idfx/keytype/symmetric.</summary>
+        <summary>A URI that represents the symmetric key type; <c>http://schemas.System.com/idfx/keytype/symmetric</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.IdentityModel.Protocols.WSTrust/RequestTypes.xml

@@ -41,7 +41,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>A string constant that represents a protocol-agnostic URI for a WS-Trust Cancel request; http://schemas.System.com/idfx/requesttype/cancel.</summary>
+        <summary>A string constant that represents a protocol-agnostic URI for a WS-Trust Cancel request; <c>http://schemas.System.com/idfx/requesttype/cancel</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>A string constant that represents a protocol-agnostic URI for a WS-Trust GetMetadata request; http://schemas.System.com/idfx/requesttype/getMetadata.</summary>
+        <summary>A string constant that represents a protocol-agnostic URI for a WS-Trust GetMetadata request; <c>http://schemas.System.com/idfx/requesttype/getMetadata</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -81,7 +81,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>A string constant that represents a protocol-agnostic URI for a WS-Trust Issue request; http://schemas.System.com/idfx/requesttype/issue.</summary>
+        <summary>A string constant that represents a protocol-agnostic URI for a WS-Trust Issue request; <c>http://schemas.System.com/idfx/requesttype/issue</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -101,7 +101,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>A string constant that represents a protocol-agnostic WS-Trust IssueCard request; http://schemas.System.com/idfx/requesttype/issueCard.</summary>
+        <summary>A string constant that represents a protocol-agnostic WS-Trust IssueCard request; <c>http://schemas.System.com/idfx/requesttype/issueCard</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -121,7 +121,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>A string constant that represents a protocol-agnostic URI for a WS-Trust Renew request; http://schemas.System.com/idfx/requesttype/renew.</summary>
+        <summary>A string constant that represents a protocol-agnostic URI for a WS-Trust Renew request; <c>http://schemas.System.com/idfx/requesttype/renew</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -141,7 +141,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>A string constant that represents a protocol-agnostic URI for a WS-Trust Validate request; http://schemas.System.com/idfx/requesttype/validate.</summary>
+        <summary>A string constant that represents a protocol-agnostic URI for a WS-Trust Validate request; <c>http://schemas.System.com/idfx/requesttype/validate</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.IdentityModel.Tokens/AuthenticationMethods.xml

@@ -41,7 +41,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Authentication by using a hardware token, http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/hardwaretoken.</summary>
+        <summary>Authentication by using a hardware token, <c>http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/hardwaretoken</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Authentication by using the Kerberos protocol, http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/kerberos.</summary>
+        <summary>Authentication by using the Kerberos protocol, <c>http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/kerberos</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -81,7 +81,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The namespace for the well-known authentication methods, http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/.</summary>
+        <summary>The namespace for the well-known authentication methods, <c>http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -101,7 +101,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Authentication by using a password, http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/password.</summary>
+        <summary>Authentication by using a password, <c>http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/password</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -121,7 +121,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Authentication by using a key authenticated by a PGP web of trust, http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/pgp.</summary>
+        <summary>Authentication by using a key authenticated by a PGP web of trust, <c>http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/pgp</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -141,7 +141,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Authentication by using the Secure Remote Password protocol, http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/secureremotepassword.</summary>
+        <summary>Authentication by using the Secure Remote Password protocol, <c>http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/secureremotepassword</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -161,7 +161,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Authentication by using an XML digital signature, http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/signature.</summary>
+        <summary>Authentication by using an XML digital signature, <c>http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/signature</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -181,7 +181,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Authentication by using a smartcard, http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/smartcard.</summary>
+        <summary>Authentication by using a smartcard, <c>http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/smartcard</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -201,7 +201,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Authentication by using a smartcard PKI, http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/smartcardpki.</summary>
+        <summary>Authentication by using a smartcard PKI, <c>http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/smartcardpki</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -221,7 +221,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Authentication on a key authenticated using an SPKI PKI, http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/spki.</summary>
+        <summary>Authentication on a key authenticated using an SPKI PKI, <c>http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/spki</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -241,7 +241,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Authentication by using either the SSL or TLS protocol with certificate-based client authentication, http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/tlsclient.</summary>
+        <summary>Authentication by using either the SSL or TLS protocol with certificate-based client authentication, <c>http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/tlsclient</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -261,7 +261,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Authentication by using an unspecified method, http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/unspecified.</summary>
+        <summary>Authentication by using an unspecified method, <c>http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/unspecified</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -281,7 +281,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Windows authentication, http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/windows.</summary>
+        <summary>Windows authentication, <c>http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/windows</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -301,7 +301,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Authentication on a key authenticated using an X.509 PKI, http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/x509.</summary>
+        <summary>Authentication on a key authenticated using an X.509 PKI, <c>http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/x509</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -321,7 +321,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Authentication on a key authenticated using an XKMS trust service, http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/xkms.</summary>
+        <summary>Authentication on a key authenticated using an XKMS trust service, <c>http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/xkms</c>.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Reflection.Metadata.Ecma335/SignatureTypeEncoder.xml

@@ -819,7 +819,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Encodes a void pointer (<code>void*</code>).</summary>
+        <summary>Encodes a void pointer (<c>void*</c>).</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Security.Cryptography/DSACng.xml

@@ -178,8 +178,7 @@
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="rgbHash" /> is <see langword="null" />.</exception>
-        <exception cref="T:System.Security.Cryptography.CryptographicException">
-            This instance represents only a public key.
+        <exception cref="T:System.Security.Cryptography.CryptographicException">This instance represents only a public key.
 
 -or-
 

xml/System.Security.Cryptography/ECDiffieHellmanCng.xml

@@ -1071,7 +1071,7 @@ Because key sizes do not uniquely identify elliptic curves, the use of the prope
 ]]></format>
         </remarks>
         <exception cref="T:System.Security.Cryptography.CryptographicException">
-          <paramref name="value" /> is not permitted by <see cref="P:System.Security.Cryptography.ECDiffieHellmanCng.LegalKeySizes" />.</exception>
+          <paramref name="value" /> is not permitted by <see cref="P:System.Security.Cryptography.AsymmetricAlgorithm.LegalKeySizes" />.</exception>
         <altmember cref="M:System.Security.Cryptography.ECDiffieHellmanCng.GenerateKey(System.Security.Cryptography.ECCurve)" />
       </Docs>
     </Member>

xml/System.Threading.Channels/ChannelReader`1.xml

@@ -177,7 +177,7 @@ Each <xref:System.Collections.Generic.IAsyncEnumerator%601.MoveNextAsync> call t
           <para>A <see cref="T:System.Threading.Tasks.ValueTask`1" /> that will complete with a <see langword="true" /> result when data is available to read
             or with a <see langword="false" /> result when no further data will ever be available to be read due to the channel completing successfully.</para>
           <para>If the channel completes with an exception, the task will also complete with an exception.</para>
-      .</returns>
+        </returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Windows.Controls/PasswordBox.xml

@@ -1039,9 +1039,7 @@ PasswordBox with CaretBrush set to red
       </ReturnValue>
       <Docs>
         <summary>Gets or sets the masking character for the <see cref="T:System.Windows.Controls.PasswordBox" />.</summary>
-        <value>A masking character to echo when the user enters text into the <see cref="T:System.Windows.Controls.PasswordBox" />.  
-  
- The default value is a bullet character (**●**).</value>
+        <value>A masking character to echo when the user enters text into the <see cref="T:System.Windows.Controls.PasswordBox" />. The default value is a bullet character (●).</value>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   

xml/System.Windows.Controls/Slider.xml

@@ -562,7 +562,7 @@
       </ReturnValue>
       <Docs>
         <summary>Gets or sets the amount of time in milliseconds between increase or decrease commands when a user clicks the <see cref="T:System.Windows.Controls.Primitives.RepeatButton" /> of a <see cref="T:System.Windows.Controls.Slider" />.</summary>
-        <value>A time in milliseconds between commands that change the <see cref="P:System.Windows.Controls.Primitives.RangeBase.Value" /> of a <see cref="T:System.Windows.Controls.Slider" />. The default is the system key repeat rate. For more information, see [SystemParametersInfo](https://msdn.microsoft.com/library/default.asp?url=/library/sysinfo/base/systemparametersinfo.asp) (SPI_GETKEYBOARDSPEED).</value>
+        <value>A time in milliseconds between commands that change the <see cref="P:System.Windows.Controls.Primitives.RangeBase.Value" /> of a <see cref="T:System.Windows.Controls.Slider" />. The default is the system key repeat rate. For more information, see <see href="/windows/win32/api/winuser/nf-winuser-systemparametersinfoa">SystemParametersInfo</see> (SPI_GETKEYBOARDSPEED).</value>
         <remarks>
           <format type="text/markdown"><![CDATA[