Merge pull request #3623 from dotnet/master

Update live with current master

Author: BillWagner

xml/System.Buffers/ReadOnlySpanAction`2.xml

@@ -32,11 +32,11 @@
     <ReturnType>System.Void</ReturnType>
   </ReturnValue>
   <Docs>
-    <typeparam name="T">To be added.</typeparam>
-    <typeparam name="TArg">To be added.</typeparam>
-    <param name="span">To be added.</param>
-    <param name="arg">To be added.</param>
-    <summary>To be added.</summary>
+    <typeparam name="T">The type of the objects in the read-only span.</typeparam>
+    <typeparam name="TArg">The type of the object that represents the state.</typeparam>
+    <param name="span">A read-only span of objects of type <typeparamref name="T" />.</param>
+    <param name="arg">A state object of type <typeparamref name="TArg" />.</param>
+    <summary>Encapsulates a method that receives a read-only span of objects of type <typeparamref name="T" /> and a state object of type <typeparamref name="TArg" />.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Type>

xml/System.Buffers/SpanAction`2.xml

@@ -32,11 +32,11 @@
     <ReturnType>System.Void</ReturnType>
   </ReturnValue>
   <Docs>
-    <typeparam name="T">To be added.</typeparam>
-    <typeparam name="TArg">To be added.</typeparam>
-    <param name="span">To be added.</param>
-    <param name="arg">To be added.</param>
-    <summary>To be added.</summary>
+    <typeparam name="T">The type of the objects in the span.</typeparam>
+    <typeparam name="TArg">The type of the object that represents the state.</typeparam>
+    <param name="span">A span of objects of type <typeparamref name="T" />.</param>
+    <param name="arg">A state object of type <typeparamref name="TArg" />.</param>
+    <summary>Encapsulates a method that receives a span of objects of type <typeparamref name="T" /> and a state object of type <typeparamref name="TArg" />.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Type>

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

@@ -3618,9 +3618,12 @@ Public Function StartsWith(e As Employee) As Boolean
    
   
 ## Examples  
+
+ [!INCLUDE[interactive-note](~/includes/csharp-interactive-note-some.md)]
+ 
  The following example adds some names to a `List<String>` object, displays the list in unsorted order, calls the <xref:System.Collections.Generic.List%601.Sort%2A> method, and then displays the sorted list.  
   
- [!code-csharp[System.Collections.Generic.List.Sort#2](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.collections.generic.list.sort/cs/Sort1.cs#2)]
+ [!code-csharp-interactive[System.Collections.Generic.List.Sort#2](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.collections.generic.list.sort/cs/Sort1.cs#2)]
  [!code-vb[System.Collections.Generic.List.Sort#2](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.collections.generic.list.sort/vb/Sort1.vb#2)]  
   
  The following code demonstrates the <xref:System.Collections.Generic.List%601.Sort> and <xref:System.Collections.Generic.List%601.Sort%28System.Comparison%7B%600%7D%29> method overloads on a simple business object. Calling the <xref:System.Collections.Generic.List%601.Sort> method results in the use of the default comparer for the Part type, and the <xref:System.Collections.Generic.List%601.Sort%28System.Comparison%7B%600%7D%29> method is implemented by using an anonymous method.  
@@ -3633,7 +3636,7 @@ Public Function StartsWith(e As Employee) As Boolean
  The <xref:System.Collections.Generic.List%601.BinarySearch%28%600%29> method overload is then used to search for two strings that are not in the list, and the <xref:System.Collections.Generic.List%601.Insert%2A> method is used to insert them. The return value of the <xref:System.Collections.Generic.List%601.BinarySearch%2A> method is negative in each case, because the strings are not in the list. Taking the bitwise complement (the ~ operator in C# and Visual C++, `Xor` -1 in Visual Basic) of this negative number produces the index of the first element in the list that is larger than the search string, and inserting at this location preserves the sort order. The second search string is larger than any element in the list, so the insertion position is at the end of the list.  
   
  [!code-cpp[List\`1_SortSearch#1](~/samples/snippets/cpp/VS_Snippets_CLR/List`1_SortSearch/cpp/source.cpp#1)]
- [!code-csharp[List\`1_SortSearch#1](~/samples/snippets/csharp/VS_Snippets_CLR/List`1_SortSearch/cs/source.cs#1)]
+ [!code-csharp-interactive[List\`1_SortSearch#1](~/samples/snippets/csharp/VS_Snippets_CLR/List`1_SortSearch/cs/source.cs#1)]
  [!code-vb[List\`1_SortSearch#1](~/samples/snippets/visualbasic/VS_Snippets_CLR/List`1_SortSearch/vb/source.vb#1)]  
   
  ]]></format>

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

@@ -1379,7 +1379,14 @@
       <Docs>
         <summary>Gets the maximum value in the <see cref="T:System.Collections.Generic.SortedSet`1" />, as defined by the comparer.</summary>
         <value>The maximum value in the set.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[  
+  
+## Remarks
+ If the <xref:System.Collections.Generic.SortedSet%601> has no elements, then the <xref:System.Collections.Generic.SortedSet%601.Max%2A> property returns the default value of `T`.
+
+ ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="Min">
@@ -1413,7 +1420,14 @@
       <Docs>
         <summary>Gets the minimum value in the <see cref="T:System.Collections.Generic.SortedSet`1" />, as defined by the comparer.</summary>
         <value>The minimum value in the set.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[  
+  
+## Remarks
+ If the <xref:System.Collections.Generic.SortedSet%601> has no elements, then the <xref:System.Collections.Generic.SortedSet%601.Min%2A> property returns the default value of `T`.
+
+ ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="OnDeserialization">

xml/System.Diagnostics/Process.xml

@@ -4723,8 +4723,10 @@ 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 in the <see cref="T:System.Diagnostics.Process" /> component's <see cref="P:System.Diagnostics.Process.StartInfo" />.
- -or-
- The <see cref="P:System.Diagnostics.ProcessStartInfo.UseShellExecute" /> member of the <see cref="P:System.Diagnostics.Process.StartInfo" /> property is <see langword="true" /> while <see cref="P:System.Diagnostics.ProcessStartInfo.RedirectStandardInput" />, <see cref="P:System.Diagnostics.ProcessStartInfo.RedirectStandardOutput" />, or <see cref="P:System.Diagnostics.ProcessStartInfo.RedirectStandardError" /> is <see langword="true" />.</exception>
+
+-or-
+
+The <see cref="P:System.Diagnostics.ProcessStartInfo.UseShellExecute" /> member of the <see cref="P:System.Diagnostics.Process.StartInfo" /> property is <see langword="true" /> while <see cref="P:System.Diagnostics.ProcessStartInfo.RedirectStandardInput" />, <see cref="P:System.Diagnostics.ProcessStartInfo.RedirectStandardOutput" />, or <see cref="P:System.Diagnostics.ProcessStartInfo.RedirectStandardError" /> is <see langword="true" />.</exception>
         <exception cref="T:System.ComponentModel.Win32Exception">There was an error in opening the associated file.</exception>
         <exception cref="T:System.ObjectDisposedException">The process object has already been disposed.</exception>
         <exception cref="T:System.PlatformNotSupportedException">Method not supported on operating systems without shell support such as Nano Server (.NET Core only).</exception>

xml/System.IO/StringReader.xml

@@ -461,10 +461,11 @@ This implementation of `Close` calls the <xref:System.IO.StringReader.Dispose%2A
         <Parameter Name="buffer" Type="System.Span&lt;System.Char&gt;" Index="0" FrameworkAlternate="netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <param name="buffer">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="buffer">When this method returns, contains the characters read from the current source. If the total number of characters read is zero, the span remains unmodified.</param>
+        <summary>Reads all the characters from the input string, starting at the current position, and advances the current position to the end of the input string.</summary>
+        <returns>The total number of characters read into the buffer.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ObjectDisposedException">The current string reader instance is closed.</exception>
       </Docs>
     </Member>
     <Member MemberName="Read">
@@ -577,10 +578,10 @@ This implementation of `Close` calls the <xref:System.IO.StringReader.Dispose%2A
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" Index="1" FrameworkAlternate="netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <param name="buffer">To be added.</param>
-        <param name="cancellationToken">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="buffer">When this method returns, contains the characters read from the current source.</param>
+        <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None" />.</param>
+        <summary>Asynchronously reads all the characters from the input string, starting at the current position, and advances the current position to the end of the input string.</summary>
+        <returns>A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains the total number of characters read into the buffer.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -686,10 +687,19 @@ This implementation of `Close` calls the <xref:System.IO.StringReader.Dispose%2A
         <Parameter Name="buffer" Type="System.Span&lt;System.Char&gt;" Index="0" FrameworkAlternate="netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <param name="buffer">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="buffer">When this method returns, contains the characters read from the current source. If the total number of characters read is zero, the span remains unmodified.</param>
+        <summary>Reads all the characters from the input string starting at the current position and advances the current position to the end of the input string.</summary>
+        <returns>The total number of characters read into the buffer.</returns>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+<xref:System.IO.StringReader.ReadBlock(System.Span{System.Char})> internally calls <xref:System.IO.StringReader.Read(System.Span{System.Char})> directly.
+
+          ]]></format>
+        </remarks>
+        <exception cref="T:System.ObjectDisposedException">The current string reader instance is closed.</exception>
       </Docs>
     </Member>
     <Member MemberName="ReadBlockAsync">
@@ -720,11 +730,20 @@ This implementation of `Close` calls the <xref:System.IO.StringReader.Dispose%2A
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" Index="1" FrameworkAlternate="netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <param name="buffer">To be added.</param>
-        <param name="cancellationToken">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="buffer">When this method returns, contains the characters read from the current source. If the total number of characters read is zero, the span remains unmodified.</param>
+        <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None" />.</param>
+        <summary>Asynchronously reads all the characters from the input string starting at the current position and advances the current position to the end of the input string.</summary>
+        <returns>A task representing the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains the total number of characters read into the buffer.</returns>
+        <remarks>
+          <format type="text/markdown">
+  <![CDATA[
+
+## Remarks
+
+<xref:System.IO.StringReader.ReadBlockAsync(System.Memory{System.Char},System.Threading.CancellationToken)> calls <xref:System.IO.StringReader.ReadBlock(System.Span{System.Char})> asynchronously, which in turn calls <xref:System.IO.StringReader.Read(System.Span{System.Char})> directly.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="ReadBlockAsync">

xml/System.Linq/ParallelEnumerable.xml

@@ -10268,14 +10268,14 @@
       <Docs>
         <typeparam name="TSource">The type of elements of <paramref name="source" />.</typeparam>
         <param name="source">A ParallelQuery on which to set the limit on the degrees of parallelism.</param>
-        <param name="degreeOfParallelism">The degree of parallelism for the query. The default value is Math.Min(<see cref="P:System.Environment.ProcessorCount" />, <see langword="MAX_SUPPORTED_DOP" />) where <see langword="MAX_SUPPORTED_DOP" /> is 512.</param>
+        <param name="degreeOfParallelism">The degree of parallelism for the query.</param>
         <summary>Sets the degree of parallelism to use in a query. Degree of parallelism is the maximum number of concurrently executing tasks that will be used to process the query.</summary>
         <returns>ParallelQuery representing the same query as source, with the limit on the degrees of parallelism set.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="source" /> is a null reference (Nothing in Visual Basic).</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
-          <paramref name="degreeOfParallelism" /> is less than 1 or greater than 511.</exception>
+          <paramref name="degreeOfParallelism" /> is less than 1 or greater than 512.</exception>
         <exception cref="T:System.InvalidOperationException">WithDegreeOfParallelism is used multiple times in the query.</exception>
         <related type="Article" href="~/docs/standard/parallel-programming/parallel-linq-plinq.md">Parallel LINQ (PLINQ)</related>
       </Docs>

xml/System/Array.xml

@@ -92,6 +92,9 @@
 
 
 ## Examples  
+
+ [!INCLUDE[interactive-note](~/includes/csharp-interactive-note-some.md)]
+ 
  The following code example shows how <xref:System.Array.Copy%2A?displayProperty=nameWithType> copies elements between an array of type integer and an array of type <xref:System.Object>.  
 
  [!code-cpp[Classic Array Example#1](~/samples/snippets/cpp/VS_Snippets_CLR_Classic/classic Array Example/CPP/source.cpp#1)]
@@ -101,7 +104,7 @@
  The following code example creates and initializes an <xref:System.Array> and displays its properties and its elements.  
 
  [!code-cpp[Classic Array Example#2](~/samples/snippets/cpp/VS_Snippets_CLR_Classic/classic Array Example/CPP/source3.cpp#2)]
- [!code-csharp[Classic Array Example#2](~/samples/snippets/csharp/VS_Snippets_CLR_Classic/classic Array Example/CS/source3.cs#2)]
+ [!code-csharp-interactive[Classic Array Example#2](~/samples/snippets/csharp/VS_Snippets_CLR_Classic/classic Array Example/CS/source3.cs#2)]
  [!code-vb[Classic Array Example#2](~/samples/snippets/visualbasic/VS_Snippets_CLR_Classic/classic Array Example/VB/source3.vb#2)]  
 
  ]]></format>

xml/System/Object.xml

@@ -762,22 +762,25 @@ and the <xref:System.IDisposable> interface. The <xref:System.IDisposable.Dispos
   
  For two objects `x` and `y` that have identical runtime types, `Object.ReferenceEquals(x.GetType(),y.GetType())` returns `true`. The following example uses the <xref:System.Object.GetType%2A> method with the <xref:System.Object.ReferenceEquals%2A> method to determine whether one numeric value is the same type as two other numeric values.  
   
- [!code-csharp[System.Object.GetType#1](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.object.gettype/cs/gettype1.cs#1)]
+ [!code-csharp-interactive[System.Object.GetType#1](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.object.gettype/cs/gettype1.cs#1)]
  [!code-vb[System.Object.GetType#1](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.object.gettype/vb/gettype1.vb#1)]  
   
 > [!NOTE]
 >  To determine whether an object is a specific type, you can use your language's type comparison keyword or construct. For example, you can use the `TypeOf…Is` construct in Visual Basic or the `is` keyword in C#.  
   
  The <xref:System.Object.GetType%2A> method is inherited by all types that derive from <xref:System.Object>. This means that, in addition to using your own language's comparison keyword, you can use the <xref:System.Object.GetType%2A> method to determine the type of a particular object, as the following example shows.  
   
- [!code-csharp[System.Object.GetType#2](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.object.gettype/cs/GetTypeEx2.cs#2)]
+ [!code-csharp-interactive[System.Object.GetType#2](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.object.gettype/cs/GetTypeEx2.cs#2)]
  [!code-vb[System.Object.GetType#2](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.object.gettype/vb/GetTypeEx2.vb#2)]  
   
  The <xref:System.Type> object exposes the metadata associated with the class of the current <xref:System.Object>.  
   
    
   
 ## Examples  
+
+ [!INCLUDE[interactive-note](~/includes/csharp-interactive-note-some.md)]
+
  The following code example demonstrates that <xref:System.Object.GetType%2A> returns the runtime type of the current instance.  
   
  [!code-cpp[ECMA-System.Object.GetType#1](~/samples/snippets/cpp/VS_Snippets_CLR/ECMA-System.Object.GetType/CPP/gettype.cpp#1)]