Intellisense review fixes - Part 2 (dotnet#3483)

* Intellisense review fixes

* add missing API

Author: mairaw

_zip/missingapi.yml

@@ -1,6 +1,10 @@
 ### YamlMime:XRefMap
 hrefUpdated: true
 references:
+- uid: System.Diagnostics.PresentationTraceSources.TraceLevel
+  name: PresentationTraceSources.TraceLevel
+  fullname: System.Diagnostics.PresentationTraceSources.TraceLevel
+  href: https://docs.microsoft.com/previous-versions/bb778381(v=vs.110)
 - uid: System.MonoNotSupportedAttribute
   name: MonoNotSupportedAttribute
   fullname: System.MonoNotSupportedAttribute

xml/System.Buffers/ArrayBufferWriter`1.xml

@@ -114,11 +114,8 @@ You must request a new buffer after calling `Advance` to continue writing more d
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">
-          <paramref name="count" /> is negative.
-            </exception>
-        <exception cref="T:System.InvalidOperationException">
-            The method call attempts to advance past the end of the underlying buffer.
-            </exception>
+          <paramref name="count" /> is negative.</exception>
+        <exception cref="T:System.InvalidOperationException">The method call attempts to advance past the end of the underlying buffer.</exception>
       </Docs>
     </Member>
     <Member MemberName="Capacity">

xml/System.ComponentModel.DataAnnotations/DisplayAttribute.xml

@@ -543,11 +543,8 @@ End Class
   
  ]]></format>
         </remarks>
-        <exception cref="T:System.InvalidOperationException">
-                Both the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.ResourceType" /> property and <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.ShortName" /> properties were set,
-                but a public static property with a name matching the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.ShortName" /> value couldn't be found
-                on the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.ResourceType" />.
-            </exception>
+        <exception cref="T:System.InvalidOperationException">Both the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.ResourceType" /> property and <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.ShortName" /> properties were set, 
+but a public static property with a name matching the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.ShortName" /> value couldn't be found on the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.ResourceType" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="GroupName">

xml/System.ComponentModel/VersionConverter.xml

@@ -14,9 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>
-      <para>Provides a type converter to convert <see cref="T:System.Version" /> objects to and from various other representations.</para>
-    </summary>
+    <summary>Provides a type converter to convert <see cref="T:System.Version" /> objects to and from various other representations.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -59,9 +57,7 @@
       <Docs>
         <param name="context">An object that provides contextual information.</param>
         <param name="sourceType">The type of the object to be converted.</param>
-        <summary>
-          <para>Gets a value indicating whether this converter can convert an object in the given source type to a <see cref="T:System.Version" />.</para>
-        </summary>
+        <summary>Gets a value indicating whether this converter can convert an object in the given source type to a <see cref="T:System.Version" />.</summary>
         <returns>
           <see langword="true" /> if this converter can convert `sourceType` to a <see cref="T:System.Version" />; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
@@ -89,9 +85,7 @@
       <Docs>
         <param name="context">An object that provides contextual information.</param>
         <param name="destinationType">The target type for the conversion.</param>
-        <summary>
-          <para>Gets a value indicating whether this converter can convert an object to the given destination type using the context.</para>
-        </summary>
+        <summary>Gets a value indicating whether this converter can convert an object to the given destination type using the context.</summary>
         <returns>
           <see langword="true" /> if the converter can convert an object to the given destination type; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
@@ -155,9 +149,7 @@
         <param name="culture">The culture that supplies formatting information for the conversion.</param>
         <param name="value">The value to be converted.</param>
         <param name="destinationType">The type to convert the value parameter to.</param>
-        <summary>
-          <para>Converts the specified value to the specified destination type using the specified context and arguments.</para>
-        </summary>
+        <summary>Converts the specified value to the specified destination type using the specified context and arguments.</summary>
         <returns>An object that represents the converted value.</returns>
         <remarks>To be added.</remarks>
       </Docs>

xml/System.Composition.Hosting.Core/CompositionOperation.xml

@@ -90,8 +90,7 @@ Instances of this class are not safe for access by multiple threads.
       </Parameters>
       <Docs>
         <param name="action">The action to run.</param>
-        <summary>Specifies an action to run after all composition has completed, as indicated by the <see cref="T:System.Composition.OnImportsSatisfiedAttribute" />.
-        </summary>
+        <summary>Specifies an action to run after all composition has completed, as indicated by the <see cref="T:System.Composition.OnImportsSatisfiedAttribute" />.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   

xml/System.Data.SqlClient/SqlConnection.xml

@@ -860,8 +860,7 @@ End Module
         <param name="newSecurePassword">To be added.</param>
         <summary>Changes the SQL Server password for the user indicated in the <see cref="T:System.Data.SqlClient.SqlCredential" /> object.</summary>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.ArgumentException">
-          The connection string contains any combination of <see langword="UserId" />, <see langword="Password" />, or <see langword="Integrated Security=true" />.
+        <exception cref="T:System.ArgumentException">The connection string contains any combination of <see langword="UserId" />, <see langword="Password" />, or <see langword="Integrated Security=true" />.
 
 -or-
 

xml/System.Data/XmlReadMode.xml

@@ -114,8 +114,7 @@
       <Docs>
         <summary>Reads a DiffGram, applying changes from the DiffGram to the <see cref="T:System.Data.DataSet" />. The semantics are identical to those of a <see cref="M:System.Data.DataSet.Merge(System.Data.DataSet)" /> operation. As with the <see cref="M:System.Data.DataSet.Merge(System.Data.DataSet)" /> operation, <see cref="P:System.Data.DataRow.RowState" /> values are preserved. Input to <see cref="M:System.Data.DataSet.ReadXml(System.Xml.XmlReader)" /> with DiffGrams should only be obtained using the output from <see cref="M:System.Data.DataSet.WriteXml(System.IO.Stream)" /> as a DiffGram.
 
-The target <see cref="T:System.Data.DataSet" /> must have the same schema as the <see cref="T:System.Data.DataSet" /> on which <see cref="Overload:System.Data.DataSet.WriteXml" /> as DiffGram is called. Otherwise the DiffGram merge operation fails and an exception is thrown.
-        </summary>
+The target <see cref="T:System.Data.DataSet" /> must have the same schema as the <see cref="T:System.Data.DataSet" /> on which <see cref="Overload:System.Data.DataSet.WriteXml" /> as DiffGram is called. Otherwise the DiffGram merge operation fails and an exception is thrown.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Device.Location/GeoCoordinate.xml

@@ -649,7 +649,7 @@
   
  ]]></format>
         </remarks>
-        <exception cref="System.ArgumentOutOfRangeException">
+        <exception cref="T:System.ArgumentOutOfRangeException">
           <see cref="P:System.Device.Location.GeoCoordinate.Speed" /> is set outside the valid range.</exception>
       </Docs>
     </Member>

xml/System.Diagnostics/PresentationTraceSources.xml

@@ -197,8 +197,8 @@ switchName="SourceSwitch" >
       </Parameters>
       <Docs>
         <param name="element">The element from which the property value is read.</param>
-        <summary>Gets the value of the <see cref="P:System.Diagnostics.PresentationTraceSources.TraceLevelProperty" /> attached property for a specified element.</summary>
-        <returns>The <see cref="P:System.Diagnostics.PresentationTraceSources.TraceLevelProperty" /> property value for the element.</returns>
+        <summary>Gets the value of the <see cref="P:System.Diagnostics.PresentationTraceSources.TraceLevel" /> attached property for a specified element.</summary>
+        <returns>The <see cref="P:System.Diagnostics.PresentationTraceSources.TraceLevel" /> property value for the element.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
@@ -372,7 +372,7 @@ switchName="SourceSwitch" >
       <Docs>
         <param name="element">The element to which the attached property is written.</param>
         <param name="traceLevel">The needed <see cref="T:System.Diagnostics.PresentationTraceLevel" /> value.</param>
-        <summary>Sets the value of the <see cref="P:System.Diagnostics.PresentationTraceSources.TraceLevelProperty" /> attached property to a specified element.</summary>
+        <summary>Sets the value of the <see cref="P:System.Diagnostics.PresentationTraceSources.TraceLevel" /> attached property to a specified element.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
@@ -422,7 +422,7 @@ switchName="SourceSwitch" >
         <ReturnType>System.Windows.DependencyProperty</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Identifies the <see cref="P:System.Diagnostics.PresentationTraceSources.TraceLevelProperty" /> attached property.</summary>
+        <summary>Identifies the <see cref="P:System.Diagnostics.PresentationTraceSources.TraceLevel" /> attached property.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   

xml/System.DirectoryServices.ActiveDirectory/ReplicationConnection.xml

@@ -69,17 +69,23 @@
         <remarks>To be added.</remarks>
         <exception cref="T:System.DirectoryServices.ActiveDirectory.ActiveDirectoryOperationException">A call to the underlying directory service resulted in an error.</exception>
         <exception cref="T:System.DirectoryServices.ActiveDirectory.ActiveDirectoryServerDownException">The target server is either busy or unavailable.</exception>
-        <exception cref="T:System.ArgumentException">This exception will occur for any one of the following reasons:  
-  
--   The target of the <paramref name="context" /> parameter is not a domain controller or AD LDS instance.  
-  
--   <paramref name="sourceServer" /> is invalid or an empty string.  
-  
--   The target specified in the <paramref name="context" /> parameter does not match the server type specified in the <paramref name="sourceServer" /> parameter. The servers must both be either domain controllers or AD LDS instances.  
-  
--   The servers specified in the <paramref name="context" /> and <paramref name="sourceServer" /> parameters are domain controllers, but are not in the same forest.  
-  
--   The servers specified in the <paramref name="context" /> and <paramref name="sourceServer" /> parameters are AD LDS instances, but do not belong to the same configuration set.</exception>
+        <exception cref="T:System.ArgumentException">The target of the <paramref name="context" /> parameter is not a domain controller or AD LDS instance.  
+
+-or-
+
+<paramref name="sourceServer" /> is invalid or an empty string.
+
+-or-
+
+The target specified in the <paramref name="context" /> parameter does not match the server type specified in the <paramref name="sourceServer" /> parameter. The servers must both be either domain controllers or AD LDS instances.
+
+-or-
+
+The servers specified in the <paramref name="context" /> and <paramref name="sourceServer" /> parameters are domain controllers, but are not in the same forest.
+
+-or-
+
+The servers specified in the <paramref name="context" /> and <paramref name="sourceServer" /> parameters are AD LDS instances, but do not belong to the same configuration set.</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="context" /> or <paramref name="sourceServer" /> is <see langword="null" />.</exception>
         <exception cref="T:System.Security.Authentication.AuthenticationException">The credentials that were supplied are not valid.</exception>
@@ -116,17 +122,23 @@
         <remarks>To be added.</remarks>
         <exception cref="T:System.DirectoryServices.ActiveDirectory.ActiveDirectoryOperationException">A call to the underlying directory service resulted in an error.</exception>
         <exception cref="T:System.DirectoryServices.ActiveDirectory.ActiveDirectoryServerDownException">The target server is either busy or unavailable.</exception>
-        <exception cref="T:System.ArgumentException">This exception will occur for any one of the following reasons:  
-  
--   The target of the <paramref name="context" /> parameter is not a domain controller or AD LDS instance.  
-  
--   <paramref name="sourceServer" /> is invalid or an empty string.  
-  
--   The target specified in the <paramref name="context" /> parameter does not match the server type specified in the <paramref name="sourceServer" /> parameter. The servers must both be either domain controllers or AD LDS instances.  
-  
--   The servers specified in the <paramref name="context" /> and <paramref name="sourceServer" /> parameters are domain controllers, but are not in the same forest.  
-  
--   The servers specified in the <paramref name="context" /> and <paramref name="sourceServer" /> parameters are AD LDS instances, but do not belong to the same configuration set.</exception>
+        <exception cref="T:System.ArgumentException">The target of the <paramref name="context" /> parameter is not a domain controller or AD LDS instance.
+
+-or-
+
+<paramref name="sourceServer" /> is invalid or an empty string.
+
+-or-
+
+The target specified in the <paramref name="context" /> parameter does not match the server type specified in the <paramref name="sourceServer" /> parameter. The servers must both be either domain controllers or AD LDS instances.
+
+-or-
+
+The servers specified in the <paramref name="context" /> and <paramref name="sourceServer" /> parameters are domain controllers, but are not in the same forest.
+
+-or-
+
+The servers specified in the <paramref name="context" /> and <paramref name="sourceServer" /> parameters are AD LDS instances, but do not belong to the same configuration set.</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="context" />, <paramref name="sourceServer" /> or <paramref name="schedule" /> is <see langword="null" />.</exception>
         <exception cref="T:System.Security.Authentication.AuthenticationException">The credentials that were supplied are not valid.</exception>
@@ -164,17 +176,23 @@
         <remarks>To be added.</remarks>
         <exception cref="T:System.DirectoryServices.ActiveDirectory.ActiveDirectoryOperationException">A call to the underlying directory service resulted in an error.</exception>
         <exception cref="T:System.DirectoryServices.ActiveDirectory.ActiveDirectoryServerDownException">The target server is either busy or unavailable.</exception>
-        <exception cref="T:System.ArgumentException">This exception will occur for any one of the following reasons:  
-  
--   The target of the <paramref name="context" /> parameter is not a domain controller or AD LDS instance.  
-  
--   <paramref name="sourceServer" /> is invalid or an empty string.  
-  
--   The target specified in the <paramref name="context" /> parameter does not match the server type specified in the <paramref name="sourceServer" /> parameter. The servers must both be either domain controllers or AD LDS instances.  
-  
--   The servers specified in the <paramref name="context" /> and <paramref name="sourceServer" /> parameters are domain controllers, but are not in the same forest.  
-  
--   The servers specified in the <paramref name="context" /> and <paramref name="sourceServer" /> parameters are AD LDS instances, but do not belong to the same configuration set.</exception>
+        <exception cref="T:System.ArgumentException">The target of the <paramref name="context" /> parameter is not a domain controller or AD LDS instance.
+
+-or-
+
+<paramref name="sourceServer" /> is invalid or an empty string.
+
+-or-
+
+The target specified in the <paramref name="context" /> parameter does not match the server type specified in the <paramref name="sourceServer" /> parameter. The servers must both be either domain controllers or AD LDS instances.
+
+-or-
+
+The servers specified in the <paramref name="context" /> and <paramref name="sourceServer" /> parameters are domain controllers, but are not in the same forest.
+
+-or-
+
+The servers specified in the <paramref name="context" /> and <paramref name="sourceServer" /> parameters are AD LDS instances, but do not belong to the same configuration set.</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="context" /> or <paramref name="sourceServer" /> is <see langword="null" />.</exception>
         <exception cref="T:System.Security.Authentication.AuthenticationException">The credentials that were supplied are not valid.</exception>
@@ -217,17 +235,23 @@
         <remarks>To be added.</remarks>
         <exception cref="T:System.DirectoryServices.ActiveDirectory.ActiveDirectoryOperationException">A call to the underlying directory service resulted in an error.</exception>
         <exception cref="T:System.DirectoryServices.ActiveDirectory.ActiveDirectoryServerDownException">The target server is either busy or unavailable.</exception>
-        <exception cref="T:System.ArgumentException">This exception will occur for any one of the following reasons:  
-  
--   The target of the <paramref name="context" /> parameter is not a domain controller or AD LDS instance.  
-  
--   <paramref name="sourceServer" /> is invalid or an empty string.  
-  
--   The target specified in the <paramref name="context" /> parameter does not match the server type specified in the <paramref name="sourceServer" /> parameter. The servers must both be either domain controllers or AD LDS instances.  
-  
--   The servers specified in the <paramref name="context" /> and <paramref name="sourceServer" /> parameters are domain controllers, but are not in the same forest.  
-  
--   The servers specified in the <paramref name="context" /> and <paramref name="sourceServer" /> parameters are AD LDS instances, but do not belong to the same configuration set.</exception>
+        <exception cref="T:System.ArgumentException">The target of the <paramref name="context" /> parameter is not a domain controller or AD LDS instance.
+
+-or-
+
+<paramref name="sourceServer" /> is invalid or an empty string.
+
+-or-
+
+The target specified in the <paramref name="context" /> parameter does not match the server type specified in the <paramref name="sourceServer" /> parameter. The servers must both be either domain controllers or AD LDS instances.
+
+-or-
+
+The servers specified in the <paramref name="context" /> and <paramref name="sourceServer" /> parameters are domain controllers, but are not in the same forest.
+
+-or-
+
+The servers specified in the <paramref name="context" /> and <paramref name="sourceServer" /> parameters are AD LDS instances, but do not belong to the same configuration set.</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="context" />, <paramref name="sourceServer" /> or <paramref name="schedule" /> is <see langword="null" />.</exception>
         <exception cref="T:System.Security.Authentication.AuthenticationException">The credentials that were supplied are not valid.</exception>