Removing "see remarks" language (dotnet#2032)

* Initial commit

Update

Update

Update

* Removing more instances

Author: guardrex

xml/System.ComponentModel/PropertyDescriptor.xml

@@ -1187,11 +1187,9 @@
  ]]></format>
         </remarks>
         <block subset="none" type="overrides">
-          <para>When overridden in a derived class, this method returns <see langword="true" /> if the current value of the property is different from its default value. It looks for a default value by first looking for a <see cref="T:System.ComponentModel.DefaultValueAttribute" />. If the method finds this attribute, it compares the value of the attribute with the property's current value. If this method cannot find a <see cref="T:System.ComponentModel.DefaultValueAttribute" />, it looks for a "ShouldSerializeMyProperty" method that you need to implement. If it is found, <see cref="M:System.ComponentModel.PropertyDescriptor.ShouldSerializeValue(System.Object)" /> invokes it. If this method cannot find a <see cref="T:System.ComponentModel.DefaultValueAttribute" /> or a "ShouldSerializeMyProperty" method, it cannot create optimizations and it returns <see langword="true" />.  
-  
+          <para>When overridden in a derived class, this method returns <see langword="true" /> if the current value of the property is different from its default value. It looks for a default value by first looking for a <see cref="T:System.ComponentModel.DefaultValueAttribute" />. If the method finds this attribute, it compares the value of the attribute with the property's current value. If this method cannot find a <see cref="T:System.ComponentModel.DefaultValueAttribute" />, it looks for a "ShouldSerializeMyProperty" method that you need to implement. If it is found, <see cref="M:System.ComponentModel.PropertyDescriptor.ShouldSerializeValue(System.Object)" /> invokes it. If this method cannot find a <see cref="T:System.ComponentModel.DefaultValueAttribute" /> or a "ShouldSerializeMyProperty" method, it cannot create optimizations and it returns <see langword="true" />.
  <block subset="none" type="note"><para>  
- The <see cref="T:System.ComponentModel.Design.ComponentDesigner" /> class implements special serialization logic for inherited components. For more information, see the remarks in <see cref="T:System.ComponentModel.Design.ComponentDesigner" />.  
-  
+ The <see cref="T:System.ComponentModel.Design.ComponentDesigner" /> class implements special serialization logic for inherited components. For more information, see <see cref="T:System.ComponentModel.Design.ComponentDesigner" />.  
 </para></block></para>
         </block>
       </Docs>

xml/System.ComponentModel/PropertyFilterOptions.xml

@@ -57,7 +57,7 @@
         <ReturnType>System.ComponentModel.PropertyFilterOptions</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Return only those properties that are not valid given the current context of the object. See Remarks.</summary>
+        <summary>Return only those properties that are not valid given the current context of the object.</summary>
       </Docs>
     </Member>
     <Member MemberName="None">
@@ -121,7 +121,7 @@
         <ReturnType>System.ComponentModel.PropertyFilterOptions</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Return any property that is valid on the  object in the current scope. See Remarks.</summary>
+        <summary>Return any property that is valid on the  object in the current scope.</summary>
       </Docs>
     </Member>
   </Members>

xml/System.Data.Common/DbDataReader.xml

@@ -798,7 +798,7 @@ private static void GetDataTypes(String connectiongString) {
         <Parameter Name="ordinal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <typeparam name="T">The type of the value to be returned. See the remarks section for more information.</typeparam>
+        <typeparam name="T">The type of the value to be returned.</typeparam>
         <param name="ordinal">The type of the value to be returned.</param>
         <summary>Asynchronously gets the value of the specified column as a type.</summary>
         <returns>The type of the value to be returned.</returns>
@@ -862,7 +862,7 @@ private static void GetDataTypes(String connectiongString) {
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <typeparam name="T">The type of the value to be returned. See the remarks section for more information.</typeparam>
+        <typeparam name="T">The type of the value to be returned.</typeparam>
         <param name="ordinal">The type of the value to be returned.</param>
         <param name="cancellationToken">The cancellation instruction, which propagates a notification that operations should be canceled. This does not guarantee the cancellation. A setting of <see langword="CancellationToken.None" /> makes this method equivalent to <see cref="M:System.Data.Common.DbDataReader.GetFieldValueAsync``1(System.Int32)" />. The returned task must be marked as cancelled.</param>
         <summary>Asynchronously gets the value of the specified column as a type.</summary>

xml/System.Data.Linq.Mapping/ColumnAttribute.xml

@@ -174,7 +174,7 @@ public class Employees
       </ReturnValue>
       <Docs>
         <summary>Gets or sets the type of the database column.</summary>
-        <value>See Remarks.</value>
+        <value>String value that specifies the exact text that defines the column in a Transact-SQL table declaration.</value>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   

xml/System.Data.SqlClient/SqlDataReader.xml

@@ -716,7 +716,7 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <typeparam name="T">The type of the value to be returned. See the remarks section for more information.</typeparam>
+        <typeparam name="T">The type of the value to be returned.</typeparam>
         <param name="i">The column to be retrieved.</param>
         <summary>Synchronously gets the value of the specified column as a type. <see cref="M:System.Data.SqlClient.SqlDataReader.GetFieldValueAsync``1(System.Int32,System.Threading.CancellationToken)" /> is the asynchronous version of this method.</summary>
         <returns>The returned type object.</returns>
@@ -784,7 +784,7 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <typeparam name="T">The type of the value to be returned. See the remarks section for more information.</typeparam>
+        <typeparam name="T">The type of the value to be returned.</typeparam>
         <param name="i">The column to be retrieved.</param>
         <param name="cancellationToken">The cancellation instruction, which propagates a notification that operations should be canceled. This does not guarantee the cancellation. A setting of <see langword="CancellationToken.None" /> makes this method equivalent to <see cref="M:System.Data.SqlClient.SqlDataReader.IsDBNull(System.Int32)" />. The returned task must be marked as cancelled.</param>
         <summary>Asynchronously gets the value of the specified column as a type. <see cref="M:System.Data.SqlClient.SqlDataReader.GetFieldValue``1(System.Int32)" /> is the synchronous version of this method.</summary>

xml/System.Data/DataView.xml

@@ -1101,7 +1101,7 @@
       </ReturnValue>
       <Docs>
         <summary>Gets or sets the expression used to filter which rows are viewed in the <see cref="T:System.Data.DataView" />.</summary>
-        <value>A string that specifies how rows are to be filtered. For more information, see the Remarks section.</value>
+        <value>A string that specifies how rows are to be filtered.</value>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   

xml/System.Diagnostics.Tracing/EventSource.xml

@@ -616,7 +616,7 @@
         <param name="assemblyPathToIncludeInManifest">The path to the assembly file (.dll) file to include in the [provider](http://msdn.microsoft.com/library/windows/desktop/aa384022\(v=vs.85\).aspx) element of the manifest.</param>
         <param name="flags">A bitwise combination of the enumeration values that specify how the manifest is generated.</param>
         <summary>Returns a string of the XML manifest that is associated with the current event source.</summary>
-        <returns>The XML data string or <see langword="null" /> (see remarks).</returns>
+        <returns>The XML data string or <see langword="null" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   

xml/System.Diagnostics/Debug.xml

@@ -329,7 +329,7 @@
       <Docs>
         <param name="condition">The conditional expression to evaluate. If the condition is <see langword="true" />, the specified messages are not sent and the message box is not displayed.</param>
         <param name="message">The message to send to the <see cref="P:System.Diagnostics.Trace.Listeners" /> collection.</param>
-        <param name="detailMessageFormat">The composite format string (see Remarks) to send to the <see cref="P:System.Diagnostics.Trace.Listeners" /> collection. This message contains text intermixed with zero or more format items, which correspond to objects in the <c>args</c> array.</param>
+        <param name="detailMessageFormat">The composite format string to send to the <see cref="P:System.Diagnostics.Trace.Listeners" /> collection. This message contains text intermixed with zero or more format items, which correspond to objects in the <c>args</c> array.</param>
         <param name="args">An object array that contains zero or more objects to format.</param>
         <summary>Checks for a condition; if the condition is <see langword="false" />, outputs two messages (simple and formatted) and displays a message box that shows the call stack.</summary>
         <remarks>
@@ -872,7 +872,7 @@ End of list of errors
         </Parameter>
       </Parameters>
       <Docs>
-        <param name="format">A composite format string (see Remarks) that contains text intermixed with zero or more format items, which correspond to objects in the <c>args</c> array.</param>
+        <param name="format">A composite format string that contains text intermixed with zero or more format items, which correspond to objects in the <c>args</c> array.</param>
         <param name="args">An object array containing zero or more objects to format.</param>
         <summary>Writes a formatted string followed by a line terminator to the trace listeners in the <see cref="P:System.Diagnostics.Debug.Listeners" /> collection.</summary>
         <remarks>
@@ -1702,7 +1702,7 @@ Debug.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");
         </Parameter>
       </Parameters>
       <Docs>
-        <param name="format">A composite format string (see Remarks) that contains text intermixed with zero or more format items, which correspond to objects in the <c>args</c> array.</param>
+        <param name="format">A composite format string that contains text intermixed with zero or more format items, which correspond to objects in the <c>args</c> array.</param>
         <param name="args">An object array that contains zero or more objects to format.</param>
         <summary>Writes a formatted message followed by a line terminator to the trace listeners in the <see cref="P:System.Diagnostics.Debug.Listeners" /> collection.</summary>
         <remarks>

xml/System.Diagnostics/TraceSource.xml

@@ -783,7 +783,7 @@
       <Docs>
         <param name="eventType">One of the enumeration values that specifies the event type of the trace data.</param>
         <param name="id">A numeric identifier for the event.</param>
-        <param name="format">A composite format string (see Remarks) that contains text intermixed with zero or more format items, which correspond to objects in the <c>args</c> array.</param>
+        <param name="format">A composite format string that contains text intermixed with zero or more format items, which correspond to objects in the <c>args</c> array.</param>
         <param name="args">An <see langword="object" /> array containing zero or more objects to format.</param>
         <summary>Writes a trace event to the trace listeners in the <see cref="P:System.Diagnostics.TraceSource.Listeners" /> collection using the specified event type, event identifier, and argument array and format.</summary>
         <remarks>
@@ -904,7 +904,7 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <param name="format">A composite format string (see Remarks) that contains text intermixed with zero or more format items, which correspond to objects in the <c>args</c> array.</param>
+        <param name="format">A composite format string that contains text intermixed with zero or more format items, which correspond to objects in the <c>args</c> array.</param>
         <param name="args">An array containing zero or more objects to format.</param>
         <summary>Writes an informational message to the trace listeners in the <see cref="P:System.Diagnostics.TraceSource.Listeners" /> collection using the specified object array and formatting information.</summary>
         <remarks>

xml/System.DirectoryServices.ActiveDirectory/Domain.xml

@@ -55,7 +55,7 @@
       <Docs>
         <param name="targetDomainName">The DNS name of the domain that the trust is created with.</param>
         <param name="direction">One of the <see cref="T:System.DirectoryServices.ActiveDirectory.TrustDirection" /> members that determines the direction of the trust, relative to this domain.</param>
-        <param name="trustPassword">The password for the trust. See remarks below.</param>
+        <param name="trustPassword">The password for the trust.</param>
         <summary>Creates the local side of a trust relationship with the specified domain.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[  

xml/System.DirectoryServices.ActiveDirectory/Forest.xml

@@ -61,7 +61,7 @@
       <Docs>
         <param name="targetForestName">The DNS name of the forest that the trust is created with.</param>
         <param name="direction">One of the <see cref="T:System.DirectoryServices.ActiveDirectory.TrustDirection" /> members that determines the direction of the trust, relative to this forest.</param>
-        <param name="trustPassword">The password for the trust. See the Remarks section for more information.</param>
+        <param name="trustPassword">The password for the trust.</param>
         <summary>Creates the local side of a trust relationship with the specified forest.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[  
@@ -609,7 +609,7 @@
       </Parameters>
       <Docs>
         <param name="targetForestName">The DNS name of the <see cref="T:System.DirectoryServices.ActiveDirectory.Forest" /> with which the inbound trust relationship exists.</param>
-        <summary>Gets a Boolean value that indicates whether selective authentication is enabled on the inbound trust relationship with the specified forest.  <see langword="true" /> if selective authentication is enabled; otherwise, <see langword="false" />. For more information, see the Remarks section.</summary>
+        <summary>Gets a Boolean value that indicates whether selective authentication is enabled on the inbound trust relationship with the specified forest.  <see langword="true" /> if selective authentication is enabled; otherwise, <see langword="false" />.</summary>
         <returns>
           <see langword="true" /> if selective authentication is enabled; otherwise, <see langword="false" />.</returns>
         <remarks>

xml/System.Globalization/PersianCalendar.xml

@@ -899,7 +899,7 @@
       </ReturnValue>
       <Docs>
         <summary>Gets the latest date and time supported by the <see cref="T:System.Globalization.PersianCalendar" /> class.</summary>
-        <value>The latest date and time supported by the <see cref="T:System.Globalization.PersianCalendar" /> class. See the Remarks section for more information.</value>
+        <value>The latest date and time supported by the <see cref="T:System.Globalization.PersianCalendar" /> class.</value>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
@@ -943,7 +943,7 @@
       </ReturnValue>
       <Docs>
         <summary>Gets the earliest date and time supported by the <see cref="T:System.Globalization.PersianCalendar" /> class.</summary>
-        <value>The earliest date and time supported by the <see cref="T:System.Globalization.PersianCalendar" /> class. See the Remarks section for more information.</value>
+        <value>The earliest date and time supported by the <see cref="T:System.Globalization.PersianCalendar" /> class.</value>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   

xml/System.IO.Compression/DeflateStream.xml

@@ -355,7 +355,7 @@
         <param name="count">The maximum number of bytes to read.</param>
         <param name="cback">To be added.</param>
         <param name="state">To be added.</param>
-        <summary>Begins an asynchronous read operation. (Consider using the <see cref="M:System.IO.Stream.ReadAsync(System.Byte[],System.Int32,System.Int32)" /> method instead; see the Remarks section.)</summary>
+        <summary>Begins an asynchronous read operation. (Consider using the <see cref="M:System.IO.Stream.ReadAsync(System.Byte[],System.Int32,System.Int32)" /> method instead.)</summary>
         <returns>An  object that represents the asynchronous read operation, which could still be pending.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
@@ -412,7 +412,7 @@
         <param name="count">The maximum number of bytes to write.</param>
         <param name="cback">To be added.</param>
         <param name="state">To be added.</param>
-        <summary>Begins an asynchronous write operation. (Consider using the <see cref="M:System.IO.Stream.WriteAsync(System.Byte[],System.Int32,System.Int32)" /> method instead; see the Remarks section.)</summary>
+        <summary>Begins an asynchronous write operation. (Consider using the <see cref="M:System.IO.Stream.WriteAsync(System.Byte[],System.Int32,System.Int32)" /> method instead.)</summary>
         <returns>An  object that represents the asynchronous write operation, which could still be pending.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
@@ -595,7 +595,7 @@
       </Parameters>
       <Docs>
         <param name="async_result">To be added.</param>
-        <summary>Waits for the pending asynchronous read to complete. (Consider using the <see cref="M:System.IO.Stream.ReadAsync(System.Byte[],System.Int32,System.Int32)" /> method instead; see the Remarks section.)</summary>
+        <summary>Waits for the pending asynchronous read to complete. (Consider using the <see cref="M:System.IO.Stream.ReadAsync(System.Byte[],System.Int32,System.Int32)" /> method instead.)</summary>
         <returns>The number of bytes read from the stream, between 0 (zero) and the number of bytes you requested. <see cref="T:System.IO.Compression.DeflateStream" /> returns 0 only at the end of the stream; otherwise, it blocks until at least one byte is available.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
@@ -639,7 +639,7 @@
       </Parameters>
       <Docs>
         <param name="async_result">To be added.</param>
-        <summary>Ends an asynchronous write operation. (Consider using the <see cref="M:System.IO.Stream.WriteAsync(System.Byte[],System.Int32,System.Int32)" /> method instead; see the Remarks section.)</summary>
+        <summary>Ends an asynchronous write operation. (Consider using the <see cref="M:System.IO.Stream.WriteAsync(System.Byte[],System.Int32,System.Int32)" /> method instead.)</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[