Replace <see langword="Single" /> tags (dotnet#3991)

nxtn · web-flow · commit ce7fbe3183a0 · 2020-03-16T19:08:29.000-07:00
* Replace &lt;see langword="Single" /&gt; tags

* Don't list all enum values

* Use &lt;code&gt; for XAML types

* Fix enum field reference

* Revert VB keywords
diff --git a/xml/Microsoft.VisualBasic.Compatibility.VB6/Support.xml b/xml/Microsoft.VisualBasic.Compatibility.VB6/Support.xml
@@ -631,7 +631,7 @@
       </Parameters>
       <Docs>
         <param name="CurrentFont">A <see cref="T:System.Drawing.Font" />.</param>
-        <param name="Size">A <see langword="Single" /> that represents the Visual Basic 6.0 <see langword="FontSize" /> property.</param>
+        <param name="Size">A <see cref="T:System.Single" /> that represents the Visual Basic 6.0 <see langword="FontSize" /> property.</param>
         <summary>Changes the <see cref="P:System.Drawing.Font.Size" /> property for a font.</summary>
         <returns>A <see cref="T:System.Drawing.Font" /> that matches the Visual Basic 6.0 <see langword="FontSize" />.</returns>
         <remarks>
diff --git a/xml/Microsoft.VisualBasic.CompilerServices/Conversions.xml b/xml/Microsoft.VisualBasic.CompilerServices/Conversions.xml
@@ -1160,7 +1160,7 @@
       <Docs>
         <param name="Value">The object to convert.</param>
         <summary>Converts an object to a <see cref="T:System.Single" /> value.</summary>
-        <returns>The <see langword="Single" /> value of the object.</returns>
+        <returns>The <see cref="T:System.Single" /> value of the object.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -1197,7 +1197,7 @@
       <Docs>
         <param name="Value">The string to convert.</param>
         <summary>Converts a <see cref="T:System.String" /> to a <see cref="T:System.Single" /> value.</summary>
-        <returns>The <see langword="Single" /> value of the string.</returns>
+        <returns>The <see cref="T:System.Single" /> value of the string.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -1571,9 +1571,9 @@
         <Parameter Name="Value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <param name="Value">The <see langword="Single" /> value to convert.</param>
+        <param name="Value">The <see cref="T:System.Single" /> value to convert.</param>
         <summary>Converts a <see cref="T:System.Single" /> value (a single-precision floating point number) to a <see cref="T:System.String" /> value.</summary>
-        <returns>The <see langword="String" /> representation of the <see langword="Single" /> value.</returns>
+        <returns>The string representation of the <see cref="T:System.Single" /> value.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -1748,10 +1748,10 @@
         <Parameter Name="NumberFormat" Type="System.Globalization.NumberFormatInfo" Index="1" FrameworkAlternate="netcore-3.0;netframework-2.0;netframework-3.0;netframework-3.5;netframework-4.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8;netcore-3.1" />
       </Parameters>
       <Docs>
-        <param name="Value">The <see langword="Single" /> value to convert.</param>
+        <param name="Value">The <see cref="T:System.Single" /> value to convert.</param>
         <param name="NumberFormat">The number format to use, according to <see cref="T:System.Globalization.NumberFormatInfo" />.</param>
         <summary>Converts a <see cref="T:System.Single" /> value to a <see cref="T:System.String" /> value, using the specified number format.</summary>
-        <returns>The <see langword="String" /> representation of the <see langword="Single" /> value.</returns>
+        <returns>The string representation of the <see cref="T:System.Single" /> value.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
diff --git a/xml/Microsoft.VisualBasic.CompilerServices/FlowControl.xml b/xml/Microsoft.VisualBasic.CompilerServices/FlowControl.xml
@@ -346,9 +346,9 @@
         <Parameter Name="StepValue" Type="System.Single" />
       </Parameters>
       <Docs>
-        <param name="count">Required. A <see langword="Single" /> value that represents the initial value passed for the loop counter variable.</param>
-        <param name="limit">Required. A <see langword="Single" /> value that represents the value passed by using the <see langword="To" /> keyword.</param>
-        <param name="StepValue">Required. A <see langword="Single" /> value that represents the value passed by using the <see langword="Step" /> keyword.</param>
+        <param name="count">Required. A <see cref="T:System.Single" /> value that represents the initial value passed for the loop counter variable.</param>
+        <param name="limit">Required. A <see cref="T:System.Single" /> value that represents the value passed by using the <see langword="To" /> keyword.</param>
+        <param name="StepValue">Required. A <see cref="T:System.Single" /> value that represents the value passed by using the <see langword="Step" /> keyword.</param>
         <summary>Checks for valid values for the loop counter, <see langword="Step" />, and <see langword="To" /> values.</summary>
         <returns>
           <see langword="True" /> if <paramref name="StepValue" /> is greater than zero and <paramref name="count" /> is less than or equal to <paramref name="limit" />, or if <paramref name="StepValue" /> is less than or equal to zero and <paramref name="count" /> is greater than or equal to <paramref name="limit" />; otherwise, <see langword="False" />.</returns>
diff --git a/xml/Microsoft.VisualBasic.CompilerServices/ObjectFlowControl+ForLoopControl.xml b/xml/Microsoft.VisualBasic.CompilerServices/ObjectFlowControl+ForLoopControl.xml
@@ -211,9 +211,9 @@
         <Parameter Name="StepValue" Type="System.Single" />
       </Parameters>
       <Docs>
-        <param name="count">Required. A <see langword="Single" /> value that represents the initial value passed for the loop counter variable.</param>
-        <param name="limit">Required. A <see langword="Single" /> value that represents the value passed by using the <see langword="To" /> keyword.</param>
-        <param name="StepValue">Required. A <see langword="Single" /> value that represents the value passed by using the <see langword="Step" /> keyword.</param>
+        <param name="count">Required. A <see cref="T:System.Single" /> value that represents the initial value passed for the loop counter variable.</param>
+        <param name="limit">Required. A <see cref="T:System.Single" /> value that represents the value passed by using the <see langword="To" /> keyword.</param>
+        <param name="StepValue">Required. A <see cref="T:System.Single" /> value that represents the value passed by using the <see langword="Step" /> keyword.</param>
         <summary>Checks for valid values for the loop counter, <see langword="Step" />, and <see langword="To" /> values.</summary>
         <returns>
           <see langword="True" /> if <paramref name="StepValue" /> is greater than zero and <paramref name="count" /> is less than or equal to <paramref name="limit" />, or if <paramref name="StepValue" /> is less than or equal to zero and <paramref name="count" /> is greater than or equal to <paramref name="limit" />; otherwise, <see langword="False" />.</returns>
diff --git a/xml/Microsoft.VisualBasic.CompilerServices/SingleType.xml b/xml/Microsoft.VisualBasic.CompilerServices/SingleType.xml
@@ -49,7 +49,7 @@
         <AssemblyVersion>10.0.0.0</AssemblyVersion>
       </AssemblyInfo>
       <Docs>
-        <summary>Returns a <see langword="Single" /> value that corresponds to the specified object and optional number format information.</summary>
+        <summary>Returns a <see cref="T:System.Single" /> value that corresponds to the specified object and optional number format information.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
@@ -93,9 +93,9 @@
         <Parameter Name="Value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <param name="Value">Required. Object to convert to a <see langword="Single" /> value.</param>
-        <summary>Returns a <see langword="Single" /> value that corresponds to the specified object.</summary>
-        <returns>The <see langword="Single" /> value corresponding to <paramref name="Value" />.</returns>
+        <param name="Value">Required. Object to convert to a <see cref="T:System.Single" /> value.</param>
+        <summary>Returns a <see cref="T:System.Single" /> value that corresponds to the specified object.</summary>
+        <returns>The <see cref="T:System.Single" /> value corresponding to <paramref name="Value" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
@@ -136,10 +136,10 @@
         <Parameter Name="NumberFormat" Type="System.Globalization.NumberFormatInfo" />
       </Parameters>
       <Docs>
-        <param name="Value">Required. Object to convert to a <see langword="Single" /> value.</param>
+        <param name="Value">Required. Object to convert to a <see cref="T:System.Single" /> value.</param>
         <param name="NumberFormat">A <see cref="T:System.Globalization.NumberFormatInfo" /> object that defines how numeric values are formatted and displayed, depending on the culture.</param>
-        <summary>Returns a <see langword="Single" /> value that corresponds to the specified object.</summary>
-        <returns>The <see langword="Single" /> value corresponding to <paramref name="Value" />.</returns>
+        <summary>Returns a <see cref="T:System.Single" /> value that corresponds to the specified object.</summary>
+        <returns>The <see cref="T:System.Single" /> value corresponding to <paramref name="Value" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
@@ -157,7 +157,7 @@
         <AssemblyVersion>10.0.0.0</AssemblyVersion>
       </AssemblyInfo>
       <Docs>
-        <summary>Returns a <see langword="Single" /> value that corresponds to the specified string and optional number format information.</summary>
+        <summary>Returns a <see cref="T:System.Single" /> value that corresponds to the specified string and optional number format information.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
@@ -201,9 +201,9 @@
         <Parameter Name="Value" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="Value">Required. String to convert to a <see langword="Single" /> value.</param>
-        <summary>Returns a <see langword="Single" /> value that corresponds to the specified string.</summary>
-        <returns>The <see langword="Single" /> value that corresponds to <paramref name="Value" />.</returns>
+        <param name="Value">Required. String to convert to a <see cref="T:System.Single" /> value.</param>
+        <summary>Returns a <see cref="T:System.Single" /> value that corresponds to the specified string.</summary>
+        <returns>The <see cref="T:System.Single" /> value that corresponds to <paramref name="Value" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
@@ -244,10 +244,10 @@
         <Parameter Name="NumberFormat" Type="System.Globalization.NumberFormatInfo" />
       </Parameters>
       <Docs>
-        <param name="Value">Required. String to convert to a <see langword="Single" /> value.</param>
+        <param name="Value">Required. String to convert to a <see cref="T:System.Single" /> value.</param>
         <param name="NumberFormat">A <see cref="T:System.Globalization.NumberFormatInfo" /> object that defines how numeric values are formatted and displayed, depending on the culture.</param>
-        <summary>Returns a <see langword="Single" /> value that corresponds to the specified string and number format information.</summary>
-        <returns>The <see langword="Single" /> value corresponding to <paramref name="Value" />.</returns>
+        <summary>Returns a <see cref="T:System.Single" /> value that corresponds to the specified string and number format information.</summary>
+        <returns>The <see cref="T:System.Single" /> value corresponding to <paramref name="Value" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
diff --git a/xml/Microsoft.VisualBasic.CompilerServices/StringType.xml b/xml/Microsoft.VisualBasic.CompilerServices/StringType.xml
@@ -601,7 +601,7 @@
         <AssemblyVersion>10.0.0.0</AssemblyVersion>
       </AssemblyInfo>
       <Docs>
-        <summary>Returns a <see langword="String" /> value that corresponds to a specified <see langword="Single" /> and optional number format information.</summary>
+        <summary>Returns a string value that corresponds to a specified <see cref="T:System.Single" /> and optional number format information.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
@@ -645,9 +645,9 @@
         <Parameter Name="Value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <param name="Value">Required. <see langword="Single" /> to convert to a <see langword="String" /> value.</param>
-        <summary>Returns a <see langword="String" /> value that corresponds to a specified <see langword="Single" />.</summary>
-        <returns>The <see langword="String" /> value corresponding to <paramref name="Value" />.</returns>
+        <param name="Value">Required. <see cref="T:System.Single" /> to convert to a <see langword="String" /> value.</param>
+        <summary>Returns a string value that corresponds to a specified <see cref="T:System.Single" />.</summary>
+        <returns>The string value corresponding to <paramref name="Value" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
@@ -688,10 +688,10 @@
         <Parameter Name="NumberFormat" Type="System.Globalization.NumberFormatInfo" />
       </Parameters>
       <Docs>
-        <param name="Value">Required. <see langword="Single" /> to convert to a <see langword="String" /> value.</param>
+        <param name="Value">Required. <see cref="T:System.Single" /> to convert to a <see langword="String" /> value.</param>
         <param name="NumberFormat">A <see cref="T:System.Globalization.NumberFormatInfo" /> object that defines how numeric values are formatted and displayed, depending on the culture.</param>
-        <summary>Returns a <see langword="String" /> value that corresponds to a specified <see langword="Single" /> and number format information.</summary>
-        <returns>The <see langword="String" /> value corresponding to <paramref name="Value" />.</returns>
+        <summary>Returns a string value that corresponds to a specified <see cref="T:System.Single" /> and number format information.</summary>
+        <returns>The string value corresponding to <paramref name="Value" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
diff --git a/xml/Microsoft.VisualBasic/Constants.xml b/xml/Microsoft.VisualBasic/Constants.xml
@@ -3334,7 +3334,7 @@
       </ReturnValue>
       <MemberValue>4</MemberValue>
       <Docs>
-        <summary>Indicates that the type of a variant object is <see langword="Single" />. Returned by the <see langword="VarType" /> function.</summary>
+        <summary>Indicates that the type of a variant object is <see cref="T:System.Single" />. Returned by the <see langword="VarType" /> function.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
diff --git a/xml/Microsoft.VisualBasic/Conversion.xml b/xml/Microsoft.VisualBasic/Conversion.xml
@@ -782,7 +782,7 @@ Dim i2 As Integer = CInt(Fix(s))           ' Result: 173
         <Parameter Name="Number" Type="System.Single" />
       </Parameters>
       <Docs>
-        <param name="Number">Required. A number of type <see langword="Single" /> or any valid numeric expression. </param>
+        <param name="Number">Required. A number of type <see cref="T:System.Single" /> or any valid numeric expression. </param>
         <summary>Returns the integer portion of a number.</summary>
         <returns>The integer portion of a number.</returns>
         <remarks>
@@ -1876,7 +1876,7 @@ Dim i2 As Integer = CInt(Int(s))           ' Result: 173
         <Parameter Name="Number" Type="System.Single" />
       </Parameters>
       <Docs>
-        <param name="Number">Required. A number of type <see langword="Single" /> or any valid numeric expression. </param>
+        <param name="Number">Required. A number of type <see cref="T:System.Single" /> or any valid numeric expression. </param>
         <summary>Returns the integer portion of a number.</summary>
         <returns>The integer portion of a number.</returns>
         <remarks>
diff --git a/xml/Microsoft.VisualBasic/VBMath.xml b/xml/Microsoft.VisualBasic/VBMath.xml
@@ -173,7 +173,7 @@
         <AssemblyVersion>10.0.0.0</AssemblyVersion>
       </AssemblyInfo>
       <Docs>
-        <summary>Returns a random number of type <see langword="Single" />.</summary>
+        <summary>Returns a random number of type <see cref="T:System.Single" />.</summary>
       </Docs>
     </MemberGroup>
     <Member MemberName="Rnd">
@@ -206,7 +206,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Returns a random number of type <see langword="Single" />.</summary>
+        <summary>Returns a random number of type <see cref="T:System.Single" />.</summary>
         <returns>The next random number in the sequence.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
@@ -268,8 +268,8 @@
         <Parameter Name="Number" Type="System.Single" />
       </Parameters>
       <Docs>
-        <param name="Number">Optional. A <see langword="Single" /> value or any valid <see langword="Single" /> expression.</param>
-        <summary>Returns a random number of type <see langword="Single" />.</summary>
+        <param name="Number">Optional. A <see cref="T:System.Single" /> value or any valid <see cref="T:System.Single" /> expression.</param>
+        <summary>Returns a random number of type <see cref="T:System.Single" />.</summary>
         <returns>If number is less than zero, Rnd generates the same number every time, using <paramref name="Number" /> as the seed. If number is greater than zero, Rnd generates the next random number in the sequence. If number is equal to zero, Rnd generates the most recently generated number. If number is not supplied, Rnd generates the next random number in the sequence.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
diff --git a/xml/System.IO/UnmanagedMemoryAccessor.xml b/xml/System.IO/UnmanagedMemoryAccessor.xml
@@ -1909,7 +1909,7 @@
       <Docs>
         <param name="position">The number of bytes into the accessor at which to begin writing.</param>
         <param name="value">The value to write.</param>
-        <summary>Writes a <see langword="Single" /> into the accessor.</summary>
+        <summary>Writes a <see cref="T:System.Single" /> into the accessor.</summary>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentException">There are not enough bytes after <paramref name="position" /> to write a value.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
diff --git a/xml/System.Reflection.Emit/ILGenerator.xml b/xml/System.Reflection.Emit/ILGenerator.xml
@@ -1353,7 +1353,7 @@
       </Parameters>
       <Docs>
         <param name="opcode">The MSIL instruction to be put onto the stream.</param>
-        <param name="arg">The <see langword="Single" /> argument pushed onto the stream immediately after the instruction.</param>
+        <param name="arg">The <see cref="T:System.Single" /> argument pushed onto the stream immediately after the instruction.</param>
         <summary>Puts the specified instruction and numerical argument onto the Microsoft intermediate language (MSIL) stream of instructions.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[  
diff --git a/xml/System.Web.UI.WebControls/ListBox.xml b/xml/System.Web.UI.WebControls/ListBox.xml
@@ -594,7 +594,7 @@
       </ReturnValue>
       <Docs>
         <summary>Gets or sets the selection mode of the <see cref="T:System.Web.UI.WebControls.ListBox" /> control.</summary>
-        <value>One of the <see cref="T:System.Web.UI.WebControls.ListSelectionMode" /> values. The default value is <see langword="Single" />.</value>
+        <value>One of the <see cref="T:System.Web.UI.WebControls.ListSelectionMode" /> values. The default value is <see cref="F:System.Web.UI.WebControls.ListSelectionMode.Single" />.</value>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
diff --git a/xml/System.Windows.Automation.Provider/ITextProvider.xml b/xml/System.Windows.Automation.Provider/ITextProvider.xml
@@ -235,7 +235,7 @@
       </ReturnValue>
       <Docs>
         <summary>Gets a value that specifies whether a text provider supports selection and, if so, the type of selection supported.</summary>
-        <value>One of <see langword="None" />, <see langword="Single" />, or <see langword="Multiple" /> from <see cref="T:System.Windows.Automation.SupportedTextSelection" />.</value>
+        <value>One of the <see cref="T:System.Windows.Automation.SupportedTextSelection" /> values.</value>
         <remarks>To be added.</remarks>
         <altmember cref="T:System.Windows.Automation.Provider.ITextRangeProvider" />
       </Docs>
diff --git a/xml/System.Windows.Automation/TextPattern.xml b/xml/System.Windows.Automation/TextPattern.xml
diff --git a/xml/System.Xaml/XamlLanguage.xml b/xml/System.Xaml/XamlLanguage.xml
diff --git a/xml/System.Xml.Xsl.Runtime/XmlILStorageConverter.xml b/xml/System.Xml.Xsl.Runtime/XmlILStorageConverter.xml
diff --git a/xml/System.Xml/XmlConvert.xml b/xml/System.Xml/XmlConvert.xml
