Merge pull request #3416 from dotnet/master

Update live with current master

Author: BillWagner

xml/Microsoft.VisualBasic.ApplicationServices/AssemblyInfo.xml

@@ -407,7 +407,6 @@
   
  ]]></format>
         </remarks>
-        <altCompliant cref="None." />
         <exception cref="T:System.AppDomainUnloadedException">The application domain is not loaded.</exception>
         <altmember cref="P:Microsoft.VisualBasic.ApplicationServices.ApplicationBase.Info" />
         <altmember cref="T:System.Collections.ObjectModel.ReadOnlyCollection`1" />

xml/Microsoft.VisualBasic.ApplicationServices/WindowsFormsApplicationBase.xml

@@ -669,7 +669,6 @@
   
  ]]></format>
         </remarks>
-        <altCompliant cref="None." />
         <altmember cref="P:Microsoft.VisualBasic.ApplicationServices.WindowsFormsApplicationBase.EnableVisualStyles" />
         <altmember cref="M:Microsoft.VisualBasic.ApplicationServices.WindowsFormsApplicationBase.ShowSplashScreen" />
         <altmember cref="M:Microsoft.VisualBasic.ApplicationServices.WindowsFormsApplicationBase.OnCreateSplashScreen" />

xml/Microsoft.VisualBasic.Devices/Ports.xml

@@ -630,7 +630,6 @@
   
  ]]></format>
         </remarks>
-        <altCompliant cref="None." />
         <altmember cref="Overload:Microsoft.VisualBasic.Devices.Ports.OpenSerialPort" />
         <altmember cref="T:System.Collections.ObjectModel.ReadOnlyCollection`1" />
         <related type="Article" href="~/docs/visual-basic/language-reference/objects/index.md">Objects (Visual Basic)</related>

xml/Microsoft.VisualBasic.FileIO/FileSystem.xml

@@ -1452,7 +1452,6 @@
   
  ]]></format>
         </remarks>
-        <altCompliant cref="None" />
         <permission cref="T:System.Security.Permissions.FileIOPermission">Controls the ability to access files and folders. Associated enumeration: <see cref="F:System.Security.Permissions.PermissionState.Unrestricted" />.</permission>
         <altmember cref="T:System.Collections.ObjectModel.ReadOnlyCollection`1" />
         <altmember cref="T:System.IO.DriveInfo" />
@@ -1577,7 +1576,6 @@
   
  ]]></format>
         </remarks>
-        <altCompliant cref="None." />
         <exception cref="T:System.ArgumentException">The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with <c>\\.\</c>).</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="directory" /> is <see langword="Nothing" /> or an empty string.</exception>
@@ -1658,7 +1656,6 @@
   
  ]]></format>
         </remarks>
-        <altCompliant cref="None." />
         <exception cref="T:System.ArgumentException">The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with <c>\\.\</c>).</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="directory" /> is <see langword="Nothing" /> or an empty string.</exception>
@@ -1736,7 +1733,6 @@
   
  ]]></format>
         </remarks>
-        <altCompliant cref="None." />
         <exception cref="T:System.ArgumentException">The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\\\.\\).</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="directory" /> is <see langword="Nothing" /> or an empty string.</exception>
@@ -1819,7 +1815,6 @@
   
  ]]></format>
         </remarks>
-        <altCompliant cref="None." />
         <exception cref="T:System.ArgumentException">The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\\\.\\).</exception>
         <exception cref="T:System.ArgumentNullException">One or more of the specified wildcard characters is <see langword="Nothing" />, an empty string, or contains only spaces.</exception>
         <exception cref="T:System.IO.DirectoryNotFoundException">The specified directory does not exist.</exception>
@@ -2077,7 +2072,6 @@
   
  ]]></format>
         </remarks>
-        <altCompliant cref="None." />
         <exception cref="T:System.ArgumentException">The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\\\.\\).</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="directory" /> is <see langword="Nothing" />.</exception>
@@ -2165,7 +2159,6 @@
   
  ]]></format>
         </remarks>
-        <altCompliant cref="None." />
         <exception cref="T:System.ArgumentException">The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\\\.\\).</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="directory" /> is <see langword="Nothing" />.</exception>

xml/Microsoft.VisualBasic.MyServices.Internal/ContextValue`1.xml

@@ -35,7 +35,6 @@
   
  ]]></format>
     </remarks>
-    <altCompliant cref="None" />
     <forInternalUseOnly />
     <related type="Article" href="https://msdn.microsoft.com/library/f1d04509-5e46-4551-9f9f-94334a121fca">Development with My</related>
   </Docs>

xml/Microsoft.VisualBasic.MyServices/FileSystemProxy.xml

@@ -1432,7 +1432,6 @@
   
  ]]></format>
         </remarks>
-        <altCompliant cref="None." />
         <permission cref="T:System.Security.Permissions.FileIOPermission">Controls the ability to access files and folders. Associated enumeration: <see cref="F:System.Security.Permissions.PermissionState.Unrestricted" />.</permission>
         <altmember cref="T:System.Collections.ObjectModel.ReadOnlyCollection`1" />
         <altmember cref="T:System.IO.DriveInfo" />
@@ -1554,7 +1553,6 @@
   
  ]]></format>
         </remarks>
-        <altCompliant cref="None." />
         <exception cref="T:System.ArgumentException">The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with <c>\\.\</c>).</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="directory" /> is <see langword="Nothing" /> or an empty string.</exception>
@@ -1636,7 +1634,6 @@
   
  ]]></format>
         </remarks>
-        <altCompliant cref="None." />
         <exception cref="T:System.ArgumentException">The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with <c>\\.\</c>).</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="directory" /> is <see langword="Nothing" /> or an empty string.</exception>
@@ -1710,7 +1707,6 @@
   
  ]]></format>
         </remarks>
-        <altCompliant cref="None." />
         <exception cref="T:System.ArgumentException">The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\\\.\\).</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="directory" /> is <see langword="Nothing" /> or an empty string.</exception>
@@ -1788,7 +1784,6 @@
   
  ]]></format>
         </remarks>
-        <altCompliant cref="None." />
         <exception cref="T:System.ArgumentException">The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\\\.\\).</exception>
         <exception cref="T:System.ArgumentNullException">One or more of the specified wildcard characters is <see langword="Nothing" />, an empty string, or contains only spaces.</exception>
         <exception cref="T:System.IO.DirectoryNotFoundException">The specified directory does not exist.</exception>
@@ -2042,7 +2037,6 @@
   
  ]]></format>
         </remarks>
-        <altCompliant cref="None." />
         <exception cref="T:System.ArgumentException">The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\\\.\\).</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="directory" /> is <see langword="Nothing" />.</exception>
@@ -2127,7 +2121,6 @@
   
  ]]></format>
         </remarks>
-        <altCompliant cref="None." />
         <exception cref="T:System.ArgumentException">The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\\\.\\).</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="directory" /> is <see langword="Nothing" />.</exception>

xml/System.Collections.Generic/List`1.xml

@@ -3605,7 +3605,7 @@ Public Function StartsWith(e As Employee) As Boolean
   
  This method uses the <xref:System.Array.Sort%2A?displayProperty=nameWithType> method, which applies the introspective sort as follows:  
   
--   If the partition size is fewer than 16 elements, it uses an insertion sort algorithm.  
+-   If the partition size is less than or equal to 16 elements, it uses an insertion sort algorithm.  
   
 -   If the number of partitions exceeds 2 log *n*, where *n* is the range of the input array, it uses a Heapsort algorithm.  
   
@@ -3687,7 +3687,7 @@ Public Function StartsWith(e As Employee) As Boolean
   
  This method uses the <xref:System.Array.Sort%2A?displayProperty=nameWithType> method, which applies the introspective sort as follows:  
   
--   If the partition size is fewer than 16 elements, it uses an insertion sort algorithm.  
+-   If the partition size is less than or equal to 16 elements, it uses an insertion sort algorithm.  
   
 -   If the number of partitions exceeds 2 log *n*, where *n* is the range of the input array, it uses a Heapsort algorithm.  
   
@@ -3765,7 +3765,7 @@ Public Function StartsWith(e As Employee) As Boolean
   
  This method uses <xref:System.Array.Sort%2A?displayProperty=nameWithType>, which applies the introspective sort as follows:  
   
--   If the partition size is fewer than 16 elements, it uses an insertion sort algorithm  
+-   If the partition size is less than or equal to 16 elements, it uses an insertion sort algorithm  
   
 -   If the number of partitions exceeds 2 log *n*, where *n* is the range of the input array, it uses a [Heapsort](https://en.wikipedia.org/wiki/Heapsort) algorithm.  
   
@@ -3851,7 +3851,7 @@ Public Function StartsWith(e As Employee) As Boolean
   
  This method uses <xref:System.Array.Sort%2A?displayProperty=nameWithType>, which applies the introspective sort as follows:  
   
--   If the partition size is fewer than 16 elements, it uses an insertion sort algorithm  
+-   If the partition size is less than or equal to 16 elements, it uses an insertion sort algorithm  
   
 -   If the number of partitions exceeds 2 log *n*, where *n* is the range of the input array, it uses a [Heapsort](https://en.wikipedia.org/wiki/Heapsort) algorithm.  
   

xml/System.Data.Common/DbCommand.xml

@@ -206,7 +206,7 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>When overridden in a derived class, gets or sets the wait time before terminating the attempt to execute a command and generating an error.</summary>
+        <summary>When overridden in a derived class, gets or sets the wait time (in seconds) before terminating the attempt to execute a command and generating an error.</summary>
         <value>The time in seconds to wait for the command to execute.</value>
         <remarks>
           <format type="text/markdown"><![CDATA[  

xml/System.Data.Common/DbConnection.xml

@@ -640,7 +640,7 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets the time to wait while establishing a connection before terminating the attempt and generating an error.</summary>
+        <summary>Gets the time to wait (in seconds) while establishing a connection before terminating the attempt and generating an error.</summary>
         <value>The time (in seconds) to wait for a connection to open. The default value is determined by the specific type of connection that you are using.</value>
         <remarks>To be added.</remarks>
         <related type="Article" href="~/docs/framework/data/adonet/ado-net-overview.md">ADO.NET Overview</related>

xml/System.Data.Common/DbProviderFactories.xml

@@ -251,8 +251,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Returns the invariant provider names for all registered instances of <see cref="T:System.Data.Common.DbProviderFactory" />.</summary>
+        <returns>The invariant provider names for all registered instances of <see cref="T:System.Data.Common.DbProviderFactory" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -283,10 +283,10 @@
         <Parameter Name="factory" Type="System.Data.Common.DbProviderFactory" Index="1" FrameworkAlternate="netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <param name="providerInvariantName">To be added.</param>
-        <param name="factory">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="providerInvariantName">The invariant provider name under which to register the provider.</param>
+        <param name="factory">The instance of the provider factory to be registered.</param>
+        <summary>Registers an instance of <see cref="T:System.Data.Common.DbProviderFactory" /> under the specified invariant provider name.</summary>
+        <remarks>If a provider is already registered under <paramref name="providerInvariantName" />, that registration will be overwritten.</remarks>
       </Docs>
     </Member>
     <Member MemberName="RegisterFactory">
@@ -316,10 +316,10 @@
         <Parameter Name="factoryTypeAssemblyQualifiedName" Type="System.String" Index="1" FrameworkAlternate="netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <param name="providerInvariantName">To be added.</param>
-        <param name="factoryTypeAssemblyQualifiedName">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="providerInvariantName">The invariant provider name under which to register the provider.</param>
+        <param name="factoryTypeAssemblyQualifiedName">The assembly-qualified name for a <see cref="T:System.Data.Common.DbProviderFactory" />.</param>
+        <summary>Registers a <see cref="T:System.Data.Common.DbProviderFactory" /> with the given assembly-qualified name under the specified invariant provider name.</summary>
+        <remarks>If a provider is already registered under <paramref name="providerInvariantName" />, that registration will be overwritten.</remarks>
       </Docs>
     </Member>
     <Member MemberName="RegisterFactory">
@@ -349,10 +349,10 @@
         <Parameter Name="providerFactoryClass" Type="System.Type" Index="1" FrameworkAlternate="netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <param name="providerInvariantName">To be added.</param>
-        <param name="providerFactoryClass">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="providerInvariantName">The invariant provider name under which to register the provider.</param>
+        <param name="providerFactoryClass">The type representing a <see cref="T:System.Data.Common.DbProviderFactory" />.</param>
+        <summary>Registers a <see cref="T:System.Data.Common.DbProviderFactory" /> with the given type under the specified invariant provider name.</summary>
+        <remarks>If a provider is already registered under <paramref name="providerInvariantName" />, that registration will be overwritten.</remarks>
       </Docs>
     </Member>
     <Member MemberName="TryGetFactory">
@@ -382,10 +382,11 @@
         <Parameter Name="factory" Type="System.Data.Common.DbProviderFactory" RefType="out" Index="1" FrameworkAlternate="netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <param name="providerInvariantName">To be added.</param>
-        <param name="factory">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="providerInvariantName">The invariant provider name to look up.</param>
+        <param name="factory">When this method returns, contains the <see cref="T:System.Data.Common.DbProviderFactory" /> associated with the specified invariant provider name, if the name is found; otherwise, <see langword="null" />. This parameter is passed uninitialized.</param>
+        <summary>Attempts to get the <see cref="T:System.Data.Common.DbProviderFactory" /> registered under the specified invariant provider name.</summary>
+        <returns>
+          <see langword="true" /> if a provider is registered under the specified invariant provider name; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -415,9 +416,10 @@
         <Parameter Name="providerInvariantName" Type="System.String" Index="0" FrameworkAlternate="netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <param name="providerInvariantName">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="providerInvariantName">The invariant provider name of the registration to remove.</param>
+        <summary>Removes a <see cref="T:System.Data.Common.DbProviderFactory" /> registration for the given provider invariant name.</summary>
+        <returns>
+          <see langword="true" /> if the registration is successfully found and removed; otherwise, <see langword="false" />. This method returns <see langword="false" /> if a registration for <paramref name="providerInvariantName" /> is not found.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>