Merge branch 'master' into publish-7102

Author: cxwtool

samples/snippets/csharp/VS_Snippets_CLR_Classic/classic FieldOffsetAttribute Example/CS/source.cs

@@ -3,7 +3,7 @@
 
 // <Snippet1>
  [StructLayout(LayoutKind.Explicit)]
- public class SYSTEM_INFO
+ public struct SYSTEM_INFO
  {
  [FieldOffset(0)] public ulong OemId;
  [FieldOffset(8)] public ulong PageSize;

xml/System.ComponentModel.DataAnnotations/IValidatableObject.xml

@@ -24,8 +24,8 @@
   </TypeForwardingChain>
   <Interfaces />
   <Docs>
-    <summary>Provides a way for an object to be invalidated.</summary>
-    <remarks>To be added.</remarks>
+    <summary>Provides a way for an object to be validated.</summary>
+    <remarks>Instances of types that implement this interface can be checked to determine if they are valid.</remarks>
   </Docs>
   <Members>
     <Member MemberName="Validate">

xml/System.Composition/ImportAttribute.xml

@@ -24,7 +24,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>Specifies that a property, field, or parameter value should be provided by the host container.</summary>
+    <summary>Specifies that a property or parameter value should be provided by the host container.</summary>
     <remarks>
     </remarks>
   </Docs>
@@ -100,9 +100,9 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets or sets a value that indicates whether the property, field, or parameter will be set to its type's default value when an export with the contract name is not present in the container.</summary>
+        <summary>Gets or sets a value that indicates whether the property or parameter will be set to its type's default value when an export with the contract name is not present in the container.</summary>
         <value>
-          <see langword="true" /> if the property, field, or parameter will be set to its type's default value when there is no export with the contract name in the host container; otherwise, <see langword="false" />. The default is <see langword="false" />.</value>
+          <see langword="true" /> if the property or parameter will be set to its type's default value when there is no export with the contract name in the host container; otherwise, <see langword="false" />. The default is <see langword="false" />.</value>
         <remarks>
         </remarks>
       </Docs>

xml/System.Data.Common/DbDataReader.xml

@@ -599,7 +599,7 @@
         <param name="dataOffset">The index within the row from which to begin the read operation.</param>
         <param name="buffer">The buffer into which to copy the data.</param>
         <param name="bufferOffset">The index with the buffer to which the data will be copied.</param>
-        <param name="length">The maximum number of characters to read.</param>
+        <param name="length">The maximum number of bytes to read.</param>
         <summary>When overridden in a derived class, reads a specified number of bytes from the specified column starting at a specified index and writes them to a buffer starting at a specified position in the buffer.</summary>
         <returns>The actual number of bytes read.</returns>
         <remarks>To be added.</remarks>

xml/System.Drawing/Point.xml

@@ -84,7 +84,7 @@
         <AssemblyVersion>4.1.0.0</AssemblyVersion>
       </AssemblyInfo>
       <Docs>
-        <summary>Initializes a new instance of the <see cref="T:System.Drawing.Point" /> class with the specified coordinates.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.Drawing.Point" /> struct with the specified coordinates.</summary>
       </Docs>
     </MemberGroup>
     <Member MemberName=".ctor">
@@ -119,7 +119,7 @@
       </Parameters>
       <Docs>
         <param name="sz">A <see cref="T:System.Drawing.Size" /> that specifies the coordinates for the new <see cref="T:System.Drawing.Point" />.</param>
-        <summary>Initializes a new instance of the <see cref="T:System.Drawing.Point" /> class from a <see cref="T:System.Drawing.Size" />.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.Drawing.Point" /> struct from a <see cref="T:System.Drawing.Size" />.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
@@ -166,7 +166,7 @@
       </Parameters>
       <Docs>
         <param name="dw">A 32-bit integer that specifies the coordinates for the new <see cref="T:System.Drawing.Point" />.</param>
-        <summary>Initializes a new instance of the <see cref="T:System.Drawing.Point" /> class using coordinates specified by an integer value.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.Drawing.Point" /> struct using coordinates specified by an integer value.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
@@ -225,7 +225,7 @@
       <Docs>
         <param name="x">The horizontal position of the point.</param>
         <param name="y">The vertical position of the point.</param>
-        <summary>Initializes a new instance of the <see cref="T:System.Drawing.Point" /> class with the specified coordinates.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.Drawing.Point" /> struct with the specified coordinates.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   

xml/System.IO/Path.xml

@@ -1643,7 +1643,7 @@ Possible patterns for the string returned by this method are as follows:
 
 - An empty string (`path` specified a relative path on the current drive or volume).
 
-- "\" (Unix: `path` specified an absolute path on the current drive).
+- "/" (Unix: `path` specified an absolute path on the current drive).
 
 - "X:" (Windows: `path` specified a relative path on a drive, where *X* represents a drive or volume letter).
 

xml/System.Runtime.InteropServices/FieldOffsetAttribute.xml

@@ -57,7 +57,7 @@
    
   
 ## Examples  
- The following example demonstrates how to apply the <xref:System.Runtime.InteropServices.FieldOffsetAttribute> to members of a class with an explicit layout.  
+ The following example demonstrates how to apply the <xref:System.Runtime.InteropServices.FieldOffsetAttribute> to members of a struct or class with an explicit layout. 
   
  [!code-cpp[Classic FieldOffsetAttribute Example#1](~/samples/snippets/cpp/VS_Snippets_CLR_Classic/classic FieldOffsetAttribute Example/CPP/source.cpp#1)]
  [!code-csharp[Classic FieldOffsetAttribute Example#1](~/samples/snippets/csharp/VS_Snippets_CLR_Classic/classic FieldOffsetAttribute Example/CS/source.cs#1)]

xml/System.Threading/ManualResetEventSlim.xml

@@ -800,7 +800,7 @@
       </ReturnValue>
       <Docs>
         <summary>Gets the underlying <see cref="T:System.Threading.WaitHandle" /> object for this <see cref="T:System.Threading.ManualResetEventSlim" />.</summary>
-        <value>The underlying <see cref="T:System.Threading.WaitHandle" /> event object fore this <see cref="T:System.Threading.ManualResetEventSlim" />.</value>
+        <value>The underlying <see cref="T:System.Threading.WaitHandle" /> event object for this <see cref="T:System.Threading.ManualResetEventSlim" />.</value>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   

xml/System.Web.UI/ObjectStateFormatter.xml

@@ -324,6 +324,8 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+ Setting this property has no effect.
+  
  This member is an explicit interface member implementation. It can be used only when the <xref:System.Web.UI.ObjectStateFormatter> instance is cast to an <xref:System.Runtime.Serialization.IFormatter> interface.  
   
  ]]></format>
@@ -356,6 +358,8 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+ Setting this property has no effect.
+  
  This member is an explicit interface member implementation. It can be used only when the <xref:System.Web.UI.ObjectStateFormatter> instance is cast to an <xref:System.Runtime.Serialization.IFormatter> interface.  
   
  ]]></format>
@@ -471,6 +475,8 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
+ Setting this property has no effect.
+  
  This member is an explicit interface member implementation. It can be used only when the <xref:System.Web.UI.ObjectStateFormatter> instance is cast to an <xref:System.Runtime.Serialization.IFormatter> interface.  
   
  ]]></format>