Merge pull request #3428 from dotnet/master

Update live with current master

Author: mairaw

xml/System.Data.Common/DbDataReader.xml

@@ -308,7 +308,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 managed resources used by the <see cref="T:System.Data.Common.DbDataReader" /> and optionally releases the unmanaged resources.</summary>
+        <summary>Releases the unmanaged resources used by the <see cref="T:System.Data.Common.DbDataReader" /> and optionally releases the managed resources.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   

xml/System.Data.SqlClient/SqlDataReader.xml

@@ -246,17 +246,18 @@
         <Parameter Name="disposing" Type="System.Boolean" Index="0" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0" />
       </Parameters>
       <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 managed resources used by the <see cref="T:System.Data.SqlClient.SqlDataReader" /> and optionally releases the unmanaged resources.</summary>
+        <param name="disposing"><see langword="true" /> to release managed and unmanaged resources; <see langword="false" /> to release only unmanaged resources.</param>
+        <summary>Releases the unmanaged resources used by the <see cref="T:System.Data.SqlClient.SqlDataReader" /> and optionally releases the managed resources.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[
-
+              
 ## Remarks
- This method calls <xref:System.Data.SqlClient.SqlDataReader.Close%2A>.
 
-]]></format>
+This method calls <xref:System.Data.Common.DbDataReader.Dispose%2A>.
+
+  ]]></format>
         </remarks>
+        <related type="Article" href="~/docs/framework/data/adonet/ado-net-overview.md">ADO.NET Overview</related>
       </Docs>
     </Member>
     <Member MemberName="FieldCount">
@@ -664,9 +665,17 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Gets the column schema (<see cref="T:System.Data.Common.DbColumn" /> collection).</summary>
-        <returns>The column schema (<see cref="T:System.Data.Common.DbColumn" /> collection).</returns>
-        <remarks>To be added.</remarks>
+        <summary>Gets the read-only column schema collection.</summary>
+        <returns>The read-only column schema collection.</returns>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+  
+## Remarks
+
+This method is an implementation of <xref:System.Data.Common.IDbColumnSchemaGenerator.GetColumnSchema?displayProperty=nameWithType> method, which enables the use of the <xref:System.Data.Common.IDbColumnSchemaGenerator> interface to populate the <xref:System.Data.Common.DbColumn> schema metadata without using a <xref:System.Data.DataTable>.
+
+ ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="GetData">

xml/System.Diagnostics/Process.xml

@@ -4917,7 +4917,11 @@ There is a similar issue when you read all text from both the standard output an
 
  ]]></format>
         </remarks>
-        <exception cref="T:System.ComponentModel.Win32Exception">An error occurred when opening the associated file.</exception>
+        <exception cref="T:System.ComponentModel.Win32Exception">An error occurred when opening the associated file.
+
+-or-
+
+The file specified in the <paramref name="fileName" /> could not be found.</exception>
         <exception cref="T:System.ObjectDisposedException">The process object has already been disposed.</exception>
         <exception cref="T:System.IO.FileNotFoundException">The PATH environment variable has a string containing quotes.</exception>
         <permission cref="F:System.Security.Permissions.SecurityAction.LinkDemand">for full trust for the immediate caller. This member cannot be used by partially trusted code.</permission>
@@ -5002,6 +5006,10 @@ There is a similar issue when you read all text from both the standard output an
         </remarks>
         <exception cref="T:System.InvalidOperationException">The <paramref name="fileName" /> or <paramref name="arguments" /> parameter is <see langword="null" />.</exception>
         <exception cref="T:System.ComponentModel.Win32Exception">An error occurred when opening the associated file.  
+
+-or-
+
+The file specified in the <paramref name="fileName" /> could not be found.
 
  -or-  
 
@@ -5093,7 +5101,11 @@ There is a similar issue when you read all text from both the standard output an
  ]]></format>
         </remarks>
         <exception cref="T:System.InvalidOperationException">No file name was specified.</exception>
-        <exception cref="T:System.ComponentModel.Win32Exception">There was an error in opening the associated file.</exception>
+        <exception cref="T:System.ComponentModel.Win32Exception">There was an error in opening the associated file.
+
+-or-
+
+The file specified in the <paramref name="fileName" /> could not be found.</exception>
         <exception cref="T:System.ObjectDisposedException">The process object has already been disposed.</exception>
         <exception cref="T:System.PlatformNotSupportedException">This member is not supported on Linux or macOS (.NET Core only).</exception>
         <permission cref="F:System.Security.Permissions.SecurityAction.LinkDemand">for full trust for the immediate caller. This member cannot be used by partially trusted code.</permission>
@@ -5171,6 +5183,10 @@ There is a similar issue when you read all text from both the standard output an
         </remarks>
         <exception cref="T:System.InvalidOperationException">No file name was specified.</exception>
         <exception cref="T:System.ComponentModel.Win32Exception">An error occurred when opening the associated file.  
+
+-or-
+
+The file specified in the <paramref name="fileName" /> could not be found.
 
  -or-  
 

xml/System.Diagnostics/ProcessStartInfo.xml

@@ -1341,9 +1341,16 @@ You can use asynchronous read operations to avoid these dependencies and their d
         <ReturnType>System.Text.Encoding</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <summary>Gets or sets the preferred encoding for standard input.</summary>
+        <value>An object that represents the preferred encoding for standard input. The default is <see langword="null" />.</value>
+        <remarks>
+          <format type="text/markdown"><![CDATA[  
+  
+## Remarks  
+ If the value of the `StandardInputEncoding` property is `null`, the process uses the default standard input encoding for the standard input. The `StandardInputEncoding` property must be set before the process is started. Setting this property does not guarantee that the process will use the specified encoding. The application should be tested to determine which encodings the process supports.  
+  
+ ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="StandardOutputEncoding">

xml/System.IO/Directory.xml

@@ -538,7 +538,7 @@ Directory::CreateDirectory("Public\\Html");
         <AssemblyVersion>4.1.0.0</AssemblyVersion>
       </AssemblyInfo>
       <Docs>
-        <summary>Returns an enumerable collection of directory names that meet specified criteria.</summary>
+        <summary>Returns an enumerable collection of directory full names that meet specified criteria.</summary>
       </Docs>
     </MemberGroup>
     <Member MemberName="EnumerateDirectories">
@@ -574,7 +574,7 @@ Directory::CreateDirectory("Public\\Html");
       </Parameters>
       <Docs>
         <param name="path">The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
-        <summary>Returns an enumerable collection of directory names in a specified path.</summary>
+        <summary>Returns an enumerable collection of directory full names in a specified path.</summary>
         <returns>An enumerable collection of the full names (including paths) for the directories in the directory specified by <paramref name="path" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
@@ -644,7 +644,7 @@ Directory::CreateDirectory("Public\\Html");
       <Docs>
         <param name="path">The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
         <param name="searchPattern">The search string to match against the names of directories in <paramref name="path" />.  This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.</param>
-        <summary>Returns an enumerable collection of directory names that match a search pattern in a specified path.</summary>
+        <summary>Returns an enumerable collection of directory full names that match a search pattern in a specified path.</summary>
         <returns>An enumerable collection of the full names (including paths) for the directories in the directory specified by <paramref name="path" /> and that match the specified search pattern.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
@@ -771,7 +771,7 @@ Directory::CreateDirectory("Public\\Html");
         <param name="searchOption">One of the enumeration values that specifies whether the search operation should include only the current directory or should include all subdirectories.  
 
  The default value is <see cref="F:System.IO.SearchOption.TopDirectoryOnly" />.</param>
-        <summary>Returns an enumerable collection of directory names that match a search pattern in a specified path, and optionally searches subdirectories.</summary>
+        <summary>Returns an enumerable collection of directory full names that match a search pattern in a specified path, and optionally searches subdirectories.</summary>
         <returns>An enumerable collection of the full names (including paths) for the directories in the directory specified by <paramref name="path" /> and that match the specified search pattern and option.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
@@ -834,7 +834,7 @@ Directory::CreateDirectory("Public\\Html");
         <AssemblyVersion>4.1.0.0</AssemblyVersion>
       </AssemblyInfo>
       <Docs>
-        <summary>Returns an enumerable collection of file names that meet specified criteria.</summary>
+        <summary>Returns an enumerable collection of full file names that meet specified criteria.</summary>
       </Docs>
     </MemberGroup>
     <Member MemberName="EnumerateFiles">
@@ -870,7 +870,7 @@ Directory::CreateDirectory("Public\\Html");
       </Parameters>
       <Docs>
         <param name="path">The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
-        <summary>Returns an enumerable collection of file names in a specified path.</summary>
+        <summary>Returns an enumerable collection of full file names in a specified path.</summary>
         <returns>An enumerable collection of the full names (including paths) for the files in the directory specified by <paramref name="path" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
@@ -945,7 +945,7 @@ Directory::CreateDirectory("Public\\Html");
       <Docs>
         <param name="path">The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
         <param name="searchPattern">The search string to match against the names of files in <paramref name="path" />.  This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.</param>
-        <summary>Returns an enumerable collection of file names that match a search pattern in a specified path.</summary>
+        <summary>Returns an enumerable collection of full file names that match a search pattern in a specified path.</summary>
         <returns>An enumerable collection of the full names (including paths) for the files in the directory specified by <paramref name="path" /> and that match the specified search pattern.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
@@ -1085,7 +1085,7 @@ Directory::CreateDirectory("Public\\Html");
         <param name="searchOption">One of the enumeration values that specifies whether the search operation should include only the current directory or should include all subdirectories.  
 
  The default value is <see cref="F:System.IO.SearchOption.TopDirectoryOnly" />.</param>
-        <summary>Returns an enumerable collection of file names that match a search pattern in a specified path, and optionally searches subdirectories.</summary>
+        <summary>Returns an enumerable collection of full file names that match a search pattern in a specified path, and optionally searches subdirectories.</summary>
         <returns>An enumerable collection of the full names (including paths) for the files in the directory specified by <paramref name="path" /> and that match the specified search pattern and option.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[