Replace <see langword="Int32" /> tags (#3877)

nxtn · mairaw · web-flow · commit 052f602492b2 · 2020-02-21T15:13:40.000-08:00
* Replace &lt;see langword="Int32" /&gt; tags

* Apply suggestions from code review

Co-Authored-By: Maira Wenzel &lt;mairaw@microsoft.com&gt;

Co-authored-by: Maira Wenzel &lt;mairaw@microsoft.com&gt;
diff --git a/xml/Microsoft.VisualBasic.FileIO/TextFieldParser.xml b/xml/Microsoft.VisualBasic.FileIO/TextFieldParser.xml
@@ -1104,8 +1104,7 @@
         <Parameter Name="numberOfChars" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="numberOfChars">
-          <see langword="Int32" />. Number of characters to read. Required.</param>
+        <param name="numberOfChars">The number of characters to read. Required.</param>
         <summary>Reads the specified number of characters without advancing the cursor.</summary>
         <returns>A string that contains the specified number of characters read.</returns>
         <remarks>
diff --git a/xml/System.Data.OracleClient/OracleMonthSpan.xml b/xml/System.Data.OracleClient/OracleMonthSpan.xml
@@ -581,9 +581,9 @@
         <Parameter Name="x" Type="System.Data.OracleClient.OracleMonthSpan" />
       </Parameters>
       <Docs>
-        <param name="x">An <see cref="T:System.Data.OracleClient.OracleMonthSpan" /> structure to convert to an <see langword="Int32" />.</param>
-        <summary>Converts an <see cref="T:System.Data.OracleClient.OracleMonthSpan" /> structure to an <see langword="Int32" />.</summary>
-        <returns>An <see langword="Int32" />.</returns>
+        <param name="x">An <see cref="T:System.Data.OracleClient.OracleMonthSpan" /> structure to convert to an integer.</param>
+        <summary>Converts an <see cref="T:System.Data.OracleClient.OracleMonthSpan" /> structure to an <see cref="T:System.Int32" />.</summary>
+        <returns>An integer.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
diff --git a/xml/System.Data.OracleClient/OracleNumber.xml b/xml/System.Data.OracleClient/OracleNumber.xml
@@ -1488,7 +1488,7 @@
       <Docs>
         <param name="x">The <see cref="T:System.Data.OracleClient.OracleNumber" /> structure to be converted.</param>
         <summary>Converts the <see cref="T:System.Data.OracleClient.OracleNumber" /> structure to <see cref="T:System.Int32" />.</summary>
-        <returns>A new <see langword="Int32" /> structure whose value equals the <see cref="P:System.Data.OracleClient.OracleNumber.Value" /> of the <see cref="T:System.Data.OracleClient.OracleNumber" /> structure.</returns>
+        <returns>A new <see cref="T:System.Int32" /> structure whose value equals the <see cref="P:System.Data.OracleClient.OracleNumber.Value" /> of the <see cref="T:System.Data.OracleClient.OracleNumber" /> structure.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -1616,8 +1616,8 @@ Console.WriteLine(i);
       </Parameters>
       <Docs>
         <param name="x">The integer structure to be converted.</param>
-        <summary>Converts the supplied <see langword="Int32" /> structure to an <see cref="T:System.Data.OracleClient.OracleNumber" /> structure.</summary>
-        <returns>A new <see cref="T:System.Data.OracleClient.OracleNumber" /> structure whose <see cref="P:System.Data.OracleClient.OracleNumber.Value" /> property equals the value of the <see langword="Int32" /> structure.</returns>
+        <summary>Converts the supplied integer to an <see cref="T:System.Data.OracleClient.OracleNumber" /> structure.</summary>
+        <returns>A new <see cref="T:System.Data.OracleClient.OracleNumber" /> structure whose <see cref="P:System.Data.OracleClient.OracleNumber.Value" /> property equals the value of the integer.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -2069,8 +2069,8 @@ Console.WriteLine(i);
       </Parameters>
       <Docs>
         <param name="x">The <see cref="T:System.Data.OracleClient.OracleNumber" /> to be raised to a power.</param>
-        <param name="y">An <see langword="Int32" /> structure that specifies a power.</param>
-        <summary>Calculates the result of raising a specified <see cref="T:System.Data.OracleClient.OracleNumber" /> structure to the power specified by an <see langword="Int32" /> structure.</summary>
+        <param name="y">An integer that specifies a power.</param>
+        <summary>Calculates the result of raising a specified number to the specified power.</summary>
         <returns>The number <paramref name="x" /> raised to the power <paramref name="y" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.IO.Compression/DeflateStream.xml b/xml/System.IO.Compression/DeflateStream.xml
@@ -1361,7 +1361,7 @@ If the operation is canceled before it completes, the returned task contains the
       <Parameters />
       <Docs>
         <summary>Reads a byte from the Deflate stream and advances the position within the stream by one byte, or returns -1 if at the end of the Deflate stream.</summary>
-        <returns>The unsigned byte cast to an <see langword="Int32" />, or -1 if at the end of the stream.</returns>
+        <returns>The unsigned byte cast to an <see cref="T:System.Int32" />, or -1 if at the end of the stream.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
diff --git a/xml/System.IO.Compression/GZipStream.xml b/xml/System.IO.Compression/GZipStream.xml
@@ -1349,7 +1349,7 @@ If the operation is canceled before it completes, the returned task contains the
       <Parameters />
       <Docs>
         <summary>Reads a byte from the GZip stream and advances the position within the stream by one byte, or returns -1 if at the end of the GZip stream.</summary>
-        <returns>The unsigned byte cast to an <see langword="Int32" />, or -1 if at the end of the stream.</returns>
+        <returns>The unsigned byte cast to an <see cref="T:System.Int32" />, or -1 if at the end of the stream.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
diff --git a/xml/System.IO/Stream.xml b/xml/System.IO/Stream.xml
@@ -2128,7 +2128,7 @@
       <Parameters />
       <Docs>
         <summary>Reads a byte from the stream and advances the position within the stream by one byte, or returns -1 if at the end of the stream.</summary>
-        <returns>The unsigned byte cast to an <see langword="Int32" />, or -1 if at the end of the stream.</returns>
+        <returns>The unsigned byte cast to an <see cref="T:System.Int32" />, or -1 if at the end of the stream.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
diff --git a/xml/System.Net.Security/SslStream.xml b/xml/System.Net.Security/SslStream.xml
@@ -3679,7 +3679,7 @@ This property gets the cipher suite that is going to be used in the communicatio
       <Parameters />
       <Docs>
         <summary>Reads a byte from the <see cref="T:System.Net.Security.SslStream" /> and advances the position within the stream by one byte, or returns -1 if at the end of the stream.</summary>
-        <returns>The unsigned byte cast to an <see langword="Int32" />, or -1 if at the end of the stream.</returns>
+        <returns>The unsigned byte cast to an <see cref="T:System.Int32" />, or -1 if at the end of the stream.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
diff --git a/xml/System.Net.Sockets/NetworkStream.xml b/xml/System.Net.Sockets/NetworkStream.xml
@@ -1662,7 +1662,7 @@ There is a failure reading from the network.</exception>
       <Parameters />
       <Docs>
         <summary>Reads a byte from the <see cref="T:System.Net.Sockets.NetworkStream" /> and advances the position within the stream by one byte, or returns -1 if at the end of the stream.</summary>
-        <returns>The unsigned byte cast to an <see langword="Int32" />, or -1 if at the end of the stream.</returns>
+        <returns>The unsigned byte cast to an <see cref="T:System.Int32" />, or -1 if at the end of the stream.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
diff --git a/xml/System.Runtime.Serialization/SerializationInfo.xml b/xml/System.Runtime.Serialization/SerializationInfo.xml
@@ -627,7 +627,7 @@ End Sub
       </Parameters>
       <Docs>
         <param name="name">The name to associate with the value, so it can be deserialized later.</param>
-        <param name="value">The <see langword="Int32" /> value to serialize.</param>
+        <param name="value">The <see cref="T:System.Int32" /> value to serialize.</param>
         <summary>Adds a 32-bit signed integer value into the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> store.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[  
diff --git a/xml/System.Security.Cryptography/CryptoStream.xml b/xml/System.Security.Cryptography/CryptoStream.xml
@@ -1127,7 +1127,7 @@
       <Parameters />
       <Docs>
         <summary>Reads a byte from the stream and advances the position within the stream by one byte, or returns -1 if at the end of the stream.</summary>
-        <returns>The unsigned byte cast to an <see langword="Int32" />, or -1 if at the end of the stream.</returns>
+        <returns>The unsigned byte cast to an <see cref="T:System.Int32" />, or -1 if at the end of the stream.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
diff --git a/xml/System.Threading/ReaderWriterLock.xml b/xml/System.Threading/ReaderWriterLock.xml
@@ -1101,7 +1101,7 @@
       </Parameters>
       <Docs>
         <param name="millisecondsTimeout">The time-out in milliseconds.</param>
-        <summary>Upgrades a reader lock to the writer lock, using an <see langword="Int32" /> value for the time-out.</summary>
+        <summary>Upgrades a reader lock to the writer lock, using an <see cref="T:System.Int32" /> value for the time-out.</summary>
         <returns>A <see cref="T:System.Threading.LockCookie" /> value.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
diff --git a/xml/System.Windows.Forms/Control.xml b/xml/System.Windows.Forms/Control.xml
@@ -5498,7 +5498,7 @@ MyControl.Font = New Font(MyControl.Font, _
         <Parameter Name="objectId" Type="System.Int32" Index="0" FrameworkAlternate="netcore-3.0;netcore-3.1;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" />
       </Parameters>
       <Docs>
-        <param name="objectId">An <see langword="Int32" /> that identifies the <see cref="T:System.Windows.Forms.AccessibleObject" /> to retrieve.</param>
+        <param name="objectId">An <see cref="T:System.Int32" /> that identifies the <see cref="T:System.Windows.Forms.AccessibleObject" /> to retrieve.</param>
         <summary>Retrieves the specified <see cref="T:System.Windows.Forms.AccessibleObject" />.</summary>
         <returns>The specified <see cref="T:System.Windows.Forms.AccessibleObject" />.</returns>
         <remarks>To be added.</remarks>
diff --git a/xml/System.Windows.Forms/DataGridView.xml b/xml/System.Windows.Forms/DataGridView.xml
@@ -7829,7 +7829,7 @@
         <Parameter Name="objectId" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="objectId">An <see langword="Int32" /> that identifies the <see cref="T:System.Windows.Forms.AccessibleObject" /> to retrieve.</param>
+        <param name="objectId">An <see cref="T:System.Int32" /> that identifies the <see cref="T:System.Windows.Forms.AccessibleObject" /> to retrieve.</param>
         <summary>Retrieves the specified <see cref="T:System.Windows.Forms.AccessibleObject" />.</summary>
         <returns>The specified <see cref="T:System.Windows.Forms.AccessibleObject" />.</returns>
         <remarks>To be added.</remarks>
diff --git a/xml/System.Xaml/XamlLanguage.xml b/xml/System.Xaml/XamlLanguage.xml
@@ -591,8 +591,8 @@
         <ReturnType>System.Xaml.XamlType</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets a <see cref="T:System.Xaml.XamlType" /> for the <see langword="Int32" /> XAML language intrinsic.</summary>
-        <value>A <see cref="T:System.Xaml.XamlType" /> for the <see langword="Int32" /> XAML language intrinsic.</value>
+        <summary>Gets a <see cref="T:System.Xaml.XamlType" /> for the <see cref="T:System.Int32" /> XAML language intrinsic.</summary>
+        <value>A <see cref="T:System.Xaml.XamlType" /> for the <see cref="T:System.Int32" /> XAML language intrinsic.</value>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
diff --git a/xml/System.Xml.Xsl.Runtime/Int32Aggregator.xml b/xml/System.Xml.Xsl.Runtime/Int32Aggregator.xml
@@ -53,7 +53,7 @@
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="value">A value of type <see langword="Int32" /> that identifies a group of items to average, such as a column in a table.</param>
+        <param name="value">A value of type <see cref="T:System.Int32" /> that identifies a group of items to average, such as a column in a table.</param>
         <summary>Finds the average of a sequence of Int32 values.</summary>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
@@ -81,7 +81,7 @@
       </ReturnValue>
       <Docs>
         <summary>Returns the average result of a sequence of Int32 values.</summary>
-        <value>An <see langword="Int32" /> value that contains the average result of a sequence of <see langword="Int32" /> values.</value>
+        <value>An <see cref="T:System.Int32" /> value that contains the average result of a sequence of <see cref="T:System.Int32" /> values.</value>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
       </Docs>
@@ -108,7 +108,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Initializes a sequence of <see langword="Int32" /> values.</summary>
+        <summary>Initializes a sequence of <see cref="T:System.Int32" /> values.</summary>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
       </Docs>
@@ -165,7 +165,7 @@
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="value">A value of type <see langword="Int32" />.</param>
+        <param name="value">A value of type <see cref="T:System.Int32" />.</param>
         <summary>Assigns the <paramref name="value" /> parameter to the existing result if the <paramref name="value" /> parameter is greater than the existing result.</summary>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
@@ -197,8 +197,8 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Returns the largest value in a sequence of <see langword="Int32" /> values.</summary>
-        <value>An <see langword="Int32" /> value that contains the maximum value in a sequence of <see langword="Int32" /> values.</value>
+        <summary>Returns the largest value in a sequence of <see cref="T:System.Int32" /> values.</summary>
+        <value>An <see cref="T:System.Int32" /> value that contains the maximum value in a sequence of <see cref="T:System.Int32" /> values.</value>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
       </Docs>
@@ -227,7 +227,7 @@
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="value">A value of type <see langword="Int32" /></param>
+        <param name="value">A value of type <see cref="T:System.Int32" /></param>
         <summary>Assigns the <paramref name="value" /> parameter to the existing result if the <paramref name="value" /> parameter is less than the existing result.</summary>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
@@ -260,7 +260,7 @@
       </ReturnValue>
       <Docs>
         <summary>Returns the smallest value in a sequence of Int32 values.</summary>
-        <value>An <see langword="Int32" /> value that contains the minimum value in a sequence of <see langword="Int32" /> values.</value>
+        <value>An <see cref="T:System.Int32" /> value that contains the minimum value in a sequence of <see cref="T:System.Int32" /> values.</value>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
       </Docs>
@@ -289,8 +289,8 @@
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="value">A value of type <see langword="Int32" />.</param>
-        <summary>Adds an <see langword="Int32" /> value to the existing result.</summary>
+        <param name="value">A value of type <see cref="T:System.Int32" />.</param>
+        <summary>Adds an <see cref="T:System.Int32" /> value to the existing result.</summary>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
       </Docs>
@@ -322,7 +322,7 @@
       </ReturnValue>
       <Docs>
         <summary>Returns the sum of a sequence of Int32 values.</summary>
-        <value>An <see langword="Int32" /> value that contains the sum of a sequence of <see langword="Int32" /> values.</value>
+        <value>An <see cref="T:System.Int32" /> value that contains the sum of a sequence of <see cref="T:System.Int32" /> values.</value>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
       </Docs>
diff --git a/xml/System.Xml.Xsl.Runtime/XmlILStorageConverter.xml b/xml/System.Xml.Xsl.Runtime/XmlILStorageConverter.xml
diff --git a/xml/System.Xml.Xsl.Runtime/XmlQueryItemSequence.xml b/xml/System.Xml.Xsl.Runtime/XmlQueryItemSequence.xml
diff --git a/xml/System.Xml.Xsl.Runtime/XmlQueryNodeSequence.xml b/xml/System.Xml.Xsl.Runtime/XmlQueryNodeSequence.xml
diff --git a/xml/System.Xml.Xsl.Runtime/XmlQueryRuntime.xml b/xml/System.Xml.Xsl.Runtime/XmlQueryRuntime.xml
diff --git a/xml/System.Xml.Xsl.Runtime/XmlSortKeyAccumulator.xml b/xml/System.Xml.Xsl.Runtime/XmlSortKeyAccumulator.xml
diff --git a/xml/System.Xml/XmlConvert.xml b/xml/System.Xml/XmlConvert.xml
