IntelliSense fixes (#3632)

Author: mairaw

xml/System.Buffers/MemoryPool`1.xml

@@ -111,7 +111,7 @@
       </Parameters>
       <Docs>
         <param name="disposing">
-          <see langword="true" /> to release both managed and unmanaged resources; <see paramname="false" /> to release only unmanaged resources. </param>
+          <see langword="true" /> to release both managed and unmanaged resources; <see langword="false" /> to release only unmanaged resources. </param>
         <summary>Frees the unmanaged resources used by the memory pool and optionally releases the managed resources.</summary>
         <remarks>To be added.</remarks>
       </Docs>

xml/System.ComponentModel.DataAnnotations/ValidationAttribute.xml

@@ -32,8 +32,7 @@
   
  ]]></format>
     </remarks>
-    <exception cref="T:System.ComponentModel.DataAnnotations.ValidationException">The <see cref="P:System.ComponentModel.DataAnnotations.ValidationAttribute.ErrorMessageResourceType" /> and <see cref="P:System.ComponentModel.DataAnnotations.ValidationAttribute.ErrorMessageResourceName" /> properties for localized error message are set at the same time that the non-localized <see cref="P:System.ComponentModel.DataAnnotations.ValidationAttribute.ErrorMessage" /> property error message is set.</exception>
-    <related type="Article" href="https://msdn.microsoft.com/library/ef99e518-f112-4797-bf9c-79f4ceb466ea">How to: Customize Data Field Validation in the Data Model Using Custom Attributes</related>
+    <related type="Article" href="https://docs.microsoft.com/previous-versions/aspnet/cc668224(v=vs.100)">How to: Customize Data Field Validation in the Data Model Using Custom Attributes</related>
   </Docs>
   <Members>
     <MemberGroup MemberName=".ctor">

xml/System.Data.Common/DbCommand.xml

@@ -1497,7 +1497,7 @@
       <Docs>
         <param name="cancellationToken">An optional token to cancel the asynchronous operation. The default value is <see cref="P:System.Threading.CancellationToken.None" />.</param>
         <summary>Asynchronously creates a prepared (or compiled) version of the command on the data source.</summary>
-        <returns>A <see cref="P:System.Threading.Tasks.Task" /> representing the asynchronous operation.</returns>
+        <returns>A <see cref="T:System.Threading.Tasks.Task" /> representing the asynchronous operation.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   

xml/System.Data.Common/DbDataReader.xml

@@ -1102,8 +1102,7 @@ private static void GetDataTypes(String connectionString)
 
  There was an asynchronous operation in progress. This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream.</exception>
         <exception cref="T:System.IndexOutOfRangeException">The column index is out of range.</exception>
-        <exception cref="T:System.InvalidCastException">
-          The value returned by the database doesn't match or cannot be cast to <typeparamref name="T" />.</exception>
+        <exception cref="T:System.InvalidCastException">The value returned by the database doesn't match or cannot be cast to <typeparamref name="T" />.</exception>
       </Docs>
     </Member>
     <MemberGroup MemberName="GetFieldValueAsync&lt;T&gt;">
@@ -1187,8 +1186,7 @@ private static void GetDataTypes(String connectionString)
 
  There was an asynchronous operation in progress. This applies to all Get_*_ methods when running in sequential mode, as they could be called while reading a stream.</exception>
         <exception cref="T:System.IndexOutOfRangeException">The column index is out of range.</exception>
-        <exception cref="T:System.InvalidCastException">
-          The value returned by the database doesn't match or cannot be cast to <typeparamref name="T" />.</exception>
+        <exception cref="T:System.InvalidCastException">The value returned by the database doesn't match or cannot be cast to <typeparamref name="T" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="GetFieldValueAsync&lt;T&gt;">
@@ -1265,8 +1263,7 @@ private static void GetDataTypes(String connectionString)
 
  There was an asynchronous operation in progress. This applies to all Get_*_ methods when running in sequential mode, as they could be called while reading a stream.</exception>
         <exception cref="T:System.IndexOutOfRangeException">The column index is out of range.</exception>
-        <exception cref="T:System.InvalidCastException">
-          The value returned by the database doesn't match or cannot be cast to <typeparamref name="T" />.</exception>
+        <exception cref="T:System.InvalidCastException">The value returned by the database doesn't match or cannot be cast to <typeparamref name="T" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="GetFloat">
@@ -2233,8 +2230,7 @@ private static void GetCredits(String connectionString)
       <Docs>
         <param name="ordinal">The zero-based column to be retrieved.</param>
         <summary>Asynchronously gets a value that indicates whether the column contains non-existent or missing values.</summary>
-        <returns>
-          A <see cref="T:System.Threading.Tasks.Task`1" /> whose <see cref="P:System.Threading.Tasks.Task`1.Result" /> property is <see langword="true" /> if the specified column value is equivalent to <see langword="DBNull" /> or <see langword="false" /> if it is not.</returns>
+        <returns>A <see cref="T:System.Threading.Tasks.Task`1" /> whose <see cref="P:System.Threading.Tasks.Task`1.Result" /> property is <see langword="true" /> if the specified column value is equivalent to <see langword="DBNull" /> or <see langword="false" /> if it is not.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
  ## Remarks
@@ -2305,8 +2301,7 @@ private static void GetCredits(String connectionString)
         <param name="ordinal">The zero-based column to be retrieved.</param>
         <param name="cancellationToken">A token to cancel the asynchronous operation.</param>
         <summary>Asynchronously gets a value that indicates whether the column contains non-existent or missing values.</summary>
-        <returns>
-          A <see cref="T:System.Threading.Tasks.Task`1" /> whose <see cref="P:System.Threading.Tasks.Task`1.Result" /> property is <see langword="true" /> if the specified column value is equivalent to <see langword="DBNull" /> or <see langword="false" /> if it is not.</returns>
+        <returns>A <see cref="T:System.Threading.Tasks.Task`1" /> whose <see cref="P:System.Threading.Tasks.Task`1.Result" /> property is <see langword="true" /> if the specified column value is equivalent to <see langword="DBNull" /> or <see langword="false" /> if it is not.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
  ## Remarks

xml/System.Data.Common/DbTransaction.xml

@@ -140,7 +140,7 @@
       <Docs>
         <param name="cancellationToken">An optional token to cancel the asynchronous operation. The default value is <see cref="P:System.Threading.CancellationToken.None" />.</param>
         <summary>Asynchronously commits the database transaction.</summary>
-        <returns>A <see cref="P:System.Threading.Tasks.Task" /> representing the asynchronous operation.</returns>
+        <returns>A <see cref="T:System.Threading.Tasks.Task" /> representing the asynchronous operation.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   

xml/System.Data/DataReaderExtensions.xml

@@ -465,8 +465,7 @@
 
  There was an asynchronous operation in progress. This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream.</exception>
         <exception cref="T:System.IndexOutOfRangeException">The name specified is not a valid column name.</exception>
-        <exception cref="T:System.InvalidCastException">
-          The value returned by the database doesn't match or cannot be cast to <typeparamref name="T" />.</exception>
+        <exception cref="T:System.InvalidCastException">The value returned by the database doesn't match or cannot be cast to <typeparamref name="T" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="GetFieldValueAsync&lt;T&gt;">
@@ -1032,8 +1031,7 @@
         <param name="name">The name of the column.</param>
         <param name="cancellationToken">An optional token to cancel the asynchronous operation.</param>
         <summary>Asynchronously gets a value that indicates whether the column contains non-existent or missing values.</summary>
-        <returns>
-          A <see cref="T:System.Threading.Tasks.Task`1" /> whose <see cref="P:System.Threading.Tasks.Task`1.Result" /> property is <see langword="true" /> if the specified column value is equivalent to <see langword="DBNull" /> or <see langword="false" /> if it is not.</returns>
+        <returns>A <see cref="T:System.Threading.Tasks.Task`1" /> whose <see cref="P:System.Threading.Tasks.Task`1.Result" /> property is <see langword="true" /> if the specified column value is equivalent to <see langword="DBNull" /> or <see langword="false" /> if it is not.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
  ## Remarks

xml/System.Data/IDbDataParameter.xml

@@ -99,7 +99,7 @@
       </ReturnValue>
       <Docs>
         <summary>Indicates the scale of numeric parameters.</summary>
-        <value>The number of decimal places to which <see cref="T:System.Data.OleDb.OleDbParameter.Value" /> is resolved. The default is 0.</value>
+        <value>The number of decimal places to which <see cref="P:System.Data.OleDb.OleDbParameter.Value" /> is resolved. The default is 0.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.IO.Enumeration/FileSystemName.xml

@@ -84,7 +84,7 @@
         <param name="name">The name to check against the expression.</param>
         <param name="ignoreCase">
           <see langword="true" /> to ignore case (default), <see langword="false" /> if the match should be case-sensitive.</param>
-        <summary> Verifies if the given Win32 expression matches the given name. Supports the following wildcards: '*', '?', '&lt;', '&gt;', '"'. The backslash character '\' escapes.</summary>
+        <summary>Verifies if the given Win32 expression matches the given name. Supports the following wildcards: '*', '?', '&lt;', '&gt;', '"'. The backslash character '\' escapes.</summary>
         <returns>
           <see langword="true" /> if the given expression matches the given name; otherwise, <see langword="false" />.</returns>
         <remarks>

xml/System.IO.Pipes/PipeStream.xml

@@ -2134,8 +2134,7 @@ If the operation is canceled before it completes, the returned task contains the
         </remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="buffer" /> is <see langword="null" />.</exception>
-        <exception cref="T:System.ArgumentOutOfRangeException">
-The <paramref name="offset" /> is negative.
+        <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="offset" /> is negative.
 
 -or-
 

xml/System.IO/Directory.xml

@@ -3105,9 +3105,9 @@ Directory::CreateDirectory("Public\\Html");
         <exception cref="T:System.ArgumentException">
           <paramref name="path" /> is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters with the <see cref="M:System.IO.Path.GetInvalidPathChars" /> method.
 
-          -or-
+-or-
 
-          <paramref name="searchPattern" /> does not contain a valid pattern.</exception>
+<paramref name="searchPattern" /> does not contain a valid pattern.</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="path" /> or <paramref name="searchPattern" /> is <see langword="null" />.</exception>
         <exception cref="T:System.IO.PathTooLongException">The specified path, file name, or both exceed the system-defined maximum length.</exception>