Fix up crefs/xrefs (#9754)

Author: gewarren

xml/System.Diagnostics/ActivityLink.xml

@@ -202,9 +202,7 @@ Activity links can be used to represent batched operations where an activity was
         <remarks>
           <format type="text/markdown"><![CDATA[
 
-    ## Remarks
-
-    <xref:System.Diagnostics.ActivityLink> equality is currently undefined. The current behavior is that two <xref:System.Diagnostics.ActivityLink> instances with the same <xref:System.Diagnostics.ActivityContext> and no tags will return `true` for <xref:System.Diagnostics.ActivityLink.Equals(System.Object)>. Prior to .NET 7, xref:System.Diagnostics.ActivityLink> instances sharing an <xref:System.Diagnostics.ActivityTagsCollection> instance and the same <xref:System.Diagnostics.ActivityContext> would return `true` for <xref:System.Diagnostics.ActivityLink.Equals(System.Object)>. Starting from .NET 7, <xref:System.Diagnostics.ActivityLink.Equals(System.Object)> will always return `false` when tags are used. This may change in the future. Exercise caution in calling this method.
+    <xref:System.Diagnostics.ActivityLink> equality is currently undefined. The current behavior is that two <xref:System.Diagnostics.ActivityLink> instances with the same <xref:System.Diagnostics.ActivityContext> and no tags will return `true` for <xref:System.Diagnostics.ActivityLink.Equals(System.Object)>. Prior to .NET 7, <xref:System.Diagnostics.ActivityLink> instances sharing an <xref:System.Diagnostics.ActivityTagsCollection> instance and the same <xref:System.Diagnostics.ActivityContext> would return `true` for <xref:System.Diagnostics.ActivityLink.Equals(System.Object)>. Starting in .NET 7, <xref:System.Diagnostics.ActivityLink.Equals(System.Object)> always returns `false` when tags are used.
 
           ]]></format>
         </remarks>

xml/System.Drawing.Printing/PrintPageEventArgs.xml

@@ -296,7 +296,7 @@
  :::code language="csharp" source="~/snippets/csharp/System.Drawing.Printing/PrintPageEventArgs/Overview/source.cs" id="Snippet1":::
  :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Winforms/Classic PrintPageEventArgs Example/VB/source.vb" id="Snippet1":::
 
- For another example that shows how to use <xref:System.Drawing.Printing.PrintPageEventArgs.HasMorePages%2A>, see [How to: Print a Multi-Page Text File in Windows Forms](/dotnet/framework/winforms/advanced/how-to-print-a-multi-page-text-file-in-windows-forms)
+ For another example that shows how to use <xref:System.Drawing.Printing.PrintPageEventArgs.HasMorePages%2A>, see [How to: Print a Multi-Page Text File in Windows Forms](/dotnet/framework/winforms/advanced/how-to-print-a-multi-page-text-file-in-windows-forms).
 
  ]]></format>
         </remarks>

xml/System.Net.Sockets/TcpClient.xml

@@ -934,7 +934,7 @@ The `Available` property is a way to determine whether data is queued for readin
 > If you receive a <xref:System.Net.Sockets.SocketException>, use <xref:System.Net.Sockets.SocketException.ErrorCode%2A?displayProperty=nameWithType> to obtain the specific error code. After you have obtained this code, you can refer to the [Windows Sockets version 2 API error code](/windows/desktop/winsock/windows-sockets-error-codes-2) documentation for a detailed description of the error.
 
 > [!NOTE]
-> This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in the .NET Framework](/dotnet/framework/network-programming/network-tracing)
+> This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in the .NET Framework](/dotnet/framework/network-programming/network-tracing).
 
 > [!NOTE]
 > If you receive NotSupportedException with message `This protocol version is not supported` while using IPv6 address, then make sure you enabled IPv6 in constructor by passing <xref:System.Net.Sockets.AddressFamily.InterNetworkV6>.

xml/System.Net/HttpListener.xml

@@ -389,7 +389,7 @@
 
  This method does not block while the operation completes. To get an incoming request and block until the operation completes, call the <xref:System.Net.HttpListener.GetContext%2A> method.
 
- For detailed information about using the asynchronous programming model, see [Calling Synchronous Methods Asynchronously](/dotnet/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously)
+ For detailed information about using the asynchronous programming model, see [Calling Synchronous Methods Asynchronously](/dotnet/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously).
 
 
 
@@ -598,7 +598,7 @@ The following code example demonstrates calling the `Close` method:
 
  Because calling the <xref:System.Net.HttpListener.EndGetContext%2A> method requires the <xref:System.Net.HttpListener> object, this object is typically passed into a callback method by using the state object passed into the <xref:System.Net.HttpListener.BeginGetContext%2A> method. You can obtain this state object by using the <xref:System.IAsyncResult.AsyncState%2A> property of the `asyncResult` object.
 
- For detailed information about using the asynchronous programming model, see [Calling Synchronous Methods Asynchronously](/dotnet/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously)
+ For detailed information about using the asynchronous programming model, see [Calling Synchronous Methods Asynchronously](/dotnet/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously).
 
 
 

xml/System.Net/WebClient.xml

@@ -2849,7 +2849,7 @@ internal class MyWebClient : WebClientProtocol
 ## Remarks
  Classes that inherit from this class can override this method to perform additional tasks when the <xref:System.Net.WebClient.DownloadDataCompleted> event occurs.
 
- Raising an event invokes the event handler through a delegate. For more information, see [Handling and Raising Events](/dotnet/standard/events/)
+ Raising an event invokes the event handler through a delegate. For more information, see [Handling and Raising Events](/dotnet/standard/events/).
 
  The <xref:System.Net.WebClient.OnDownloadDataCompleted%2A> method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.
 

xml/System.Runtime.Remoting/RemotingConfiguration.xml

@@ -213,7 +213,7 @@
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
- Passing `null` as the `filename` parameter will cause default remoting initialization without requiring the existence of a configuration file. For more information about remoting and security see [Security in Remoting.](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/9hwst9th(v=vs.100))
+ Passing `null` as the `filename` parameter will cause default remoting initialization without requiring the existence of a configuration file. For more information about remoting and security see [Security in Remoting.](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/9hwst9th(v=vs.100)).
 
  For configuration file syntax, see [Remoting Settings Schema](https://msdn.microsoft.com/library/dc2d1e62-9af7-4ca1-99fd-98b93bb4db9e).
 
@@ -879,7 +879,7 @@
 
  To activate a client-activated object type with the `new` keyword, you must first register the object type on the client end using the <xref:System.Runtime.Remoting.RemotingConfiguration.RegisterActivatedClientType%2A> method. Calling the <xref:System.Runtime.Remoting.RemotingConfiguration.RegisterActivatedClientType%2A> method gives the remoting infrastructure the location of the remote application where `new` attempts to create it. If, on the other hand, you use the <xref:System.Activator.CreateInstance%2A?displayProperty=nameWithType> method to create a new instance of the client-activated object, you must supply the remote application's URL as a parameter, so no prior registration on the client end is necessary. To supply the <xref:System.Activator.CreateInstance%2A?displayProperty=nameWithType> method with the URL of the server where you want to create the object, you must encapsulate the URL in an instance of the <xref:System.Runtime.Remoting.Activation.UrlAttribute> class.
 
- For a detailed description of client-activated objects, see [Client Activation](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/w93betdk(v=vs.100))
+ For a detailed description of client-activated objects, see [Client Activation](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/w93betdk(v=vs.100)).
 
 
 

xml/System.Security.Cryptography/DSACng.xml

@@ -295,7 +295,7 @@ An error occurred during signature creation.
       <Docs>
         <param name="disposing">
           <see langword="true" /> to release managed and unmanaged resources; <see langword="false" /> to release only unmanaged resources.</param>
-        <summary>Releases the resources used by the current instance of the <see xref="T:System.Security.Cryptography.DSACng" /> class.</summary>
+        <summary>Releases the resources used by the current instance of the <see cref="T:System.Security.Cryptography.DSACng" /> class.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Security.Cryptography/DSACryptoServiceProvider.xml

@@ -498,7 +498,7 @@
       <Docs>
         <param name="disposing">
           <see langword="true" /> to release managed and unmanaged resources; <see langword="false" /> to release only unmanaged resources.</param>
-        <summary>Releases the resources used by the current instance of the <see xref="T:System.Security.Cryptography.DSACng" /> class.</summary>
+        <summary>Releases the resources used by the current instance of the <see cref="T:System.Security.Cryptography.DSACryptoServiceProvider" /> class.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Security.Cryptography/DSAOpenSsl.xml

@@ -42,14 +42,14 @@
   <Docs>
     <summary>Provides an implementation of the Digital Signature Algorithm (DSA) backed by OpenSSL.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
 
 This class should only be used directly when doing platform interop with the system OpenSSL library. When platform interop is not needed, you should use the <xref:System.Security.Cryptography.DSA.Create%2A?displayProperty=nameWithType> factory methods instead of a specific derived implementation.
 
 > [!IMPORTANT]
-> The creators of the DSA algorithm have withdrawn their support for it. Consider using the <xref:System.Security.Cryptography.RSA> class or the <xref:System.Security.Cryptography.ECDsa> class instead of the <xref:System.Security.Cryptography.DSA> class. Use <xref:System.Security.Cryptography.DSA> only for compatibility with legacy applications and data.  
+> The creators of the DSA algorithm have withdrawn their support for it. Consider using the <xref:System.Security.Cryptography.RSA> class or the <xref:System.Security.Cryptography.ECDsa> class instead of the <xref:System.Security.Cryptography.DSA> class. Use <xref:System.Security.Cryptography.DSA> only for compatibility with legacy applications and data.
 
 DSAOpenSSL provides the FIPS 186-3 version of DSA.
 
@@ -104,9 +104,9 @@ DSAOpenSSL provides the FIPS 186-3 version of DSA.
       <Docs>
         <summary>Initializes a new instance of the <see cref="T:System.Security.Cryptography.DSAOpenSsl" /> class with a default key size of 2048 bits.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
 
 This constructor does not generate a new DSA public/private keypair immediately, it just sets the size which will be used to generate a key when one is needed.
 If key is loaded via the <xref:System.Security.Cryptography.DSAOpenSsl.ImportParameters%2A> method, or other key import method, the key size from this constructor has no meaning.
@@ -167,9 +167,9 @@ If key is loaded via the <xref:System.Security.Cryptography.DSAOpenSsl.ImportPar
         <param name="keySize">The size of the key to generate, when a key is needed.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Security.Cryptography.DSAOpenSsl" /> class with a specified key size.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
 
 This constructor does not generate a new DSA public/private keypair immediately, it just sets the size which will be used to generate a key when one is needed.
 If key is loaded via the <xref:System.Security.Cryptography.DSAOpenSsl.ImportParameters%2A> method, or other key import method, the `keySize` provided to this constructor has no meaning.
@@ -231,13 +231,13 @@ If key is loaded via the <xref:System.Security.Cryptography.DSAOpenSsl.ImportPar
         <param name="handle">The OpenSSL <c>DSA*</c> value to use as the key.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Security.Cryptography.DSAOpenSsl" /> class from an existing OpenSSL key represented as a <c>DSA*</c>.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
 
 > [!IMPORTANT]
 > OpenSSL supports multiple library versions being loaded within the same process.
-> Before calling this constructor, verify your pointer value came from the same version of OpenSSL that this class uses. 
+> Before calling this constructor, verify your pointer value came from the same version of OpenSSL that this class uses.
 > For more information, see <xref:System.Security.Cryptography.SafeEvpPKeyHandle.OpenSslVersion>.
 
  ]]></format>
@@ -364,9 +364,9 @@ If key is loaded via the <xref:System.Security.Cryptography.DSAOpenSsl.ImportPar
         <param name="pkeyHandle">The OpenSSL <c>EVP_PKEY*</c> value to use as the key, represented as a <see cref="T:System.Security.Cryptography.SafeEvpPKeyHandle" />.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Security.Cryptography.DSAOpenSsl" /> class from an existing OpenSSL key represented as an <c>EVP_PKEY*</c>.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
 
 > [!IMPORTANT]
 > OpenSSL supports multiple library versions being loaded within the same process.
@@ -455,7 +455,7 @@ An error occurred during signature creation.
       <Docs>
         <param name="disposing">
           <see langword="true" /> to release managed and unmanaged resources; <see langword="false" /> to release only unmanaged resources.</param>
-        <summary>Releases the resources used by the current instance of the <see xref="T:System.Security.Cryptography.DSAOpenSsl" /> class.</summary>
+        <summary>Releases the resources used by the current instance of the <see cref="T:System.Security.Cryptography.DSAOpenSsl" /> class.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -489,9 +489,9 @@ An error occurred during signature creation.
         <summary>Gets a <see cref="T:System.Security.Cryptography.SafeEvpPKeyHandle" /> representation of the cryptographic key.</summary>
         <returns>A <see cref="T:System.Security.Cryptography.SafeEvpPKeyHandle" /> representation of the cryptographic key.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
 
 Each call to this method produces a new <xref:System.Security.Cryptography.SafeEvpPKeyHandle> object with its own lifetime.
 The objects returned by this method can safely be used even after this <xref:System.Security.Cryptography.DSAOpenSsl> instance has been disposed.
@@ -681,9 +681,9 @@ The objects returned by this method can safely be used even after this <xref:Sys
         <summary>Gets or sets the size, in bits, of the key modulus used by the asymmetric algorithm.</summary>
         <value>The size, in bits, of the key modulus used by the asymmetric algorithm.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
 
 Setting this property to its current value has no visible effect.
 Setting this property to a new legal value discards the current key, but defers creation of a new key until one is needed.

xml/System.Web.Configuration/SystemWebCachingSectionGroup.xml

@@ -24,7 +24,7 @@
 
  The <xref:System.Web.Configuration.SystemWebCachingSectionGroup> class and the `caching` section provide centralized control of the caching mechanism for a site or application. This makes it possible for caching to be deployed, modified, and disabled without modifying individual pages in the application.
 
- The ASP.NET caching mechanism is implemented by the <xref:System.Web.Caching.Cache> class. For more information, see [ASP.NET Caching Overview](https://docs.microsoft.com/previous-versions/aspnet/ms178597(v=vs.100))
+ The ASP.NET caching mechanism is implemented by the <xref:System.Web.Caching.Cache> class. For more information, see [ASP.NET Caching Overview](https://docs.microsoft.com/previous-versions/aspnet/ms178597(v=vs.100)).
 
  The following list describes the two types of caching ASP.NET provides.