Fix mismatched paramrefs for System.Linq, System.IO, System.Drawing, System.Globalization (#10903)

Author: gewarren

xml/System.Drawing.Design/ToolboxService.xml

@@ -5437,7 +5437,7 @@
         <ReturnType>System.Drawing.Drawing2D.PathData</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets a <see cref="T:System.Drawing.Drawing2D.PathData" /> that encapsulates arrays of points (<paramref name="points" />) and types (<paramref name="types" />) for this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />.</summary>
+        <summary>Gets a <see cref="T:System.Drawing.Drawing2D.PathData" /> that encapsulates arrays of points and types for this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />.</summary>
         <value>A <see cref="T:System.Drawing.Drawing2D.PathData" /> that encapsulates arrays for both the points and types for this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />.</value>
         <remarks>To be added.</remarks>
       </Docs>

xml/System.Drawing.Drawing2D/GraphicsPath.xml

@@ -544,7 +544,7 @@
         <param name="encoder">An <see cref="T:System.Drawing.Imaging.Encoder" /> object that encapsulates the globally unique identifier of the parameter category.</param>
         <param name="numberValues">An integer that specifies the number of values stored in the <see cref="T:System.Drawing.Imaging.EncoderParameter" /> object. The <see cref="P:System.Drawing.Imaging.EncoderParameter.NumberOfValues" /> property is set to this value.</param>
         <param name="type">A member of the <see cref="T:System.Drawing.Imaging.EncoderParameterValueType" /> enumeration that specifies the data type of the values stored in the <see cref="T:System.Drawing.Imaging.EncoderParameter" /> object. The <see cref="T:System.Type" /> and <see cref="P:System.Drawing.Imaging.EncoderParameter.ValueType" /> properties are set to this value.</param>
-        <param name="value">A pointer to an array of values of the type specified by the <paramref name="Type" /> parameter.</param>
+        <param name="value">A pointer to an array of values of the type specified by the <paramref name="type" /> parameter.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Drawing.Imaging.EncoderParameter" /> class with the specified <see cref="T:System.Drawing.Imaging.Encoder" /> object, number of values, data type of the values, and a pointer to the values stored in the <see cref="T:System.Drawing.Imaging.EncoderParameter" /> object.</summary>
         <remarks>To be added.</remarks>
       </Docs>

xml/System.Drawing.Imaging/EncoderParameter.xml

@@ -46,20 +46,20 @@
   <Docs>
     <summary>Converts colors from one data type to another. Access this class through the <see cref="T:System.ComponentModel.TypeDescriptor" />.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- When converting from a string to a <xref:System.Drawing.Color> the <xref:System.Drawing.ColorConverter> expects the unqualified color name; otherwise, an exception will occur in the conversion process. For example, you should pass "Blue", not "System.Drawing.Color.Blue" or "Color.Blue", to the <xref:System.Drawing.ColorConverter.ConvertFrom%2A> method.  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to use the <xref:System.ComponentModel.TypeConverter.ConvertToString%2A> method. This example is designed to be used with Windows Forms. Paste this code into a form and call the `ShowColorConverter` method when handling the form's <xref:System.Windows.Forms.Control.Paint> event, passing `e` as <xref:System.Windows.Forms.PaintEventArgs>.  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ When converting from a string to a <xref:System.Drawing.Color> the <xref:System.Drawing.ColorConverter> expects the unqualified color name; otherwise, an exception will occur in the conversion process. For example, you should pass "Blue", not "System.Drawing.Color.Blue" or "Color.Blue", to the <xref:System.Drawing.ColorConverter.ConvertFrom%2A> method.
+
+
+
+## Examples
+ The following code example demonstrates how to use the <xref:System.ComponentModel.TypeConverter.ConvertToString%2A> method. This example is designed to be used with Windows Forms. Paste this code into a form and call the `ShowColorConverter` method when handling the form's <xref:System.Windows.Forms.Control.Paint> event, passing `e` as <xref:System.Windows.Forms.PaintEventArgs>.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.Converters/CPP/form1.cpp" id="Snippet2":::
  :::code language="csharp" source="~/snippets/csharp/System.Drawing/ColorConverter/Overview/form1.cs" id="Snippet2":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.Converters/VB/form1.vb" id="Snippet2":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.Converters/VB/form1.vb" id="Snippet2":::
+
  ]]></format>
     </remarks>
   </Docs>
@@ -202,8 +202,8 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <param name="context">An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
-        <param name="destinationType">A <see cref="T:System.Type" /> that represents the type to which you want to convert.</param>
+        <param name="context">A format context.</param>
+        <param name="destinationType">The type to which you want to convert.</param>
         <summary>Returns a value indicating whether this converter can convert an object to the given destination type using the context.</summary>
         <returns>
           <see langword="true" /> if this converter can perform the operation; otherwise, <see langword="false" />.</returns>
@@ -262,11 +262,11 @@
         <summary>Converts the given object to the converter's native type.</summary>
         <returns>An <see cref="T:System.Object" /> representing the converted value.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- When converting from a string to a <xref:System.Drawing.Color> the <xref:System.Drawing.ColorConverter> expects the unqualified color name; otherwise, an exception will occur in the conversion process. For example, you should pass "Blue", not "System.Drawing.Color.Blue" or "Color.Blue", to the <xref:System.Drawing.ColorConverter.ConvertFrom%2A> method.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ When converting from a string to a <xref:System.Drawing.Color> the <xref:System.Drawing.ColorConverter> expects the unqualified color name; otherwise, an exception will occur in the conversion process. For example, you should pass "Blue", not "System.Drawing.Color.Blue" or "Color.Blue", to the <xref:System.Drawing.ColorConverter.ConvertFrom%2A> method.
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">The conversion cannot be performed.</exception>
@@ -326,15 +326,15 @@
         <summary>Converts the specified object to another type.</summary>
         <returns>An <see cref="T:System.Object" /> representing the converted value.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The most common conversion is to or from a string.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The most common conversion is to or from a string.
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">
-          <paramref name="destinationtype" /> is <see langword="null" />.</exception>
+          <paramref name="destinationType" /> is <see langword="null" />.</exception>
         <exception cref="T:System.NotSupportedException">The conversion cannot be performed.</exception>
       </Docs>
     </Member>

xml/System.Drawing/ColorConverter.xml

@@ -14340,11 +14340,9 @@ The <see cref="T:System.Drawing.Graphics" /> object has a transform applied othe
 ## Examples
  The following code example is designed for use with Windows Forms, and it requires <xref:System.Windows.Forms.PaintEventArgs> `e`, which is a parameter of the <xref:System.Windows.Forms.Control.Paint> event handler. The code performs the following action:
 
--   Creates a solid blue brush.
-
--   Creates an array of three rectangles.
-
--   Fills the three rectangular areas on the screen.
+- Creates a solid blue brush.
+- Creates an array of three rectangles.
+- Fills the three rectangular areas on the screen.
 
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ClassicGraphicsExamples3/CPP/form1.cpp" id="Snippet116":::
  :::code language="csharp" source="~/snippets/csharp/System.Drawing/Graphics/FillRectangle/form1.cs" id="Snippet116":::
@@ -14359,7 +14357,7 @@ The <see cref="T:System.Drawing.Graphics" /> object has a transform applied othe
 
  <paramref name="rects" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
-          <paramref name="Rects" /> is a zero-length array.</exception>
+          <paramref name="rects" /> is a zero-length array.</exception>
       </Docs>
     </Member>
     <Member MemberName="FillRectangles">
@@ -17154,7 +17152,7 @@ The <see cref="T:System.Drawing.Graphics" /> object has a transform applied othe
         <param name="format">
           <see cref="T:System.Drawing.StringFormat" /> that represents formatting information, such as line spacing, for the string.</param>
         <summary>Measures the specified string when drawn with the specified <see cref="T:System.Drawing.Font" /> and formatted with the specified <see cref="T:System.Drawing.StringFormat" />.</summary>
-        <returns>This method returns a <see cref="T:System.Drawing.SizeF" /> structure that represents the size, in the units specified by the <see cref="P:System.Drawing.Graphics.PageUnit" /> property, of the string specified in the <paramref name="text" /> parameter as drawn with the <paramref name="font" /> parameter and the <paramref name="stringFormat" /> parameter.</returns>
+        <returns>This method returns a <see cref="T:System.Drawing.SizeF" /> structure that represents the size, in the units specified by the <see cref="P:System.Drawing.Graphics.PageUnit" /> property, of the string specified in the <paramref name="text" /> parameter as drawn with the <paramref name="font" /> parameter and the <paramref name="format" /> parameter.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
 

xml/System.Drawing/Graphics.xml

@@ -348,7 +348,7 @@
 
  ]]></format>
         </remarks>
-        <exception cref="T:System.ArgumentException">The <paramref name="string" /> is <see langword="null" /> or does not contain image data.</exception>
+        <exception cref="T:System.ArgumentException">The <paramref name="fileName" /> is <see langword="null" /> or does not contain image data.</exception>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -539,7 +539,7 @@
 
  ]]></format>
         </remarks>
-        <exception cref="T:System.ArgumentException">The <paramref name="string" /> is <see langword="null" /> or does not contain image data.</exception>
+        <exception cref="T:System.ArgumentException">The <paramref name="fileName" /> is <see langword="null" /> or does not contain image data.</exception>
       </Docs>
     </Member>
     <Member MemberName="Clone">

xml/System.Drawing/Icon.xml

@@ -184,18 +184,14 @@
  By default, the comparison is performed by using <xref:System.Globalization.CompareOptions.None?displayProperty=nameWithType>. If a security decision depends on a string comparison or a case change, you should use the <xref:System.Globalization.CultureInfo.InvariantCulture%2A> property to ensure that the behavior is consistent regardless of the culture settings of the operating system.
 
 > [!NOTE]
->  When possible, you should call string comparison methods that have a parameter of type <xref:System.Globalization.CompareOptions> to specify the kind of comparison expected. As a general rule, use linguistic options (using the current culture) for comparing strings displayed in the user interface and specify <xref:System.Globalization.CompareOptions.Ordinal> or <xref:System.Globalization.CompareOptions.OrdinalIgnoreCase> for security comparisons.
-
-
+> When possible, you should call string comparison methods that have a parameter of type <xref:System.Globalization.CompareOptions> to specify the kind of comparison expected. As a general rule, use linguistic options (using the current culture) for comparing strings displayed in the user interface and specify <xref:System.Globalization.CompareOptions.Ordinal> or <xref:System.Globalization.CompareOptions.OrdinalIgnoreCase> for security comparisons.
 
 ## Examples
  The following example compares portions of two strings using the different <xref:System.Globalization.CompareInfo> objects:
 
--   <xref:System.Globalization.CompareInfo> object associated with the Spanish (Spain) culture with international sort
-
--   <xref:System.Globalization.CompareInfo> object associated with the Spanish (Spain) culture with traditional sort
-
--   <xref:System.Globalization.CompareInfo> object associated with the <xref:System.Globalization.CultureInfo.InvariantCulture%2A>
+- <xref:System.Globalization.CompareInfo> object associated with the Spanish (Spain) culture with international sort
+- <xref:System.Globalization.CompareInfo> object associated with the Spanish (Spain) culture with traditional sort
+- <xref:System.Globalization.CompareInfo> object associated with the <xref:System.Globalization.CultureInfo.InvariantCulture%2A>
 
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.Globalization.CompareInfo.CompareStrStr/CPP/comparestrstr.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Globalization/CompareInfo/Compare/comparestrstr.cs" id="Snippet1":::
@@ -3441,7 +3437,7 @@ This method has greater overhead than other <xref:System.Globalization.CompareIn
         <param name="text">A string of zero or more Unicode characters.</param>
         <summary>Indicates whether a specified Unicode string is sortable.</summary>
         <returns>
-          <see langword="true" /> if the <paramref name="str" /> parameter is not an empty string ("") and all the Unicode characters in <paramref name="str" /> are sortable; otherwise, <see langword="false" />.</returns>
+          <see langword="true" /> if the <paramref name="text" /> parameter is not an empty string ("") and all the Unicode characters in <paramref name="text" /> are sortable; otherwise, <see langword="false" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
@@ -3451,7 +3447,7 @@ This method has greater overhead than other <xref:System.Globalization.CompareIn
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">
-          <paramref name="str" /> is <see langword="null" />.</exception>
+          <paramref name="text" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="IsSortable">

xml/System.Globalization/CompareInfo.xml

@@ -89,7 +89,7 @@ The following code example creates a custom culture with a private use prefix, t
 
  -or-
 
- <paramref name="cultureName" /> specifies an alternate sort replacement culture instead of a .NET Framework culture. For example, <paramref name="culturenName" /> is "de-de_phoneb", a culture that sorts strings as they appear in a German telephone book, instead of "de-DE", the German (Germany) culture.
+ <paramref name="cultureName" /> specifies an alternate sort replacement culture instead of a .NET Framework culture. For example, <paramref name="cultureName" /> is "de-de_phoneb", a culture that sorts strings as they appear in a German telephone book, instead of "de-DE", the German (Germany) culture.
 
  -or-