dotnet · mairaw · Jun 7, 2019 · Jun 5, 2019 · Jun 6, 2019 · Jun 6, 2019
diff --git a/xml/Microsoft.VisualBasic/FileSystem.xml b/xml/Microsoft.VisualBasic/FileSystem.xml
@@ -3638,32 +3638,7 @@
       <Docs>
         <param name="PathName">Required. A string expression that specifies a file, directory, or folder name. <paramref name="PathName" /> can include the directory or folder, and the drive.</param>
         <summary>Returns a <see langword="FileAttribute" /> value that represents the attributes of a file, directory, or folder. The <see langword="My" /> feature gives you better productivity and performance in file I/O operations than <see langword="FileAttribute" />. For more information, see <see cref="T:Microsoft.VisualBasic.FileIO.FileSystem" />.</summary>
-        <returns>The value returned by <see langword="GetAttr" /> is the sum of the following enumeration values:  
-
- <list type="table"><item><term> Value  
-
- </term><description> Constant  
-
- </description><description> Description  
-
- </description></item><item><term><see langword="Normal" /></term><description><see langword="vbNormal" /></description><description> Normal.  
-
- </description></item><item><term><see langword="ReadOnly" /></term><description><see langword="vbReadOnly" /></description><description> Read-only.  
-
- </description></item><item><term><see langword="Hidden" /></term><description><see langword="vbHidden" /></description><description> Hidden.  
-
- </description></item><item><term><see langword="System" /></term><description><see langword="vbSystem" /></description><description> System file.  
-
- </description></item><item><term><see langword="Directory" /></term><description><see langword="vbDirectory" /></description><description> Directory or folder.  
-
- </description></item><item><term><see langword="Archive" /></term><description><see langword="vbArchive" /></description><description> File has changed since last backup.  
-
- </description></item><item><term><see langword="Alias" /></term><description><see langword="vbAlias" /></description><description> File has a different name.  
-
- </description></item></list><block subset="none" type="note"><para>  
- These enumerations are specified by the Visual Basic language. The names can be used anywhere in your code in place of the actual values.  
-
-</para></block></returns>
+        <returns>A bitwise combination of the enumeration values.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
 

diff --git a/xml/System.Threading.Tasks/TaskFactory`1.xml b/xml/System.Threading.Tasks/TaskFactory`1.xml
@@ -596,7 +596,7 @@
       <Docs>
         <param name="tasks">The array of tasks from which to continue.</param>
         <param name="continuationFunction">The function delegate to execute asynchronously when all tasks in the <paramref name="tasks" /> array have completed.</param>
-        <param name="continuationOptions">One of the enumeration values that controls the behavior of the created continuation task. The NotOn* or OnlyOn* values are not valid.</param>
+        <param name="continuationOptions">One of the enumeration values that controls the behavior of the created continuation task. The <see langword="NotOn*" /> or <see langword="OnlyOn*" /> values are not valid.</param>
         <summary>Creates a continuation task that will be started upon the completion of a set of provided Tasks.</summary>
         <returns>The new continuation task.</returns>
         <remarks>
@@ -661,7 +661,7 @@
         <param name="tasks">The array of tasks from which to continue.</param>
         <param name="continuationFunction">The function delegate to execute asynchronously when all tasks in the <paramref name="tasks" /> array have completed.</param>
         <param name="cancellationToken">The cancellation token that will be assigned to the new continuation task.</param>
-        <param name="continuationOptions">One of the enumeration values that controls the behavior of the created continuation task. The NotOn* or OnlyOn* values are not valid.</param>
+        <param name="continuationOptions">One of the enumeration values that controls the behavior of the created continuation task. The <see langword="NotOn*" /> or <see langword="OnlyOn*" /> values are not valid.</param>
         <param name="scheduler">The scheduler that is used to schedule the created continuation task.</param>
         <summary>Creates a continuation task that will be started upon the completion of a set of provided Tasks.</summary>
         <returns>The new continuation task.</returns>
@@ -871,7 +871,7 @@
         <typeparam name="TAntecedentResult">The type of the result of the antecedent <paramref name="tasks" />.</typeparam>
         <param name="tasks">The array of tasks from which to continue.</param>
         <param name="continuationFunction">The function delegate to execute asynchronously when all tasks in the <paramref name="tasks" /> array have completed.</param>
-        <param name="continuationOptions">One of the enumeration values that controls the behavior of the created continuation task. The NotOn* or OnlyOn* values are not valid.</param>
+        <param name="continuationOptions">One of the enumeration values that controls the behavior of the created continuation task. The <see langword="NotOn*" /> or <see langword="OnlyOn*" /> values are not valid.</param>
         <summary>Creates a continuation task that will be started upon the completion of a set of provided tasks.</summary>
         <returns>The new continuation task.</returns>
         <remarks>
@@ -940,7 +940,7 @@
         <param name="tasks">The array of tasks from which to continue.</param>
         <param name="continuationFunction">The function delegate to execute asynchronously when all tasks in the <paramref name="tasks" /> array have completed.</param>
         <param name="cancellationToken">The cancellation token that will be assigned to the new continuation task.</param>
-        <param name="continuationOptions">One of the enumeration values that controls the behavior of the created continuation task. The NotOn* or OnlyOn* values are not valid.</param>
+        <param name="continuationOptions">One of the enumeration values that controls the behavior of the created continuation task. The <see langword="NotOn*" /> or <see langword="OnlyOn*" /> values are not valid.</param>
         <param name="scheduler">The scheduler that is used to schedule the created continuation task.</param>
         <summary>Creates a continuation task that will be started upon the completion of a set of provided tasks.</summary>
         <returns>The new continuation task.</returns>

diff --git a/xml/System.Web.UI.DataVisualization.Charting/BorderSkinStyle.xml b/xml/System.Web.UI.DataVisualization.Charting/BorderSkinStyle.xml
@@ -21,7 +21,7 @@
  The <xref:System.Web.UI.DataVisualization.Charting.BorderSkin> class represents the style of the border skin used for a chart image. If you set the <xref:System.Web.UI.DataVisualization.Charting.BorderSkin.SkinStyle> property to None, no skin will be used. This is the default value for the <xref:System.Web.UI.DataVisualization.Charting.BorderSkin.SkinStyle> property.  
 
 > [!NOTE]
->  The difference between the sets of border skin styles that use frames and follow either the naming convention "FrameThin*" or "FrameTitle*" (for example, System.Web.UI.DataVisualization.Charting.BorderSkinStyle.FrameThin1 or System.Web.UI.DataVisualization.Charting.BorderSkinStyle.FrameTitle1) is the shape and thickness of their frames.  
+> The difference between the sets of border skin styles that use frames and follow either the naming convention "FrameThin\*" or "FrameTitle\*" (for example, System.Web.UI.DataVisualization.Charting.BorderSkinStyle.FrameThin1 or System.Web.UI.DataVisualization.Charting.BorderSkinStyle.FrameTitle1) is the shape and thickness of their frames.  
 
  In addition, if you use one of the "FrameThin" style border skins, the title of the chart will not be displayed. However, if you use one of the "FrameTitle" style border skins, the title of the chart will appear in the top-horizontal part of the frame.  
 

diff --git a/xml/System.Web.UI.WebControls/AdRotator.xml b/xml/System.Web.UI.WebControls/AdRotator.xml
@@ -88,7 +88,7 @@
 |`Width`|The width of the image, in pixels (optional).|  
 |`AlternateText`|The text display in place of the image when the image specified by the <xref:System.Web.UI.WebControls.AdCreatedEventArgs.ImageUrl%2A> property is not available (optional).<br /><br /> In some browsers, this text also appears as a `ToolTip` for the advertisement.|  
 |`Keyword`|A category for the advertisement (for example, "computers") that you can filter by (optional).|  
-|`Impressions`|A number that indicates the importance of the ad in the schedule of rotation relative to the other ads in the file (optional).<br /><br /> The larger the number, the more often the ad is displayed. The total of all `<Impressions>` values in the XML file cannot exceed 2,047,999,999*.* If it does, the <xref:System.Web.UI.WebControls.AdRotator> control throws a run-time exception.|  
+|`Impressions`|A number that indicates the importance of the ad in the schedule of rotation relative to the other ads in the file (optional).<br /><br /> The larger the number, the more often the ad is displayed. The total of all `<Impressions>` values in the XML file cannot exceed 2,047,999,999. If it does, the <xref:System.Web.UI.WebControls.AdRotator> control throws a run-time exception.|  
 
  The following example shows the format for the XML advertisement file.  
 
@@ -172,7 +172,7 @@
 
  The following code example demonstrates the file format for an XML file that contains advertisement information for the previous example. For more information on the file format, see the <xref:System.Web.UI.WebControls.AdRotator.AdvertisementFile%2A> member.  
 
-```  
+```xml
 <Advertisements>  
   <Ad>  
     <ImageUrl>~/Images/image1.jpg</ImageUrl>  
@@ -1164,7 +1164,7 @@
 
  The following code example demonstrates the file format for an XML file that contains advertisement information. For more information on the file format, see the <xref:System.Web.UI.WebControls.AdRotator.AdvertisementFile%2A> member.  
 
-```  
+```xml
 <Advertisements>  
   <Ad>  
     <ImageUrl>~/Images/image1.jpg</ImageUrl>  

diff --git a/xml/System.Windows.Forms/KeyPressEventArgs.xml b/xml/System.Windows.Forms/KeyPressEventArgs.xml
@@ -222,10 +222,6 @@
 > [!NOTE]
 >  For information about how to detect any of the non-character keys mentioned above, see the <xref:System.Windows.Forms.KeyEventArgs> class.  
 
--  
-
-
-
 ## Examples  
  The following example creates a <xref:System.Windows.Forms.TextBox> control. The `keypressed` method uses the <xref:System.Windows.Forms.KeyPressEventArgs.KeyChar%2A> property to check whether the ENTER key pressed. If the ENTER key is pressed, the <xref:System.Windows.Forms.KeyPressEventArgs.Handled%2A> property is set to `true`, which indicates the event is handled.  
 

diff --git a/xml/System.Windows.Media.Media3D/Point3DCollection.xml b/xml/System.Windows.Media.Media3D/Point3DCollection.xml
@@ -80,7 +80,7 @@
  *oneOrMorePoint3Ds*  
  One or more <xref:System.Windows.Media.Media3D.Point3D> structures, with each set of values delimited by commas and/or one or more spaces.  
 
- <xref:System.Windows.Media.Media3D.Point3D>  *[delimiter* <xref:System.Windows.Media.Media3D.Point3D> *]\**  
+ <xref:System.Windows.Media.Media3D.Point3D>_[delimiter_<xref:System.Windows.Media.Media3D.Point3D>_]\*_
 
  For example, `"0,0,5 100,100,125 200,100,30"` and `"0,0,5,100,100,125,200,100,30"` are both valid.  
 

diff --git a/xml/System.Windows.Media/Int32Collection.xml b/xml/System.Windows.Media/Int32Collection.xml
@@ -72,7 +72,7 @@
  *oneOrMoreKInt32Values*  
  One or more <xref:System.Int32> values, with each pair delimited by a single comma and/or one or more spaces:  
 
- <xref:System.Int32> *[delimiter* <xref:System.Int32> *]\**  
+ <xref:System.Int32>_[delimiter_<xref:System.Int32>_]\*_
 
  For example, `"5 10 43"` and `"5,10,43"` are both valid.  
 

diff --git a/xml/System.Windows.Media/VectorCollection.xml b/xml/System.Windows.Media/VectorCollection.xml
@@ -72,7 +72,7 @@
  *oneOrMoreVectors*  
  One or more vector values, with each pair delimited by a single comma and/or one or more spaces:  
 
- <xref:System.Windows.Vector> *[delimiter* <xref:System.Windows.Vector> *]\**  
+ <xref:System.Windows.Vector>_[delimiter_<xref:System.Windows.Vector>_]\*_
 
  For example, `"0,0 100,100 200,100"` and `"0,0,100,100,200,100"` are both valid.  
 

diff --git a/xml/System.Xml/XmlConvert.xml b/xml/System.Xml/XmlConvert.xml
@@ -45,8 +45,7 @@
  You can use the <xref:System.Xml.XmlConvert.EncodeName%2A> method with the <xref:System.Xml.XmlWriter> class to ensure the names being written are valid XML names. The following C# code converts the name "Order Detail" into a valid XML name and writes the element `<Order_0x0020_Detail>My order</Order_0x0020_Detail>`.  
 
 ```csharp  
-writer.WriteElementString(XmlConvert.EncodeName("Order Detail"),"My order");  
-
+writer.WriteElementString(XmlConvert.EncodeName("Order Detail"),"My order");
 ```  
 
  The following <xref:System.Xml.XmlConvert> methods perform encoding and decoding.  
@@ -294,7 +293,7 @@ writer.WriteElementString(XmlConvert.EncodeName("Order Detail"),"My order");
 
  The escape character is "\_". Any XML name character that does not conform to the [XML 1.0 spec (fourth edition) recommendation](https://www.w3.org/TR/2006/REC-xml-20060816/) is escaped as \_xHHHH\_. The HHHH string stands for the four-digit hexadecimal UCS-2 code for the character in most significant bit first order. For example, the name Order Details is encoded as Order\_x0020\_Details.  
 
- The underscore character does not need to be escaped unless it is followed by a character sequence that together with the underscore can be misinterpreted as an escape sequence when decoding the name. For example, Order\_Details is not encoded, but Order\_x0020\_ is encoded as Order\_x005f\_x0020\_. No shortforms are allowed. For example, the forms _x20\_ and \_\_ are not generated.  
+ The underscore character does not need to be escaped unless it is followed by a character sequence that together with the underscore can be misinterpreted as an escape sequence when decoding the name. For example, Order\_Details is not encoded, but Order\_x0020\_ is encoded as Order\_x005f\_x0020\_. No shortforms are allowed. For example, the forms \_x20\_ and \_\_ are not generated.  
 
  This method guarantees the name is valid according to the XML specification. It allows colons in any position, which means the name may still be invalid according to the [W3C Namespace Specification](https://www.w3.org/TR/REC-xml-names/). To guarantee it is a valid namespace qualified name use <xref:System.Xml.XmlConvert.EncodeLocalName%2A> for the prefix and local name parts and join the result with a colon.  
 

diff --git a/xml/System/Decimal.xml b/xml/System/Decimal.xml
@@ -4444,8 +4444,8 @@
 |<xref:System.Globalization.NumberStyles.AllowThousands>|The *,* element.|  
 |<xref:System.Globalization.NumberStyles.AllowCurrencySymbol>|The *$* element.|  
 |<xref:System.Globalization.NumberStyles.Currency>|All. The `s` parameter cannot represent a hexadecimal number or a number in exponential notation.|  
-|<xref:System.Globalization.NumberStyles.Float>|The *ws* element at the beginning or end of `s`, *sign* at the beginning of `s`, and the *.* symbol. The `s` parameter can also use exponential notation.|  
-|<xref:System.Globalization.NumberStyles.Number>|The `ws`, `sign`, *,*, and *.* elements.|  
+|<xref:System.Globalization.NumberStyles.Float>|The *ws* element at the beginning or end of `s`, *sign* at the beginning of `s`, and the `.` symbol. The `s` parameter can also use exponential notation.|  
+|<xref:System.Globalization.NumberStyles.Number>|The `ws`, `sign`, `,` and `.` elements.|  
 |<xref:System.Globalization.NumberStyles.Any>|All styles, except `s` cannot represent a hexadecimal number.|  
 
  The `s` parameter is parsed using the formatting information in a <xref:System.Globalization.NumberFormatInfo> object initialized for the current system culture. For more information, see <xref:System.Globalization.NumberFormatInfo.CurrentInfo%2A>.