Merge pull request #3487 from dotnet/master

Update live with current master

Author: mairaw

_zip/missingapi.yml

@@ -904,7 +904,7 @@ MsgBox("The formatted date is " & Format(Now, "dddd, d MMM yyyy"))
   
  ]]></format>
         </remarks>
-        <exception cref="T:System.InvalidCastException">Invalid format used to set the value of <see cref="T:Microsoft.VisualBasic.DateAndTime.DateString" />.</exception>
+        <exception cref="T:System.InvalidCastException">Invalid format used to set the value of <see cref="P:Microsoft.VisualBasic.DateAndTime.DateString" />.</exception>
         <altmember cref="P:Microsoft.VisualBasic.DateAndTime.Now" />
         <altmember cref="P:Microsoft.VisualBasic.DateAndTime.TimeString" />
         <altmember cref="P:Microsoft.VisualBasic.DateAndTime.Today" />

xml/Microsoft.VisualBasic/DateAndTime.xml

@@ -25,7 +25,7 @@
   <Interfaces />
   <Docs>
     <typeparam name="T">The type of the objects that are in the resource pool.</typeparam>
-    <summary>Provides a resource pool that enables reusing instances of type <see cref="T:T[]" />.</summary>
+    <summary>Provides a resource pool that enables reusing instances of type T[].</summary>
     <remarks>
       <format type="text/markdown"><![CDATA[  
   
@@ -168,7 +168,7 @@ The instance of the <xref:System.Buffers.ArrayPool%601> class created by this me
       <Docs>
         <param name="minimumLength">The minimum length of the array.</param>
         <summary>Retrieves a buffer that is at least the requested length.</summary>
-        <returns>An array of type <see cref="T:T[]" /> that is at least <paramref name="minimumLength" /> in length.</returns>
+        <returns>An array of type T that is at least <paramref name="minimumLength" /> in length.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   

xml/System.Buffers/ArrayPool`1.xml

@@ -19,9 +19,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>  
-  
- Provides methods for creating an array that is immutable; meaning it cannot be changed once it is created.  
+    <summary>Provides methods for creating an array that is immutable; meaning it cannot be changed once it is created.  
 
  **NuGet package**: <see href="https://www.nuget.org/packages/System.Collections.Immutable/">System.Collections.Immutable</see> (<see href="https://docs.microsoft.com/dotnet/api/system.collections.immutable?#remarks">about immutable collections and how to install</see>)</summary>
     <remarks>To be added.</remarks>
@@ -59,9 +57,7 @@
         <typeparam name="T">The type of element stored in the array.</typeparam>
         <param name="array">The sorted array to search.</param>
         <param name="value">The object to search for.</param>
-        <summary>  
-  
- Searches the sorted immutable array for a specified element using the default comparer and returns the zero-based index of the element, if it's found.</summary>
+        <summary>Searches the sorted immutable array for a specified element using the default comparer and returns the zero-based index of the element, if it's found.</summary>
         <returns>The zero-based index of the item in the array, if item is found; otherwise, a negative number that is the bitwise complement of the index of the next element that is larger than <paramref name="value" /> or, if there is no larger element, the bitwise complement of <see cref="P:System.Collections.Generic.ICollection`1.Count" />.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.InvalidOperationException">
@@ -101,9 +97,7 @@
         <param name="array">The sorted array to search.</param>
         <param name="value">The object to search for.</param>
         <param name="comparer">The comparer implementation to use when comparing elements, or null to use the default comparer.</param>
-        <summary>  
-  
- Searches a sorted immutable array for a specified element and returns the zero-based index of the element, if it's found.</summary>
+        <summary>Searches a sorted immutable array for a specified element and returns the zero-based index of the element, if it's found.</summary>
         <returns>The zero-based index of the item in the array, if item is found; otherwise, a negative number that is the bitwise complement of the index of the next element that is larger than <paramref name="value" /> or, if there is no larger element, the bitwise complement of <see cref="P:System.Collections.Generic.ICollection`1.Count" />.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.InvalidOperationException">
@@ -145,9 +139,7 @@
         <param name="index">The starting index of the range to search.</param>
         <param name="length">The length of the range to search.</param>
         <param name="value">The object to search for.</param>
-        <summary>  
-  
- Searches a sorted immutable array for a specified element and returns the zero-based index of the element, if it's found.</summary>
+        <summary>Searches a sorted immutable array for a specified element and returns the zero-based index of the element, if it's found.</summary>
         <returns>The zero-based index of the item in the array, if item is found; otherwise, a negative number that is the bitwise complement of the index of the next element that is larger than <paramref name="value" /> or, if there is no larger element, the bitwise complement of <see cref="P:System.Collections.Generic.ICollection`1.Count" />.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.InvalidOperationException">
@@ -199,9 +191,7 @@
         <param name="length">The length of the range to search.</param>
         <param name="value">The object to search for.</param>
         <param name="comparer">The comparer to use when comparing elements for equality or <see langword="null" /> to use the default comparer.</param>
-        <summary>  
-  
- Searches a sorted immutable array for a specified element and returns the zero-based index of the element.</summary>
+        <summary>Searches a sorted immutable array for a specified element and returns the zero-based index of the element.</summary>
         <returns>The zero-based index of the item in the array, if item is found; otherwise, a negative number that is the bitwise complement of the index of the next element that is larger than <paramref name="value" /> or, if there is no larger element, the bitwise complement of <see cref="P:System.Collections.Generic.ICollection`1.Count" />.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.InvalidOperationException">
@@ -246,9 +236,7 @@
       <Parameters />
       <Docs>
         <typeparam name="T">The type of elements stored in the array.</typeparam>
-        <summary>  
-  
- Creates an empty immutable array.</summary>
+        <summary>Creates an empty immutable array.</summary>
         <returns>An empty immutable array.</returns>
         <remarks>To be added.</remarks>
       </Docs>
@@ -282,9 +270,7 @@
       <Docs>
         <typeparam name="T">The type of elements stored in the array.</typeparam>
         <param name="item">The object to store in the array.</param>
-        <summary>  
-  
- Creates an immutable array that contains the specified object.</summary>
+        <summary>Creates an immutable array that contains the specified object.</summary>
         <returns>An immutable array that contains the specified object.</returns>
         <remarks>To be added.</remarks>
       </Docs>
@@ -324,9 +310,7 @@
       <Docs>
         <typeparam name="T">The type of elements stored in the array.</typeparam>
         <param name="items">The array of objects to populate the array with.</param>
-        <summary>  
-  
- Creates an immutable array from the specified array of objects.</summary>
+        <summary>Creates an immutable array from the specified array of objects.</summary>
         <returns>An immutable array that contains the array of items.</returns>
         <remarks>To be added.</remarks>
       </Docs>
@@ -362,9 +346,7 @@
         <typeparam name="T">The type of elements stored in the array.</typeparam>
         <param name="item1">The first object to store in the array.</param>
         <param name="item2">The second object to store in the array.</param>
-        <summary>  
-  
- Creates an immutable array that contains the specified objects.</summary>
+        <summary>Creates an immutable array that contains the specified objects.</summary>
         <returns>An immutable array that contains the specified objects.</returns>
         <remarks>To be added.</remarks>
       </Docs>
@@ -402,9 +384,7 @@
         <param name="items">The source array of objects.</param>
         <param name="start">The index of the first element to copy from <paramref name="items" />.</param>
         <param name="length">The number of elements from <paramref name="items" /> to include in this immutable array.</param>
-        <summary>  
-  
- Creates an immutable array with the specified objects from another immutable array.</summary>
+        <summary>Creates an immutable array with the specified objects from another immutable array.</summary>
         <returns>An immutable array that contains the specified objects from the source array.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
@@ -448,9 +428,7 @@ This overload allows helper methods or custom builder classes to efficiently avo
         <param name="item1">The first object to store in the array.</param>
         <param name="item2">The second object to store in the array.</param>
         <param name="item3">The third object to store in the array.</param>
-        <summary>  
-  
- Creates an immutable array that contains the specified objects.</summary>
+        <summary>Creates an immutable array that contains the specified objects.</summary>
         <returns>An immutable array that contains the specified objects.</returns>
         <remarks>To be added.</remarks>
       </Docs>
@@ -488,9 +466,7 @@ This overload allows helper methods or custom builder classes to efficiently avo
         <param name="items">The source array of objects.</param>
         <param name="start">The index of the first element to copy from <paramref name="items" />.</param>
         <param name="length">The number of elements from <paramref name="items" /> to include in this immutable array.</param>
-        <summary>  
-  
- Creates an immutable array with specified objects from another array.</summary>
+        <summary>Creates an immutable array with specified objects from another array.</summary>
         <returns>An immutable array that contains the specified objects from the source array.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
@@ -536,9 +512,7 @@ This overload allows helper methods or custom builder classes to efficiently avo
         <param name="item2">The second object to store in the array.</param>
         <param name="item3">The third object to store in the array.</param>
         <param name="item4">The fourth object to store in the array.</param>
-        <summary>  
-  
- Creates an immutable array that contains the specified objects.</summary>
+        <summary>Creates an immutable array that contains the specified objects.</summary>
         <returns>An immutable array that contains the specified objects.</returns>
         <remarks>To be added.</remarks>
       </Docs>
@@ -569,9 +543,7 @@ This overload allows helper methods or custom builder classes to efficiently avo
       <Parameters />
       <Docs>
         <typeparam name="T">The type of elements stored in the builder.</typeparam>
-        <summary>  
-  
- Creates a mutable array that can be converted to an <see cref="T:System.Collections.Immutable.ImmutableArray" /> without allocating new memory.</summary>
+        <summary>Creates a mutable array that can be converted to an <see cref="T:System.Collections.Immutable.ImmutableArray" /> without allocating new memory.</summary>
         <returns>A mutable array of the specified type that can be efficiently converted to an immutable array.</returns>
         <remarks>To be added.</remarks>
       </Docs>
@@ -605,9 +577,7 @@ This overload allows helper methods or custom builder classes to efficiently avo
       <Docs>
         <typeparam name="T">The type of elements stored in the builder.</typeparam>
         <param name="initialCapacity">The initial capacity of the builder.</param>
-        <summary>  
-  
- Creates a mutable array that can be converted to an <see cref="T:System.Collections.Immutable.ImmutableArray" /> without allocating new memory.</summary>
+        <summary>Creates a mutable array that can be converted to an <see cref="T:System.Collections.Immutable.ImmutableArray" /> without allocating new memory.</summary>
         <returns>A mutable array of the specified type that can be efficiently converted to an immutable array.</returns>
         <remarks>To be added.</remarks>
       </Docs>
@@ -641,9 +611,7 @@ This overload allows helper methods or custom builder classes to efficiently avo
       <Docs>
         <typeparam name="T">The type of element stored in the array.</typeparam>
         <param name="items">The elements to add to the array.</param>
-        <summary>  
-  
- Creates a new <see cref="T:System.Collections.Immutable.ImmutableArray`1" /> populated with the specified items.</summary>
+        <summary>Creates a new <see cref="T:System.Collections.Immutable.ImmutableArray`1" /> populated with the specified items.</summary>
         <returns>An immutable array that contains the specified items.</returns>
         <remarks>To be added.</remarks>
       </Docs>
@@ -873,9 +841,7 @@ This overload allows helper methods or custom builder classes to efficiently avo
       <Docs>
         <typeparam name="TSource">The type of elements contained in <paramref name="items" />.</typeparam>
         <param name="items">The collection of objects to copy to the immutable array.</param>
-        <summary>  
-  
- Creates an immutable array from the specified collection.</summary>
+        <summary>Creates an immutable array from the specified collection.</summary>
         <returns>An immutable array that contains the specified collection of objects.</returns>
         <remarks>To be added.</remarks>
       </Docs>

xml/System.Collections.Immutable/ImmutableArray.xml

@@ -302,9 +302,7 @@
         <param name="location">The destination, whose value is compared with <paramref name="comparand" /> and possibly replaced.</param>
         <param name="value">The value that replaces the destination value if the comparison results in equality.</param>
         <param name="comparand">The value that is compared to the value at <paramref name="location" />.</param>
-        <summary>  
-  
- Compares two immutable arrays for equality and, if they are equal, replaces one of the arrays.</summary>
+        <summary>Compares two immutable arrays for equality and, if they are equal, replaces one of the arrays.</summary>
         <returns>The original value in <paramref name="location" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
@@ -340,9 +338,7 @@
         <typeparam name="T">The type of element stored by the array.</typeparam>
         <param name="location">The array to set to the specified value.</param>
         <param name="value">The value to which the <paramref name="location" /> parameter is set.</param>
-        <summary>  
-  
- Sets an array to the specified array and returns a reference to the original array, as an atomic operation.</summary>
+        <summary>Sets an array to the specified array and returns a reference to the original array, as an atomic operation.</summary>
         <returns>The original value of <paramref name="location" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
@@ -378,9 +374,7 @@
         <typeparam name="T">The type of element stored by the array.</typeparam>
         <param name="location">The array to set to the specified value.</param>
         <param name="value">The value to which the <paramref name="location" /> parameter is set, if it's not initialized.</param>
-        <summary>  
-  
- Sets an array to the specified array if the array has not been initialized.</summary>
+        <summary>Sets an array to the specified array if the array has not been initialized.</summary>
         <returns>
           <see langword="true" /> if the array was assigned the specified value;  otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>