Merge pull request #3765 from dotnet/master

Update live with current master

Author: mairaw

includes/csharp-interactive-note-some.md

@@ -193,12 +193,18 @@
         <Parameter Name="lpIDataObject" Type="Microsoft.CLRAdmin.IDataObject" />
       </Parameters>
       <Docs>
-        <param name="lpProvider">To be added.</param>
-        <param name="handle">To be added.</param>
-        <param name="lpIDataObject">To be added.</param>
-        <summary>This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.</summary>
-        <returns>To be added.</returns>
+        <param name="lpProvider">A pointer to the <see cref="T:Microsoft.CLRAdmin.IPropertySheetCallback" />.</param>
+        <param name="handle">The handle to use to route the notification message to the appropriate <see cref="T:Microsoft.CLRAdmin.IComponent" /> or <see cref="T:Microsoft.CLRAdmin.IComponentData" />.</param>
+        <param name="lpIDataObject">A pointer to the <see cref="T:Microsoft.CLRAdmin.IDataObject" /> on the object containing context information about the scope or result item.</param>
+        <summary>Adds pages to a property sheet.</summary>
+        <returns>| Return Value | Description |
+| --- | --- |
+| S\_OK | The <see cref="M:Microsoft.CLRAdmin.CData.CreatePropertyPages(Microsoft.CLRAdmin.IPropertySheetCallback,System.IntPtr,Microsoft.CLRAdmin.IDataObject)" /> method successfully added the property sheet pages. |
+| S\_FALSE | The <see cref="M:Microsoft.CLRAdmin.CData.CreatePropertyPages(Microsoft.CLRAdmin.IPropertySheetCallback,System.IntPtr,Microsoft.CLRAdmin.IDataObject)" /> method added no property sheet pages. |
+| E\_UNEXPECTED | An unexpected error occurred. |
+| E\_INVALIDARG | One or more parameters are not valid. |</returns>
         <remarks>To be added.</remarks>
+        <forInternalUseOnly />
       </Docs>
     </Member>
     <Member MemberName="Destroy">
@@ -278,14 +284,17 @@
         <Parameter Name="bStretch" Type="System.Int32" RefType="out" />
       </Parameters>
       <Docs>
-        <param name="lpIDataObject">To be added.</param>
-        <param name="lphWatermark">To be added.</param>
-        <param name="lphHeader">To be added.</param>
-        <param name="lphPalette">To be added.</param>
-        <param name="bStretch">To be added.</param>
-        <summary>This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.</summary>
-        <returns>To be added.</returns>
+        <param name="lpIDataObject">The <see cref="T:Microsoft.CLRAdmin.IDataObject" /> on the object containing context information about the scope or result item.</param>
+        <param name="lphWatermark">When this method returns, the handle to a bitmap that serves as the watermark for Wizard 97 pages.</param>
+        <param name="lphHeader">When this method returns, the handle to a bitmap that serves as the header for Wizard 97 pages.</param>
+        <param name="lphPalette">When this method returns, the handle to a palette used for the bitmaps specified by <paramref name="lphWatermark" /> and <paramref name="lphHeader" />.</param>
+        <param name="bStretch">When this method returns, <see langword="true" /> if the watermark and header bitmaps should be stretched rather than tiled; otherwise, <see langword="false" />.</param>
+        <summary>Retrieves the watermark and header bitmaps for wizard sheets that are implemented as Wizard 97-style wizards.</summary>
+        <returns>| Return Value | Description |
+| --- | --- |
+| etch | <see langword="true" /> if the watermark and header bitmaps should be stretched rather than tiled; otherwise, <see langword="false" />. |</returns>
         <remarks>To be added.</remarks>
+        <forInternalUseOnly />
       </Docs>
     </Member>
     <Member MemberName="Initialize">
@@ -402,10 +411,16 @@
         <Parameter Name="lpDataObject" Type="Microsoft.CLRAdmin.IDataObject" />
       </Parameters>
       <Docs>
-        <param name="lpDataObject">To be added.</param>
-        <summary>This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.</summary>
-        <returns>To be added.</returns>
+        <param name="lpDataObject">A pointer to the <see cref="T:Microsoft.CLRAdmin.IDataObject" /> on the object containing context information about the scope or result item.</param>
+        <summary>Determines whether the object requires pages.</summary>
+        <returns>| Return value | Description |
+| --- | --- |
+| S\_OK | Properties exist for this data object. |
+| E\_UNEXPECTED | An unexpected error occurred. |
+| E\_INVALID | The parameter is not valid. |
+| Any other error code | No pages are supplied for the data object. |</returns>
         <remarks>To be added.</remarks>
+        <forInternalUseOnly />
       </Docs>
     </Member>
   </Members>

includes/csharp-interactive-note.md

@@ -632,9 +632,9 @@
         <Parameter Name="itemName" Type="System.String" Index="0" FrameworkAlternate="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="itemName">To be added.</param>
-        <summary>This class, member, or property is internal to the script engine and should not be called from your code.</summary>
-        <returns>To be added.</returns>
+        <param name="itemName">The name of the item to get.</param>
+        <summary>Gets the item from the scope that is designated by the specified name.</summary>
+        <returns>The item with the specified name.</returns>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
       </Docs>
@@ -658,9 +658,9 @@
         <Parameter Name="index" Type="System.Int32" Index="0" FrameworkAlternate="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="index">To be added.</param>
-        <summary>This class, member, or property is internal to the script engine and should not be called from your code.</summary>
-        <returns>To be added.</returns>
+        <param name="index">The index of the item to get.</param>
+        <summary>Gets the item from the scope that is designated by the specified index value.</summary>
+        <returns>The item at the specified index.</returns>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
       </Docs>
@@ -684,8 +684,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>This class, member, or property is internal to the script engine and should not be called from your code.</summary>
-        <returns>To be added.</returns>
+        <summary>Gets the number of items in the scope.</summary>
+        <returns>The number of items in the scope.</returns>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
       </Docs>

xml/Microsoft.CLRAdmin/CData.xml

@@ -371,7 +371,7 @@
 ## Remarks  
  The `Click` event passes an <xref:System.EventArgs> to its event handler. Therefore it only indicates that a click has occurred. If you need more specific mouse information (button, number of clicks, wheel rotation, or location), use the <xref:System.Windows.Forms.Control.MouseClick> event. However, the <xref:System.Windows.Forms.Control.MouseClick> event will not be raised if the click is caused by action other than that of the mouse, such as pressing the ENTER key.  
   
- A double-click is determined by the mouse settings of the user's operating system. The user can set the time between clicks of a mouse button that should be considered a double-click instead of two clicks. The `Click` event is raised every time that a control is double-clicked. For example, if you have event handlers for the `Click` and <xref:System.Windows.Forms.Control.DoubleClick> events of a [control](ms-help://MS.VSCC.v90/MS.MSDNQTR.v90.en/fxref_system.windows.forms/html/6569d671-0a28-7b3f-dbb8-90c3d272b6e2.htm), the `Click` and <xref:System.Windows.Forms.Control.DoubleClick> events are raised when the control is double-clicked and both methods are called. If a control is double-clicked and that control does not support the <xref:System.Windows.Forms.Control.DoubleClick> event, the `Click` event might be raised two times.  
+ A double-click is determined by the mouse settings of the user's operating system. The user can set the time between clicks of a mouse button that should be considered a double-click instead of two clicks. The `Click` event is raised every time that a control is double-clicked. For example, if you have event handlers for the `Click` and <xref:System.Windows.Forms.Control.DoubleClick> events of a control, the `Click` and <xref:System.Windows.Forms.Control.DoubleClick> events are raised when the control is double-clicked and both methods are called. If a control is double-clicked and that control does not support the <xref:System.Windows.Forms.Control.DoubleClick> event, the `Click` event might be raised two times.  
   
  For more information about how to handle events, see [Handling and Raising Events](~/docs/standard/events/index.md).  
   

xml/Microsoft.JScript.Vsa/VsaEngine.xml

@@ -541,7 +541,7 @@
 ## Remarks  
  The `Click` event passes an <xref:System.EventArgs> to its event handler. Therefore it only indicates that a click has occurred. If you need more specific mouse information (button, number of clicks, wheel rotation, or location), use the <xref:System.Windows.Forms.Control.MouseClick> event. However, the <xref:System.Windows.Forms.Control.MouseClick> event will not be raised if the click is caused by action other than that of the mouse, such as pressing the ENTER key.  
   
- A double-click is determined by the mouse settings of the user's operating system. The user can set the time between clicks of a mouse button that should be considered a double-click instead of two clicks. The `Click` event is raised every time that a control is double-clicked. For example, if you have event handlers for the `Click` and <xref:System.Windows.Forms.Control.DoubleClick> events of a [control](ms-help://MS.VSCC.v90/MS.MSDNQTR.v90.en/fxref_system.windows.forms/html/6569d671-0a28-7b3f-dbb8-90c3d272b6e2.htm), the `Click` and <xref:System.Windows.Forms.Control.DoubleClick> events are raised when the control is double-clicked and both methods are called. If a control is double-clicked and that control does not support the <xref:System.Windows.Forms.Control.DoubleClick> event, the `Click` event might be raised two times.  
+ A double-click is determined by the mouse settings of the user's operating system. The user can set the time between clicks of a mouse button that should be considered a double-click instead of two clicks. The `Click` event is raised every time that a control is double-clicked. For example, if you have event handlers for the `Click` and <xref:System.Windows.Forms.Control.DoubleClick> events of a control, the `Click` and <xref:System.Windows.Forms.Control.DoubleClick> events are raised when the control is double-clicked and both methods are called. If a control is double-clicked and that control does not support the <xref:System.Windows.Forms.Control.DoubleClick> event, the `Click` event might be raised two times.  
   
  For more information about how to handle events, see [Handling and Raising Events](~/docs/standard/events/index.md).  
   

xml/Microsoft.VisualBasic.Compatibility.VB6/ADODCArray.xml

@@ -332,7 +332,7 @@
 ## Remarks  
  The `Click` event passes an <xref:System.EventArgs> to its event handler. Therefore it only indicates that a click has occurred. If you need more specific mouse information (button, number of clicks, wheel rotation, or location), use the <xref:Microsoft.VisualBasic.Compatibility.VB6.CheckedListBoxArray.MouseClick> event. However, the <xref:Microsoft.VisualBasic.Compatibility.VB6.CheckedListBoxArray.MouseClick> event will not be raised if the click is caused by action other than that of the mouse, such as pressing the ENTER key.  
   
- A double-click is determined by the mouse settings of the user's operating system. The user can set the time between clicks of a mouse button that should be considered a double-click instead of two clicks. The `Click` event is raised every time that a control is double-clicked. For example, if you have event handlers for the `Click` and <xref:System.Windows.Forms.Control.DoubleClick> events of a [control](ms-help://MS.VSCC.v90/MS.MSDNQTR.v90.en/fxref_system.windows.forms/html/6569d671-0a28-7b3f-dbb8-90c3d272b6e2.htm), the `Click` and <xref:System.Windows.Forms.Control.DoubleClick> events are raised when the control is double-clicked and both methods are called. If a control is double-clicked and that control does not support the <xref:System.Windows.Forms.Control.DoubleClick> event, the `Click` event might be raised two times.  
+ A double-click is determined by the mouse settings of the user's operating system. The user can set the time between clicks of a mouse button that should be considered a double-click instead of two clicks. The `Click` event is raised every time that a control is double-clicked. For example, if you have event handlers for the `Click` and <xref:System.Windows.Forms.Control.DoubleClick> events of a control, the `Click` and <xref:System.Windows.Forms.Control.DoubleClick> events are raised when the control is double-clicked and both methods are called. If a control is double-clicked and that control does not support the <xref:System.Windows.Forms.Control.DoubleClick> event, the `Click` event might be raised two times.  
   
  For more information about how to handle events, see [Handling and Raising Events](~/docs/standard/events/index.md).  
   

xml/Microsoft.VisualBasic.Compatibility.VB6/CheckBoxArray.xml

@@ -333,7 +333,7 @@
 ## Remarks  
  The `Click` event passes an <xref:System.EventArgs> to its event handler. Therefore it only indicates that a click has occurred. If you need more specific mouse information (button, number of clicks, wheel rotation, or location), use the <xref:System.Windows.Forms.Control.MouseClick> event. However, the <xref:System.Windows.Forms.Control.MouseClick> event will not be raised if the click is caused by action other than that of the mouse, such as pressing the ENTER key.  
   
- A double-click is determined by the mouse settings of the user's operating system. The user can set the time between clicks of a mouse button that should be considered a double-click instead of two clicks. The `Click` event is raised every time that a control is double-clicked. For example, if you have event handlers for the `Click` and <xref:System.Windows.Forms.Control.DoubleClick> events of a [control](ms-help://MS.VSCC.v90/MS.MSDNQTR.v90.en/fxref_system.windows.forms/html/6569d671-0a28-7b3f-dbb8-90c3d272b6e2.htm), the `Click` and <xref:System.Windows.Forms.Control.DoubleClick> events are raised when the control is double-clicked and both methods are called. If a control is double-clicked and that control does not support the <xref:System.Windows.Forms.Control.DoubleClick> event, the `Click` event might be raised two times.  
+ A double-click is determined by the mouse settings of the user's operating system. The user can set the time between clicks of a mouse button that should be considered a double-click instead of two clicks. The `Click` event is raised every time that a control is double-clicked. For example, if you have event handlers for the `Click` and <xref:System.Windows.Forms.Control.DoubleClick> events of a control, the `Click` and <xref:System.Windows.Forms.Control.DoubleClick> events are raised when the control is double-clicked and both methods are called. If a control is double-clicked and that control does not support the <xref:System.Windows.Forms.Control.DoubleClick> event, the `Click` event might be raised two times.  
   
  For more information about how to handle events, see [Handling and Raising Events](~/docs/standard/events/index.md).  
   

xml/Microsoft.VisualBasic.Compatibility.VB6/CheckedListBoxArray.xml

@@ -368,7 +368,7 @@
 ## Remarks  
  The `Click` event passes an <xref:System.EventArgs> to its event handler. Therefore it only indicates that a click has occurred. If you need more specific mouse information (button, number of clicks, wheel rotation, or location), use the <xref:Microsoft.VisualBasic.Compatibility.VB6.LabelArray.MouseClick> event. However, the <xref:Microsoft.VisualBasic.Compatibility.VB6.LabelArray.MouseClick> event will not be raised if the click is caused by action other than that of the mouse, such as pressing the ENTER key.  
   
- A double-click is determined by the mouse settings of the user's operating system. The user can set the time between clicks of a mouse button that should be considered a double-click instead of two clicks. The `Click` event is raised every time that a control is double-clicked. For example, if you have event handlers for the `Click` and <xref:System.Windows.Forms.Control.DoubleClick> events of a [control](ms-help://MS.VSCC.v90/MS.MSDNQTR.v90.en/fxref_system.windows.forms/html/6569d671-0a28-7b3f-dbb8-90c3d272b6e2.htm), the `Click` and <xref:System.Windows.Forms.Control.DoubleClick> events are raised when the control is double-clicked and both methods are called. If a control is double-clicked and that control does not support the <xref:System.Windows.Forms.Control.DoubleClick> event, the `Click` event might be raised two times.  
+ A double-click is determined by the mouse settings of the user's operating system. The user can set the time between clicks of a mouse button that should be considered a double-click instead of two clicks. The `Click` event is raised every time that a control is double-clicked. For example, if you have event handlers for the `Click` and <xref:System.Windows.Forms.Control.DoubleClick> events of a control, the `Click` and <xref:System.Windows.Forms.Control.DoubleClick> events are raised when the control is double-clicked and both methods are called. If a control is double-clicked and that control does not support the <xref:System.Windows.Forms.Control.DoubleClick> event, the `Click` event might be raised two times.  
   
  For more information about how to handle events, see [Handling and Raising Events](~/docs/standard/events/index.md).