From 4d67491cd68cc305f66ae762084c693972b0d2a5 Mon Sep 17 00:00:00 2001
From: NextTurn <45985406+NextTurn@users.noreply.github.com>
Date: Thu, 13 Feb 2020 00:00:00 +0800
Subject: [PATCH 1/2] Replace <see langword="Int32" /> tags

---
 .../TextFieldParser.xml                       |  2 +-
 .../OracleMonthSpan.xml                       |  6 ++--
 xml/System.Data.OracleClient/OracleNumber.xml | 10 +++----
 xml/System.IO.Compression/DeflateStream.xml   |  2 +-
 xml/System.IO.Compression/GZipStream.xml      |  2 +-
 xml/System.IO/Stream.xml                      |  2 +-
 xml/System.Net.Security/SslStream.xml         |  2 +-
 xml/System.Net.Sockets/NetworkStream.xml      |  2 +-
 .../SerializationInfo.xml                     |  2 +-
 .../CryptoStream.xml                          |  2 +-
 xml/System.Threading/ReaderWriterLock.xml     |  2 +-
 xml/System.Windows.Forms/Control.xml          |  2 +-
 xml/System.Windows.Forms/DataGridView.xml     |  2 +-
 xml/System.Xaml/XamlLanguage.xml              |  4 +--
 .../Int32Aggregator.xml                       | 22 +++++++--------
 .../XmlILStorageConverter.xml                 | 28 +++++++++----------
 .../XmlQueryItemSequence.xml                  |  2 +-
 .../XmlQueryNodeSequence.xml                  |  4 +--
 .../XmlQueryRuntime.xml                       |  2 +-
 .../XmlSortKeyAccumulator.xml                 |  2 +-
 xml/System.Xml/XmlConvert.xml                 |  4 +--
 21 files changed, 53 insertions(+), 53 deletions(-)

diff --git a/xml/Microsoft.VisualBasic.FileIO/TextFieldParser.xml b/xml/Microsoft.VisualBasic.FileIO/TextFieldParser.xml
index 6bc109c4c49..10032b0a001 100644
--- a/xml/Microsoft.VisualBasic.FileIO/TextFieldParser.xml
+++ b/xml/Microsoft.VisualBasic.FileIO/TextFieldParser.xml
@@ -1105,7 +1105,7 @@
       </Parameters>
       <Docs>
         <param name="numberOfChars">
-          <see langword="Int32" />. Number of characters to read. Required.</param>
+          <see cref="T:System.Int32" />. 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
index 85671363f4a..1ca3db5cd4d 100644
--- 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 <see cref="T:System.Int32" />.</param>
+        <summary>Converts an <see cref="T:System.Data.OracleClient.OracleMonthSpan" /> structure to an <see cref="T:System.Int32" />.</summary>
+        <returns>An <see cref="T:System.Int32" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
diff --git a/xml/System.Data.OracleClient/OracleNumber.xml b/xml/System.Data.OracleClient/OracleNumber.xml
index 91da6f90d37..8d31bf8bb67 100644
--- 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 <see cref="T:System.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 cref="T:System.Int32" /> structure.</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 <see cref="T:System.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 cref="T:System.Int32" /> structure.</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
index dd586ea39e1..82cbf843fec 100644
--- 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
index dad8f060b96..4296fcefd85 100644
--- 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
index fca848687d5..83aac7e28d2 100644
--- 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
index adc1edf12e2..0b3994b2cf9 100644
--- 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
index 348dbc18fe6..03d912781c0 100644
--- 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
index 6fe9779289a..1a48e1c1d1e 100644
--- 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
index 550c4b46e0c..0ec1d418ae5 100644
--- 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
index 889c198972e..8f1919481d7 100644
--- 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
index 3ddeb9dbd34..b0c0134a40d 100644
--- 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
index 9e021d04f34..ece893e0c64 100644
--- 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
index 34b57f7bb0c..369158fce71 100644
--- 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
index 546adc635d0..da5c9f5a1ab 100644
--- 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
index c7307382e3b..7370575f252 100644
--- a/xml/System.Xml.Xsl.Runtime/XmlILStorageConverter.xml
+++ b/xml/System.Xml.Xsl.Runtime/XmlILStorageConverter.xml
@@ -56,7 +56,7 @@
       </Parameters>
       <Docs>
         <param name="value">The <see langword="Boolean" /> value to convert.</param>
-        <param name="index">A value of type <see langword="Int32" /> that provides the index of the item to convert.</param>
+        <param name="index">A value of type <see cref="T:System.Int32" /> that provides the index of the item to convert.</param>
         <param name="runtime">An instance of the <see cref="T:System.Xml.Xsl.Runtime.XmlQueryRuntime" /> class.</param>
         <summary>Converts a Boolean value to an <see cref="T:System.Xml.Schema.XmlAtomicValue" />.</summary>
         <returns>The <see cref="T:System.Xml.Schema.XmlAtomicValue" /> object for the <see langword="Boolean" /> value.</returns>
@@ -91,7 +91,7 @@
       </Parameters>
       <Docs>
         <param name="value">An array of <see langword="Byte" /> to convert.</param>
-        <param name="index">A value of type <see langword="Int32" /> that provides the index of the item to convert.</param>
+        <param name="index">A value of type <see cref="T:System.Int32" /> that provides the index of the item to convert.</param>
         <param name="runtime">An instance of the <see cref="T:System.Xml.Xsl.Runtime.XmlQueryRuntime" /> class.</param>
         <summary>Converts an array of bytes to an <see cref="T:System.Xml.Schema.XmlAtomicValue" />.</summary>
         <returns>The <see cref="T:System.Xml.Schema.XmlAtomicValue" /> object for the <see langword="Byte" /> array.</returns>
@@ -126,7 +126,7 @@
       </Parameters>
       <Docs>
         <param name="value">A value of type <see langword="DateTime" /> to convert.</param>
-        <param name="index">A value of type <see langword="Int32" /> that provides the index of the item to convert.</param>
+        <param name="index">A value of type <see cref="T:System.Int32" /> that provides the index of the item to convert.</param>
         <param name="runtime">An instance of the <see cref="T:System.Xml.Xsl.Runtime.XmlQueryRuntime" /> class.</param>
         <summary>Converts a <see langword="DateTime" /> value to an <see cref="T:System.Xml.Schema.XmlAtomicValue" />.</summary>
         <returns>The <see cref="T:System.Xml.Schema.XmlAtomicValue" /> object for the <see langword="DateTime" /> value.</returns>
@@ -161,7 +161,7 @@
       </Parameters>
       <Docs>
         <param name="value">A value of type <see langword="Decimal" /> to convert.</param>
-        <param name="index">A value of type <see langword="Int32" /> that provides the index of the item to convert.</param>
+        <param name="index">A value of type <see cref="T:System.Int32" /> that provides the index of the item to convert.</param>
         <param name="runtime">An instance of the <see cref="T:System.Xml.Xsl.Runtime.XmlQueryRuntime" /> class.</param>
         <summary>Converts a decimal value to an <see cref="T:System.Xml.Schema.XmlAtomicValue" />.</summary>
         <returns>The <see cref="T:System.Xml.Schema.XmlAtomicValue" /> object for the <see langword="Decimal" /> value.</returns>
@@ -196,7 +196,7 @@
       </Parameters>
       <Docs>
         <param name="value">A value of type <see langword="Double" /> to convert.</param>
-        <param name="index">A value of type <see langword="Int32" /> that provides the index of the item to convert.</param>
+        <param name="index">A value of type <see cref="T:System.Int32" /> that provides the index of the item to convert.</param>
         <param name="runtime">An instance of the <see cref="T:System.Xml.Xsl.Runtime.XmlQueryRuntime" /> class.</param>
         <summary>Converts a <see langword="Double" /> value to an <see cref="T:System.Xml.Schema.XmlAtomicValue" />.</summary>
         <returns>The <see cref="T:System.Xml.Schema.XmlAtomicValue" /> object for the <see langword="Double" /> value.</returns>
@@ -230,11 +230,11 @@
         <Parameter Name="runtime" Type="System.Xml.Xsl.Runtime.XmlQueryRuntime" />
       </Parameters>
       <Docs>
-        <param name="value">A value of type <see langword="Int32" /> to convert.</param>
-        <param name="index">A value of type <see langword="Int32" /> that provides the index of the item to convert.</param>
+        <param name="value">A value of type <see cref="T:System.Int32" /> to convert.</param>
+        <param name="index">A value of type <see cref="T:System.Int32" /> that provides the index of the item to convert.</param>
         <param name="runtime">An instance of the <see cref="T:System.Xml.Xsl.Runtime.XmlQueryRuntime" /> class.</param>
-        <summary>Converts an <see langword="Int32" /> value to an <see cref="T:System.Xml.Schema.XmlAtomicValue" />.</summary>
-        <returns>The <see cref="T:System.Xml.Schema.XmlAtomicValue" /> object for the <see langword="Int32" /> value.</returns>
+        <summary>Converts an <see cref="T:System.Int32" /> value to an <see cref="T:System.Xml.Schema.XmlAtomicValue" />.</summary>
+        <returns>The <see cref="T:System.Xml.Schema.XmlAtomicValue" /> object for the <see cref="T:System.Int32" /> value.</returns>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
       </Docs>
@@ -266,7 +266,7 @@
       </Parameters>
       <Docs>
         <param name="value">A value of type <see langword="Int64" /> to convert.</param>
-        <param name="index">A value of type <see langword="Int32" /> that provides the index of the item to convert.</param>
+        <param name="index">A value of type <see cref="T:System.Int32" /> that provides the index of the item to convert.</param>
         <param name="runtime">An instance of the <see cref="T:System.Xml.Xsl.Runtime.XmlQueryRuntime" /> class.</param>
         <summary>Converts an <see langword="Int64" /> value to an <see cref="T:System.Xml.Schema.XmlAtomicValue" />.</summary>
         <returns>The <see cref="T:System.Xml.Schema.XmlAtomicValue" /> object for the <see langword="Int64" /> value.</returns>
@@ -363,7 +363,7 @@
       </Parameters>
       <Docs>
         <param name="value">A value of type <see langword="Single" /> to convert.</param>
-        <param name="index">A value of type <see langword="Int32" /> that provides the index of the item to convert.</param>
+        <param name="index">A value of type <see cref="T:System.Int32" /> that provides the index of the item to convert.</param>
         <param name="runtime">An instance of the <see cref="T:System.Xml.Xsl.Runtime.XmlQueryRuntime" /> class.</param>
         <summary>Converts a <see langword="Single" /> value to an <see cref="T:System.Xml.Schema.XmlAtomicValue" />.</summary>
         <returns>The <see cref="T:System.Xml.Schema.XmlAtomicValue" /> object for the <see langword="Single" /> value.</returns>
@@ -398,7 +398,7 @@
       </Parameters>
       <Docs>
         <param name="value">A value of type <see langword="String" /> to convert.</param>
-        <param name="index">A value of type <see langword="Int32" /> that provides the index of the item to convert.</param>
+        <param name="index">A value of type <see cref="T:System.Int32" /> that provides the index of the item to convert.</param>
         <param name="runtime">An instance of the <see cref="T:System.Xml.Xsl.Runtime.XmlQueryRuntime" /> class.</param>
         <summary>Converts a string value to an <see cref="T:System.Xml.Schema.XmlAtomicValue" />.</summary>
         <returns>The <see cref="T:System.Xml.Schema.XmlAtomicValue" /> object for the <see langword="String" /> value.</returns>
@@ -433,7 +433,7 @@
       </Parameters>
       <Docs>
         <param name="value">A value of type <see cref="T:System.TimeSpan" /> to convert.</param>
-        <param name="index">A value of type <see langword="Int32" /> that provides the index of the item to convert.</param>
+        <param name="index">A value of type <see cref="T:System.Int32" /> that provides the index of the item to convert.</param>
         <param name="runtime">An instance of the <see cref="T:System.Xml.Xsl.Runtime.XmlQueryRuntime" /> class.</param>
         <summary>Converts a <see cref="T:System.TimeSpan" /> value to an <see cref="T:System.Xml.Schema.XmlAtomicValue" />.</summary>
         <returns>The <see cref="T:System.Xml.Schema.XmlAtomicValue" /> object for the <see langword="TimeSpan" /> value.</returns>
@@ -468,7 +468,7 @@
       </Parameters>
       <Docs>
         <param name="value">An instance of the <see cref="T:System.Xml.XmlQualifiedName" /> class to convert.</param>
-        <param name="index">A value of type <see langword="Int32" /> that provides the index of the item to convert.</param>
+        <param name="index">A value of type <see cref="T:System.Int32" /> that provides the index of the item to convert.</param>
         <param name="runtime">An instance of the <see cref="T:System.Xml.Xsl.Runtime.XmlQueryRuntime" /> class.</param>
         <summary>Converts an <see cref="T:System.Xml.XmlQualifiedName" /> value to an <see cref="T:System.Xml.Schema.XmlAtomicValue" />.</summary>
         <returns>The <see cref="T:System.Xml.Schema.XmlAtomicValue" /> object for the <see langword="XmlQualifiedName" /> value.</returns>
diff --git a/xml/System.Xml.Xsl.Runtime/XmlQueryItemSequence.xml b/xml/System.Xml.Xsl.Runtime/XmlQueryItemSequence.xml
index b9cf5a81cff..3768529e5d2 100644
--- a/xml/System.Xml.Xsl.Runtime/XmlQueryItemSequence.xml
+++ b/xml/System.Xml.Xsl.Runtime/XmlQueryItemSequence.xml
@@ -95,7 +95,7 @@
         <Parameter Name="capacity" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="capacity">A value of type <see langword="Int32" />.</param>
+        <param name="capacity">A value of type <see cref="T:System.Int32" />.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Xml.Xsl.Runtime.XmlQueryItemSequence" /> class.</summary>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
diff --git a/xml/System.Xml.Xsl.Runtime/XmlQueryNodeSequence.xml b/xml/System.Xml.Xsl.Runtime/XmlQueryNodeSequence.xml
index 7542308ac27..9ba324f59cf 100644
--- a/xml/System.Xml.Xsl.Runtime/XmlQueryNodeSequence.xml
+++ b/xml/System.Xml.Xsl.Runtime/XmlQueryNodeSequence.xml
@@ -141,7 +141,7 @@
         <Parameter Name="capacity" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="capacity">A value of type <see langword="Int32" />.</param>
+        <param name="capacity">A value of type <see cref="T:System.Int32" />.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Xml.Xsl.Runtime.XmlQueryNodeSequence" /> class.</summary>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
@@ -760,7 +760,7 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="index">A value of type <see langword="Int32" />.</param>
+        <param name="index">A value of type <see cref="T:System.Int32" />.</param>
         <summary>Returns the item at the specified index.</summary>
         <value>An instance of the <see cref="T:System.Xml.XPath.XPathItem" /> class.</value>
         <remarks>To be added.</remarks>
diff --git a/xml/System.Xml.Xsl.Runtime/XmlQueryRuntime.xml b/xml/System.Xml.Xsl.Runtime/XmlQueryRuntime.xml
index 6e781c89021..c939d31f9ab 100644
--- a/xml/System.Xml.Xsl.Runtime/XmlQueryRuntime.xml
+++ b/xml/System.Xml.Xsl.Runtime/XmlQueryRuntime.xml
@@ -87,7 +87,7 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <param name="indexType">A value of type <see langword="Int32" />.</param>
+        <param name="indexType">A value of type <see cref="T:System.Int32" />.</param>
         <param name="value">A value of type <see langword="object" />.</param>
         <param name="destinationType">A value of type <see langword="Type" />.</param>
         <summary>Converts a value from the CLR type of the <paramref name="value" /> parameter to CLR <paramref name="destinationType" /> by using V1 XSLT rules. Converts any result tree fragment values to nodes.</summary>
diff --git a/xml/System.Xml.Xsl.Runtime/XmlSortKeyAccumulator.xml b/xml/System.Xml.Xsl.Runtime/XmlSortKeyAccumulator.xml
index 4a335407f84..c7e50edbe08 100644
--- a/xml/System.Xml.Xsl.Runtime/XmlSortKeyAccumulator.xml
+++ b/xml/System.Xml.Xsl.Runtime/XmlSortKeyAccumulator.xml
@@ -213,7 +213,7 @@
       </Parameters>
       <Docs>
         <param name="collation">An instance of the <see cref="T:System.Xml.Xsl.Runtime.XmlCollation" /> class.</param>
-        <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>Creates a new <see cref="T:System.Int32" /> sort key and appends it to the current run of sort keys.</summary>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
diff --git a/xml/System.Xml/XmlConvert.xml b/xml/System.Xml/XmlConvert.xml
index 7289369406b..3e5cbbcd0d6 100644
--- a/xml/System.Xml/XmlConvert.xml
+++ b/xml/System.Xml/XmlConvert.xml
@@ -1488,7 +1488,7 @@ writer.WriteElementString(XmlConvert.EncodeName("Order Detail"),"My order");
       <Docs>
         <param name="s">The string to convert.</param>
         <summary>Converts the <see cref="T:System.String" /> to a <see cref="T:System.Int32" /> equivalent.</summary>
-        <returns>An <see langword="Int32" /> equivalent of the string.</returns>
+        <returns>An <see cref="T:System.Int32" /> equivalent of the string.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is <see langword="null" />.</exception>
@@ -2135,7 +2135,7 @@ writer.WriteElementString(XmlConvert.EncodeName("Order Detail"),"My order");
       <Docs>
         <param name="value">The value to convert.</param>
         <summary>Converts the <see cref="T:System.Int32" /> to a <see cref="T:System.String" />.</summary>
-        <returns>A string representation of the <see langword="Int32" />.</returns>
+        <returns>A string representation of the <see cref="T:System.Int32" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

From a7d8490d50a9ea48e42440c85cb911d11aa54550 Mon Sep 17 00:00:00 2001
From: Next Turn <45985406+NextTurn@users.noreply.github.com>
Date: Fri, 14 Feb 2020 10:14:01 +0800
Subject: [PATCH 2/2] Apply suggestions from code review

Co-Authored-By: Maira Wenzel <mairaw@microsoft.com>
---
 xml/Microsoft.VisualBasic.FileIO/TextFieldParser.xml | 3 +--
 xml/System.Data.OracleClient/OracleMonthSpan.xml     | 4 ++--
 xml/System.Data.OracleClient/OracleNumber.xml        | 8 ++++----
 3 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/xml/Microsoft.VisualBasic.FileIO/TextFieldParser.xml b/xml/Microsoft.VisualBasic.FileIO/TextFieldParser.xml
index 10032b0a001..b55e6c79cbf 100644
--- 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 cref="T:System.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
index 1ca3db5cd4d..d6af63fb179 100644
--- 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 cref="T:System.Int32" />.</param>
+        <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 <see cref="T:System.Int32" />.</returns>
+        <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
index 8d31bf8bb67..b1f3a787e4b 100644
--- a/xml/System.Data.OracleClient/OracleNumber.xml
+++ b/xml/System.Data.OracleClient/OracleNumber.xml
@@ -1616,8 +1616,8 @@ Console.WriteLine(i);
       </Parameters>
       <Docs>
         <param name="x">The integer structure to be converted.</param>
-        <summary>Converts the supplied <see cref="T:System.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 cref="T:System.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 cref="T:System.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 cref="T:System.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>