markdig fixes - Part 4 (#2555)

* markdig fixes

* try to fix broken table

Author: mairaw

xml/System.Diagnostics.Eventing/EventProviderTraceListener.xml

@@ -156,15 +156,7 @@ private static Guid providerId = new Guid("{B3F0C8FC-E8A8-4868-8901-1465E8A2F41B
         <param name="name">Name of the listener.</param>
         <param name="delimiter">Delimiter used to delimit the event data. (For more details, see the <see cref="P:System.Diagnostics.Eventing.EventProviderTraceListener.Delimiter" /> property.)</param>
         <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.Eventing.EventProviderTraceListener" /> class using the specified provider identifier, name of the listener, and delimiter.</summary>
-        <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
-  
--  
-  
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Close">

xml/System.Linq/Enumerable.xml

@@ -3352,11 +3352,11 @@ Only unique elements are returned.
  This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its `GetEnumerator` method directly or by using `foreach` in Visual C# or `For Each` in Visual Basic.  
 
 > [!NOTE]
->  For examples of `GroupBy`, see the following topics.  
+>  For examples of `GroupBy`, see the following articles:
 >   
->  -   <xref:System.Linq.Enumerable.GroupBy%60%603%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Func%7B%60%600%2C%60%602%7D%29>  
-> -   <xref:System.Linq.Enumerable.GroupBy%60%603%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Func%7B%60%601%2CSystem.Collections.Generic.IEnumerable%7B%60%600%7D%2C%60%602%7D%29>  
-> -   <xref:System.Linq.Enumerable.GroupBy%60%604%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Func%7B%60%600%2C%60%602%7D%2CSystem.Func%7B%60%601%2CSystem.Collections.Generic.IEnumerable%7B%60%602%7D%2C%60%603%7D%29>  
+> - <xref:System.Linq.Enumerable.GroupBy%60%603%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Func%7B%60%600%2C%60%602%7D%29>  
+> - <xref:System.Linq.Enumerable.GroupBy%60%603%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Func%7B%60%601%2CSystem.Collections.Generic.IEnumerable%7B%60%600%7D%2C%60%602%7D%29>  
+> - <xref:System.Linq.Enumerable.GroupBy%60%604%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Func%7B%60%600%2C%60%602%7D%2CSystem.Func%7B%60%601%2CSystem.Collections.Generic.IEnumerable%7B%60%602%7D%2C%60%603%7D%29>  
 
  The <xref:System.Linq.Enumerable.GroupBy%60%602%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%29> method returns a collection of <xref:System.Linq.IGrouping%602> objects, one for each distinct key that was encountered. An <xref:System.Linq.IGrouping%602> is an <xref:System.Collections.Generic.IEnumerable%601> that also has a key associated with its elements.  
 
@@ -3427,11 +3427,11 @@ Only unique elements are returned.
  This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its `GetEnumerator` method directly or by using `foreach` in Visual C# or `For Each` in Visual Basic.  
 
 > [!NOTE]
->  For examples of `GroupBy`, see the following topics.  
+>  For examples of `GroupBy`, see the following articles:
 >   
->  -   <xref:System.Linq.Enumerable.GroupBy%60%603%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Func%7B%60%600%2C%60%602%7D%29>  
-> -   <xref:System.Linq.Enumerable.GroupBy%60%603%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Func%7B%60%601%2CSystem.Collections.Generic.IEnumerable%7B%60%600%7D%2C%60%602%7D%29>  
-> -   <xref:System.Linq.Enumerable.GroupBy%60%604%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Func%7B%60%600%2C%60%602%7D%2CSystem.Func%7B%60%601%2CSystem.Collections.Generic.IEnumerable%7B%60%602%7D%2C%60%603%7D%29>  
+> - <xref:System.Linq.Enumerable.GroupBy%60%603%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Func%7B%60%600%2C%60%602%7D%29>  
+> - <xref:System.Linq.Enumerable.GroupBy%60%603%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Func%7B%60%601%2CSystem.Collections.Generic.IEnumerable%7B%60%600%7D%2C%60%602%7D%29>  
+> - <xref:System.Linq.Enumerable.GroupBy%60%604%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Func%7B%60%600%2C%60%602%7D%2CSystem.Func%7B%60%601%2CSystem.Collections.Generic.IEnumerable%7B%60%602%7D%2C%60%603%7D%29>  
 
  The <xref:System.Linq.Enumerable.GroupBy%60%602%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Collections.Generic.IEqualityComparer%7B%60%601%7D%29> method returns a collection of <xref:System.Linq.IGrouping%602> objects, one for each distinct key that was encountered. An <xref:System.Linq.IGrouping%602> is an <xref:System.Collections.Generic.IEnumerable%601> that also has a key associated with its elements.  
 
@@ -3592,11 +3592,11 @@ Only unique elements are returned.
  This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its `GetEnumerator` method directly or by using `foreach` in Visual C# or `For Each` in Visual Basic.  
 
 > [!NOTE]
->  For examples of `GroupBy`, see the following topics.  
+>  For examples of `GroupBy`, see the following articles:
 >   
->  -   <xref:System.Linq.Enumerable.GroupBy%60%603%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Func%7B%60%600%2C%60%602%7D%29>  
-> -   <xref:System.Linq.Enumerable.GroupBy%60%603%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Func%7B%60%601%2CSystem.Collections.Generic.IEnumerable%7B%60%600%7D%2C%60%602%7D%29>  
-> -   <xref:System.Linq.Enumerable.GroupBy%60%604%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Func%7B%60%600%2C%60%602%7D%2CSystem.Func%7B%60%601%2CSystem.Collections.Generic.IEnumerable%7B%60%602%7D%2C%60%603%7D%29>  
+> - <xref:System.Linq.Enumerable.GroupBy%60%603%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Func%7B%60%600%2C%60%602%7D%29>  
+> - <xref:System.Linq.Enumerable.GroupBy%60%603%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Func%7B%60%601%2CSystem.Collections.Generic.IEnumerable%7B%60%600%7D%2C%60%602%7D%29>  
+> - <xref:System.Linq.Enumerable.GroupBy%60%604%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Func%7B%60%600%2C%60%602%7D%2CSystem.Func%7B%60%601%2CSystem.Collections.Generic.IEnumerable%7B%60%602%7D%2C%60%603%7D%29>  
 
  The <xref:System.Linq.Enumerable.GroupBy%60%603%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Func%7B%60%600%2C%60%602%7D%2CSystem.Collections.Generic.IEqualityComparer%7B%60%601%7D%29> method returns a collection of <xref:System.Linq.IGrouping%602> objects, one for each distinct key that was encountered. An <xref:System.Linq.IGrouping%602> is an <xref:System.Collections.Generic.IEnumerable%601> that also has a key associated with its elements.  
 

xml/System.Net.PeerToPeer.Collaboration/ApplicationChangedEventArgs.xml

@@ -32,8 +32,6 @@
   
 -   A peer moves to a different IP address on the network  
   
--  
-  
  Every class that uses the <xref:System.Net.PeerToPeer.Collaboration.ApplicationChangedEventArgs> class requires a <xref:System.Security.Permissions.PermissionState> of Unrestricted. This state is created when the <xref:System.Net.PeerToPeer.Collaboration.PeerCollaboration> object is constructed.  
   
  ]]></format>

xml/System.Net/HttpListenerPrefixCollection.xml

@@ -104,7 +104,7 @@
   
  When a port is specified, the host element can be replaced with "`*`" to indicate that the <xref:System.Net.HttpListener> accepts requests sent to the port if the requested URI does not match any other prefix. For example, to receive all requests sent to port 8080 when the requested URI is not handled by any other <xref:System.Net.HttpListener>, the prefix is "`http://*:8080/`". Similarly, to specify that the <xref:System.Net.HttpListener> accepts all requests sent to a port, replace the host element with the "`+`" character, "`https://+:8080/`". The "`*`" and "`+`" characters can be present in prefixes that include paths.  
   
- Starting with .NET 4.5.3 and Windows 10, wildcard subdomains are supported in URI prefixes that are managed by an <xref:System.Net.HttpListener> object. To specify a wildcard subdomain, use the "*" character as part of the hostname in a URI prefix: for example, `http://*.foo.com/`, and pass this as the argument to the HttpListenerPrefixCollection.Add method. This will work on .NET 4.5.3 and Windows 10; in earlier versions, this would generate an <xref:System.Net.HttpListenerException>  
+ Starting with .NET 4.5.3 and Windows 10, wildcard subdomains are supported in URI prefixes that are managed by an <xref:System.Net.HttpListener> object. To specify a wildcard subdomain, use the "\*" character as part of the hostname in a URI prefix: for example, `http://*.foo.com/`, and pass this as the argument to the HttpListenerPrefixCollection.Add method. This will work on .NET 4.5.3 and Windows 10; in earlier versions, this would generate an <xref:System.Net.HttpListenerException>  
   
    
   

xml/System.ServiceModel.Channels/TransportSecurityBindingElement.xml

@@ -46,11 +46,10 @@
   
 4.  Create an instance of <xref:System.ServiceModel.Channels.TransportSecurityBindingElement> and add it to the collection.  
   
-5.  Add any additional custom binding elements to the collection, such as <xref:System.ServiceModel.Channels.TcpTransportBindingElement>.  
+5.  Add any additional custom binding elements to the collection, such as <xref:System.ServiceModel.Channels.TcpTransportBindingElement>.
   
-6.  
-  
- **Note** Once an instance of this object is created, you should treat the properties of its base class, <xref:System.ServiceModel.Channels.SecurityBindingElement>, as immutable. Calling `set` on some properties may have unpredictable effects: the binding may behave as if the property retained its old value, with a run-time failure being the only indication of an issue. Two properties known to behave this way are <xref:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters.KeyType%2A> and <xref:System.ServiceModel.Channels.SecurityBindingElement.MessageSecurityVersion%2A>. There may be other properties for which this is true.  
+> [!NOTE]
+> Once an instance of this object is created, you should treat the properties of its base class, <xref:System.ServiceModel.Channels.SecurityBindingElement>, as immutable. Calling `set` on some properties may have unpredictable effects: the binding may behave as if the property retained its old value, with a run-time failure being the only indication of an issue. Two properties known to behave this way are <xref:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters.KeyType%2A> and <xref:System.ServiceModel.Channels.SecurityBindingElement.MessageSecurityVersion%2A>. There may be other properties for which this is true.  
   
  ]]></format>
     </remarks>

xml/System.Web.Hosting/HostingEnvironment.xml

@@ -939,12 +939,12 @@
 > [!WARNING]
 >  There are several design considerations that a developer must consider when implementing the <xref:System.Web.Hosting.HostingEnvironment.StopListening> event:  
 >   
->  1.  The <xref:System.Web.Hosting.HostingEnvironment.StopListening> event is only available for applications that are configured to use the IIS integrated pipeline.  
-> 2.  Developers must not throw errors from their <xref:System.Web.Hosting.HostingEnvironment.StopListening> implementations; throwing errors will have unpredictable results.  
-> 3.  Due to the concurrent nature of operations within ASP.NET, there is no guarantee that ASP.NET will call a <xref:System.Web.Hosting.HostingEnvironment.StopListening> event once it has been implemented by a developer.  
-> 4.  The <xref:System.Web.Hosting.HostingEnvironment.StopListening> event can execute concurrently with other <xref:System.Web.Hosting.IRegisteredObject> notifications.  
-> 5.  Developers need to be aware that ASP.NET may shut down the application domain while their <xref:System.Web.Hosting.HostingEnvironment.StopListening> event is executing and design their implementations to handle that possibility.  
-> 6.  <xref:System.Web.Hosting.HostingEnvironment.StopListening> event handlers must not block; blocking implementations will result in deadlocks, and IIS will terminate the worker process when the rapid fail protection interval is reached.  
+> 1. The <xref:System.Web.Hosting.HostingEnvironment.StopListening> event is only available for applications that are configured to use the IIS integrated pipeline.  
+> 2. Developers must not throw errors from their <xref:System.Web.Hosting.HostingEnvironment.StopListening> implementations; throwing errors will have unpredictable results.  
+> 3. Due to the concurrent nature of operations within ASP.NET, there is no guarantee that ASP.NET will call a <xref:System.Web.Hosting.HostingEnvironment.StopListening> event once it has been implemented by a developer.  
+> 4. The <xref:System.Web.Hosting.HostingEnvironment.StopListening> event can execute concurrently with other <xref:System.Web.Hosting.IRegisteredObject> notifications.  
+> 5. Developers need to be aware that ASP.NET may shut down the application domain while their <xref:System.Web.Hosting.HostingEnvironment.StopListening> event is executing and design their implementations to handle that possibility.  
+> 6. <xref:System.Web.Hosting.HostingEnvironment.StopListening> event handlers must not block; blocking implementations will result in deadlocks, and IIS will terminate the worker process when the rapid fail protection interval is reached.  
   
  ]]></format>
         </remarks>

xml/System.Web.Security.AntiXss/AntiXssEncoder.xml

@@ -142,32 +142,32 @@
 |Character(s)|Description|  
 |--------------------|-----------------|  
 |A-Z|Uppercase Latin alphabetic characters|  
-||a-z|Lowercase Latin alphabetic characters|  
+|a-z|Lowercase Latin alphabetic characters|  
 |0-9|Numbers|  
-|!|Exclamation mark|  
-|#|Number sign, hash|  
-|$|Dollar sign|  
-|%|Percent sign|  
+|\!|Exclamation mark|  
+|\#|Number sign, hash|  
+|\$|Dollar sign|  
+|\%|Percent sign|  
 |( )|Parentheses|  
-|*|Asterisk|  
-|+|Plus sign|  
-|,|Comma|  
-|-|Hyphen, minus|  
-|.|Period, dot, full stop|  
-|/|Slash|  
-|:|Colon|  
-|;|Semicolon|  
-|=|Equals sign|  
-|?|Question mark|  
-|@|Commercial at-sign|  
-|[ ]|Square brackets|  
-|\|Backslash|  
-|^|Caret|  
-|_|Underscore|  
+|\*|Asterisk|  
+|\+|Plus sign|  
+|\,|Comma|  
+|\-|Hyphen, minus|  
+|\.|Period, dot, full stop|  
+|\/|Slash|  
+|\:|Colon|  
+|\;|Semicolon|  
+|\=|Equals sign|  
+|\?|Question mark|  
+|\@|Commercial at-sign|  
+|\[ \]|Square brackets|  
+|\\ |Backslash|  
+|\^|Caret|  
+|\_|Underscore|  
 |\`|Grave accent|  
-|{ }|Braces, curly brackets|  
-|||Vertical line|  
-|~|Tilde|  
+|\{ \}|Braces, curly brackets|  
+|\||Vertical line|  
+|\~|Tilde|  
 |0x00A1 - 0x00AC|Special characters between 0x00A1 (161 decimal) and 0x00AC (172 decimal) from the Unicode [C1 Controls and Latin-1 Supplement](https://www.unicode.org/charts/PDF/U0080.pdf) character range.|  
 |0x00AE - 0x00FF|Special characters between 0x00AE (174 decimal) and 0x00FF (255 decimal) from the Unicode [C1 Controls and Latin-1 Supplement](https://www.unicode.org/charts/PDF/U0080.pdf) character range.|  
 |0x0100 - 0x017F|Characters between 0x0100 (256 decimal) and 0x017F (383 decimal). (The Unicode [Latin-Extended-A](https://www.unicode.org/charts/PDF/U0100.pdf) character range.)|
@@ -178,7 +178,7 @@
   
  The following table lists examples of inputs and the corresponding encoded outputs.  
   
-|||  
+|Input examples| Encoded outputs|  
 |-|-|  
 |`alert('XSS Attack!');`|`alert('XSS Attack!');`|  
 |`<script>alert('XSS Attack!');</script>`|`&lt;script&gt;alert(&#39;XSS Attack!&#39;);&lt;/script&gt;`|  
@@ -1103,4 +1103,4 @@ The following table lists the default safe characters. All characters are from t
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Windows.Media.Media3D/Vector3DCollection.xml

@@ -69,7 +69,7 @@
  *oneOrMoreVector3Ds*  
  One or more <xref:System.Windows.Media.Media3D.Vector3D> objects, with each set of values delimited by commas and/or one or more spaces:  
   
- <xref:System.Windows.Media.Media3D.Vector3D> *[delimiter* <xref:System.Windows.Media.Media3D.Vector3D> *]\**  
+ <xref:System.Windows.Media.Media3D.Vector3D>_[delimiter_<xref:System.Windows.Media.Media3D.Vector3D>_]\*_  
   
  For example, `"0,0,5 100,100,150 200,100,75"` and `"0,0,5,100,100,150,200,100,75"` are both valid.  
   

xml/System.Windows.Media/DoubleCollection.xml

@@ -72,7 +72,7 @@
  *oneOrMoreDoubleValues*  
  One or more <xref:System.Double> values, with each pair delimited by a single comma and/or one or more spaces:  
   
- <xref:System.Double> *[delimiter* <xref:System.Double> *]\**  
+ <xref:System.Double>_[delimiter_<xref:System.Double>_]\*_
   
  For example, `"0.5 1.0 43"` and `"0.5,1.0,43"` are both valid.  
   

xml/ns-System.Data.Common.CommandTrees.ExpressionBuilder.xml

@@ -5,16 +5,15 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The <xref:System.Data.Common.CommandTrees.ExpressionBuilder> API is used to create expressions, which are represented by <xref:System.Data.Common.CommandTrees.DbExpression> objects. The command tree API provided by the <xref:System.Data.Common.CommandTrees.ExpressionBuilder.DbExpressionBuilder> class has the following characteristics:  
-  
--   Functional. <xref:System.Data.Common.CommandTrees.DbExpression> objects are constructed using functional patterns that provide a natural flow of construction.  
-  
--   Loosely-coupled. A <xref:System.Data.Common.CommandTrees.DbExpression> object is not bound to any specific command tree and can be used in any context where type agreement is satisfied.  
-  
--   Immutable. The API consists entirely of immutable types; mutability may be simulated by substituting new values while rebuilding an expression tree.  
-  
--  
-  
+
+The <xref:System.Data.Common.CommandTrees.ExpressionBuilder> API is used to create expressions, which are represented by <xref:System.Data.Common.CommandTrees.DbExpression> objects. The command tree API provided by the <xref:System.Data.Common.CommandTrees.ExpressionBuilder.DbExpressionBuilder> class has the following characteristics:  
+
+- Functional: <xref:System.Data.Common.CommandTrees.DbExpression> objects are constructed using functional patterns that provide a natural flow of construction.
+
+- Loosely-coupled: A <xref:System.Data.Common.CommandTrees.DbExpression> object is not bound to any specific command tree and can be used in any context where type agreement is satisfied.
+
+- Immutable: The API consists entirely of immutable types; mutability may be simulated by substituting new values while rebuilding an expression tree.
+
  ]]></format>
     </remarks>
   </Docs>