IntelliSense review fixes (#3484)

mairaw · web-flow · commit f376d0da4ca9 · 2019-11-14T09:42:06.000-08:00
diff --git a/xml/System.Linq/Enumerable.xml b/xml/System.Linq/Enumerable.xml
@@ -5527,8 +5527,7 @@ Only unique elements are returned.
         </remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="source" /> is <see langword="null" />.</exception>
-        <exception cref="T:System.ArgumentException">
-          No object in <paramref name="source" /> implements the <see cref="T:System.IComparable" /> or <see cref="T:System.IComparable`1" /> interface.</exception>
+        <exception cref="T:System.ArgumentException">No object in <paramref name="source" /> implements the <see cref="T:System.IComparable" /> or <see cref="T:System.IComparable`1" /> interface.</exception>
         <related type="Article" href="~/docs/visual-basic/language-reference/queries/aggregate-clause.md">Aggregate Clause (Visual Basic)</related>
       </Docs>
     </Member>
@@ -6998,8 +6997,7 @@ Only unique elements are returned.
         </remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="source" /> is <see langword="null" />.</exception>
-        <exception cref="T:System.ArgumentException">
-          No object in <paramref name="source" /> implements the <see cref="T:System.IComparable" /> or <see cref="T:System.IComparable`1" /> interface.</exception>
+        <exception cref="T:System.ArgumentException">No object in <paramref name="source" /> implements the <see cref="T:System.IComparable" /> or <see cref="T:System.IComparable`1" /> interface.</exception>
         <related type="Article" href="~/docs/visual-basic/language-reference/queries/aggregate-clause.md">Aggregate Clause (Visual Basic)</related>
       </Docs>
     </Member>
@@ -9322,8 +9320,7 @@ Only unique elements are returned.
         </remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="source" /> or <paramref name="predicate" /> is <see langword="null" />.</exception>
-        <exception cref="T:System.InvalidOperationException">
-          More than one element satisfies the condition in <paramref name="predicate" />. </exception>
+        <exception cref="T:System.InvalidOperationException">More than one element satisfies the condition in <paramref name="predicate" />. </exception>
       </Docs>
     </Member>
     <Member MemberName="Skip&lt;TSource&gt;">
diff --git a/xml/System.Messaging/MessageQueue.xml b/xml/System.Messaging/MessageQueue.xml
@@ -3788,8 +3788,7 @@ myMessageQueue.Send("Text 2."); //Resources are re-acquired.
   
  ]]></format>
         </remarks>
-        <exception cref="T:System.ArgumentException">
-          The <see cref="P:System.Messaging.MessageQueue.MachineName" /> is <see langword="null" />.        
+        <exception cref="T:System.ArgumentException">The <see cref="P:System.Messaging.MessageQueue.MachineName" /> is <see langword="null" />.        
 -or-
 
 The name of the computer is not valid, possibly because the syntax is incorrect.</exception>
diff --git a/xml/System.Net.Http/HttpClient.xml b/xml/System.Net.Http/HttpClient.xml
@@ -413,9 +413,7 @@ The environment variables used for `DefaultProxy` initialization on Windows and
 
  ]]></format>
         </remarks>
-        <exception cref="T:System.ArgumentNullException">
-          The value passed cannot be <see langword="null" />.
-      </exception>
+        <exception cref="T:System.ArgumentNullException">The value passed cannot be <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="DefaultRequestHeaders">
diff --git a/xml/System.Net.Http/HttpResponseMessage.xml b/xml/System.Net.Http/HttpResponseMessage.xml
@@ -272,8 +272,7 @@
   
  ]]></format>
         </remarks>
-        <exception cref="T:System.Net.Http.HttpRequestException">
-            The HTTP response is unsuccessful. </exception>
+        <exception cref="T:System.Net.Http.HttpRequestException">The HTTP response is unsuccessful.</exception>
       </Docs>
     </Member>
     <Member MemberName="Headers">
diff --git a/xml/System.Net.NetworkInformation/IPAddressCollection.xml b/xml/System.Net.NetworkInformation/IPAddressCollection.xml
@@ -241,11 +241,11 @@
           <paramref name="array" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="offset" /> is less than zero.</exception>
-        <exception cref="T:System.ArgumentException">-   <paramref name="array" /> is multidimensional.  
-  
- -or-  
-  
- The number of elements in this <see cref="T:System.Net.NetworkInformation.IPAddressCollection" /> is greater than the available space from <paramref name="offset" /> to the end of the destination <paramref name="array" />.</exception>
+        <exception cref="T:System.ArgumentException"><paramref name="array" /> is multidimensional.  
+
+-or-  
+
+The number of elements in this <see cref="T:System.Net.NetworkInformation.IPAddressCollection" /> is greater than the available space from <paramref name="offset" /> to the end of the destination <paramref name="array" />.</exception>
         <exception cref="T:System.InvalidCastException">The elements in this <see cref="T:System.Net.NetworkInformation.IPAddressCollection" /> cannot be cast automatically to the type of the destination <paramref name="array" />.</exception>
       </Docs>
     </Member>
diff --git a/xml/System.Net.PeerToPeer.Collaboration/PeerCollaborationPermission.xml b/xml/System.Net.PeerToPeer.Collaboration/PeerCollaborationPermission.xml
@@ -160,11 +160,15 @@
   
  ]]></format>
         </remarks>
-        <exception cref="T:System.ArgumentException">-   The parameter is not a valid permission element.  
-  
--   The parameter does not contain a valid type or class.  
-  
--   The parameter's version number is not supported.</exception>
+        <exception cref="T:System.ArgumentException">The parameter is not a valid permission element.
+
+-or-
+
+The parameter does not contain a valid type or class.
+
+-or-
+
+The parameter's version number is not supported.</exception>
         <exception cref="T:System.ArgumentNullException">The parameter is a <see langword="null" /> reference (<see langword="Nothing" /> in Visual Basic).</exception>
         <altmember cref="M:System.Net.PeerToPeer.Collaboration.PeerCollaborationPermission.ToXml" />
         <altmember cref="T:System.Net.PeerToPeer.Collaboration.PeerCollaborationPermissionAttribute" />
diff --git a/xml/System.Net.PeerToPeer/PnrpPermission.xml b/xml/System.Net.PeerToPeer/PnrpPermission.xml
@@ -125,9 +125,11 @@
   
  ]]></format>
         </remarks>
-        <exception cref="T:System.ArgumentException">-   The parameter is not a valid <see cref="T:System.Net.PeerToPeer.PnrpPermission" /> element.  
-  
--   The parameter's version number is not supported.</exception>
+        <exception cref="T:System.ArgumentException">The parameter is not a valid <see cref="T:System.Net.PeerToPeer.PnrpPermission" /> element.
+
+-or-
+
+The parameter's version number is not supported.</exception>
         <exception cref="T:System.ArgumentNullException">The parameter is a <see langword="null" /> reference (<see langword="Nothing" /> in Visual Basic).</exception>
         <altmember cref="M:System.Net.PeerToPeer.PnrpPermission.FromXml(System.Security.SecurityElement)" />
         <altmember cref="M:System.Net.PeerToPeer.PnrpPermission.ToXml" />
@@ -173,9 +175,11 @@
   
  ]]></format>
         </remarks>
-        <exception cref="T:System.ArgumentException">-   The parameter is not a valid <see cref="T:System.Net.PeerToPeer.PnrpPermission" /> element.  
-  
--   The parameter's version number is not supported.</exception>
+        <exception cref="T:System.ArgumentException">The parameter is not a valid <see cref="T:System.Net.PeerToPeer.PnrpPermission" /> element.
+
+-or-
+
+The parameter's version number is not supported.</exception>
         <exception cref="T:System.ArgumentNullException">The parameter is a <see langword="null" /> reference (<see langword="Nothing" /> in Visual Basic).</exception>
         <altmember cref="M:System.Net.PeerToPeer.PnrpPermission.Copy" />
         <altmember cref="M:System.Net.PeerToPeer.PnrpPermission.ToXml" />
diff --git a/xml/System.Net.Security/NegotiateStream.xml b/xml/System.Net.Security/NegotiateStream.xml
@@ -2827,8 +2827,7 @@ The following method is called when the operation completes.
         <exception cref="T:System.ArgumentNullException">
           <paramref name="asyncResult" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">The asyncResult was not created by a call to <see cref="M:System.Net.Security.NegotiateStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)" />.</exception>
-        <exception cref="T:System.InvalidOperationException">
-          There is no pending read operation to complete.
+        <exception cref="T:System.InvalidOperationException">There is no pending read operation to complete.
 
 -or-
 
@@ -2898,8 +2897,7 @@ The following example demonstrates a method that is called to complete the async
         <exception cref="T:System.ArgumentNullException">
           <paramref name="asyncResult" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">The asyncResult was not created by a call to <see cref="M:System.Net.Security.NegotiateStream.BeginWrite(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)" />.</exception>
-        <exception cref="T:System.InvalidOperationException">
-          There is no pending write operation to complete.
+        <exception cref="T:System.InvalidOperationException">There is no pending write operation to complete.
 
 -or-
 
@@ -3467,7 +3465,7 @@ Authentication has not occurred.</exception>
         <param name="offset">A <see cref="T:System.Int32" /> containing the zero-based location in <paramref name="buffer" /> at which to begin storing the data read from this stream.</param>
         <param name="count">A <see cref="T:System.Int32" /> containing the maximum number of bytes to read from the stream.</param>
         <summary>Reads data from this stream and stores it in the specified array.</summary>
-        <returns>A <see cref="T:System.Int32" /> value that specifies the number of bytes read from the underlying stream. When there is no more data to be read, returns 0.</returns>
+        <returns>An <see cref="T:System.Int32" /> value that specifies the number of bytes read from the underlying stream. When there is no more data to be read, returns 0.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
diff --git a/xml/System.Net.Security/SslStream.xml b/xml/System.Net.Security/SslStream.xml
@@ -2643,8 +2643,7 @@
           <paramref name="asyncResult" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="asyncResult" /> was not created by a call to <see cref="M:System.Net.Security.SslStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)" />.</exception>
-        <exception cref="T:System.InvalidOperationException">
-          There is no pending read operation to complete.
+        <exception cref="T:System.InvalidOperationException">There is no pending read operation to complete.
 
 -or-
 
@@ -2712,8 +2711,7 @@ Authentication has not occurred.</exception>
           <paramref name="asyncResult" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="asyncResult" /> was not created by a call to <see cref="M:System.Net.Security.SslStream.BeginWrite(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)" />.</exception>
-        <exception cref="T:System.InvalidOperationException">
-          There is no pending write operation to complete.
+        <exception cref="T:System.InvalidOperationException">There is no pending write operation to complete.
 
 -or-
 
diff --git a/xml/System.Net.Sockets/NetworkStream.xml b/xml/System.Net.Sockets/NetworkStream.xml
@@ -1334,7 +1334,7 @@ myNetworkStream->Close();
  ]]></format>
         </remarks>
         <exception cref="T:System.InvalidOperationException">The <see cref="T:System.Net.Sockets.NetworkStream" /> does not support reading.</exception>
-        <exception cref="T:System.IOException">An error occurred when accessing the socket.
+        <exception cref="T:System.IO.IOException">An error occurred when accessing the socket.
 
 -or-
 
@@ -1423,7 +1423,7 @@ There is a failure reading from the network.</exception>
   
  <paramref name="size" /> is greater than the length of <paramref name="buffer" /> minus <paramref name="offset" />.</exception>
         <exception cref="T:System.InvalidOperationException">The <see cref="T:System.Net.Sockets.NetworkStream" /> does not support reading.</exception>
-        <exception cref="T:System.IOException">An error occurred when accessing the socket.
+        <exception cref="T:System.IO.IOException">An error occurred when accessing the socket.
 
 -or-
 
@@ -1543,7 +1543,7 @@ This method reads as much data as is available into `buffer` and returns the num
  ]]></format>
         </remarks>
         <exception cref="T:System.InvalidOperationException">The <see cref="T:System.Net.Sockets.NetworkStream" /> does not support reading.</exception>
-        <exception cref="T:System.IOException">An error occurred when accessing the socket.
+        <exception cref="T:System.IO.IOException">An error occurred when accessing the socket.
 
 -or-
 
@@ -1602,7 +1602,7 @@ There is a failure reading from the network.</exception>
  ]]></format>
         </remarks>
         <exception cref="T:System.InvalidOperationException">The <see cref="T:System.Net.Sockets.NetworkStream" /> does not support reading.</exception>
-        <exception cref="T:System.IOException">An error occurred when accessing the socket.
+        <exception cref="T:System.IO.IOException">An error occurred when accessing the socket.
 
 -or-
 
@@ -1650,7 +1650,7 @@ There is a failure reading from the network.</exception>
  ]]></format>
         </remarks>
         <exception cref="T:System.InvalidOperationException">The <see cref="T:System.Net.Sockets.NetworkStream" /> does not support reading.</exception>
-        <exception cref="T:System.IOException">An error occurred when accessing the socket.
+        <exception cref="T:System.IO.IOException">An error occurred when accessing the socket.
 
 -or-
 
diff --git a/xml/System.Net.Sockets/Socket.xml b/xml/System.Net.Sockets/Socket.xml
@@ -8173,7 +8173,7 @@ If you're using a connectionless <xref:System.Net.Sockets.Socket>, <xref:System.
         <exception cref="T:System.ArgumentNullException">
           <paramref name="buffer" /> is <see langword="null" />.  
   
- \- or-  
+ -or-  
   
  <paramref name="remoteEP" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
diff --git a/xml/System.Net/FileWebRequest.xml b/xml/System.Net/FileWebRequest.xml
@@ -830,7 +830,7 @@ The stream already received a response previous to your request.</exception>
           ]]></format>
         </remarks>
         <exception cref="T:System.InvalidOperationException">The stream is already in use by a previous call to <see cref="M:System.Net.FileWebRequest.BeginGetResponse(System.AsyncCallback,System.Object)" />.</exception>
-        <exception cref="T:System.Net.WebException">The <see cref="M:System.Net.FileWebRequest" /> was aborted.</exception>
+        <exception cref="T:System.Net.WebException">The <see cref="T:System.Net.FileWebRequest" /> was aborted.</exception>
       </Docs>
     </Member>
     <Member MemberName="Headers">
diff --git a/xml/System.Net/IPAddress.xml b/xml/System.Net/IPAddress.xml
@@ -1837,7 +1837,7 @@
   
 -or-
   
--   <paramref name="scopeId" /> &gt; 0x00000000FFFFFFFF</exception>
+<paramref name="scopeId" /> &gt; 0x00000000FFFFFFFF</exception>
       </Docs>
     </Member>
     <Member MemberName="ToString">
diff --git a/xml/System.Printing/PrintQueue.xml b/xml/System.Printing/PrintQueue.xml
@@ -2608,9 +2608,9 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets a value that indicates whether the printer's driver is built on the [Printing Overview](~/docs/framework/wpf/advanced/printing-overview.md) so it uses [!INCLUDE[TLA#tla_xps](~/includes/tlasharptla-xps-md.md)] as its page description language.</summary>
+        <summary>Gets a value that indicates whether the printer's driver is built on the <see href="~/docs/framework/wpf/advanced/printing-overview.md">XPSDrv model</see> so it uses XML Paper Specification (XPS) as its page description language.</summary>
         <value>
-          <see langword="true" /> if the printer uses the [Printing Overview](~/docs/framework/wpf/advanced/printing-overview.md); otherwise, <see langword="false" />.</value>
+          <see langword="true" /> if the printer uses the <see href="~/docs/framework/wpf/advanced/printing-overview.md">XPS print path</see>; otherwise, <see langword="false" />.</value>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
diff --git a/xml/System.Reflection.Metadata/ManifestResource.xml b/xml/System.Reflection.Metadata/ManifestResource.xml
@@ -110,9 +110,7 @@ Corresponds to the `Flags` field of the `ManifestResource` table in the [ECMA-33
         <ReturnType>System.Reflection.Metadata.EntityHandle</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>
-          Gets the implementation entity handle.
-        </summary>
+        <summary>Gets the implementation entity handle.</summary>
         <value>An EntityHandle instance. If the <see cref="P:System.Reflection.Metadata.EntityHandle.IsNil" /> property is <see langword="true" />, the returned handle will have default values.</value>
         <remarks>
           <format type="text/markdown"><![CDATA[
diff --git a/xml/System.Reflection/MethodImplAttributes.xml b/xml/System.Reflection/MethodImplAttributes.xml
@@ -720,7 +720,7 @@
       </ReturnValue>
       <MemberValue>32</MemberValue>
       <Docs>
-        <summary>Specifies that the method is single-threaded through the body. Static methods (<see langword="Shared" /> in Visual Basic) lock on the type, whereas instance methods lock on the instance. You can also use the C# [lock statement](~/docs/csharp/language-reference/keywords/lock-statement.md) or the Visual Basic [SyncLock statement](~/docs/visual-basic/language-reference/statements/synclock-statement.md) for this purpose.</summary>
+        <summary>Specifies that the method is single-threaded through the body. Static methods (<see langword="Shared" /> in Visual Basic) lock on the type, whereas instance methods lock on the instance. You can also use the C# <see href="~/docs/csharp/language-reference/keywords/lock-statement.md">lock statement</see> or the Visual Basic <see href="~/docs/visual-basic/language-reference/statements/synclock-statement.md">SyncLock statement</see> for this purpose.</summary>
         <forInternalUseOnly />
       </Docs>
     </Member>
diff --git a/xml/System.Resources.Extensions/PreserializedResourceWriter.xml b/xml/System.Resources.Extensions/PreserializedResourceWriter.xml
@@ -99,7 +99,7 @@
         <summary>Adds a resource of the specified type represented by a <see cref="T:System.IO.Stream" /> value that is passed to the type's constructor when reading the resource.</summary>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
-          <see paramref="name" />, <see paramref="typeName" />, or <see paramref="value" /> is <see langword="null" />.</exception>
+          <paramref name="name" />, <paramref name="typeName" />, or <paramref name="value" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">The object's type is <see cref="T:System.IO.Stream" />, but it is unseekable.</exception>
       </Docs>
     </Member>
@@ -129,7 +129,7 @@
         <summary>Adds a resource of the specified type, represented by a byte array, that will be  passed to <see cref="T:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter" /> when reading the resource.</summary>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
-          <see paramref="name" /> or <see paramref="value" /> is <see langword="null" />.</exception>
+          <paramref name="name" /> or <paramref name="value" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="AddResource">
diff --git a/xml/System.Runtime.CompilerServices/Unsafe.xml b/xml/System.Runtime.CompilerServices/Unsafe.xml
diff --git a/xml/System.Runtime.InteropServices/Marshal.xml b/xml/System.Runtime.InteropServices/Marshal.xml
diff --git a/xml/System.Security.Cryptography/AsnEncodedDataCollection.xml b/xml/System.Security.Cryptography/AsnEncodedDataCollection.xml
diff --git a/xml/System.Security.Cryptography/ECDiffieHellman.xml b/xml/System.Security.Cryptography/ECDiffieHellman.xml
diff --git a/xml/System.Security.Cryptography/ECDsa.xml b/xml/System.Security.Cryptography/ECDsa.xml
