markdig fixes - Part 13 (dotnet#2690)

mairaw · web-flow · commit d8652f779c2a · 2019-07-03T17:06:48.000-07:00
* markdig fixes

* fix
diff --git a/xml/System.Web.Services.Description/SoapBinding.xml b/xml/System.Web.Services.Description/SoapBinding.xml
@@ -93,7 +93,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The field value is "http://schemas.xmlsoap.org/soap/http/".  
+ The field value is `"http://schemas.xmlsoap.org/soap/http/"`.  
   
    
   
@@ -130,7 +130,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The field value is "http://schemas.xmlsoap.org/wsdl/soap/".  
+ The field value is `"http://schemas.xmlsoap.org/wsdl/soap/"`.  
   
    
   
diff --git a/xml/System.Web.Services.Discovery/DiscoveryDocumentReference.xml b/xml/System.Web.Services.Discovery/DiscoveryDocumentReference.xml
@@ -275,7 +275,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- For most references, the <xref:System.Web.Services.Discovery.DiscoveryDocumentReference.Ref%2A> property is a URL, such as http://www.contoso.com/MyWebService.disco.  
+ For most references, the <xref:System.Web.Services.Discovery.DiscoveryDocumentReference.Ref%2A> property is a URL, such as `http://www.contoso.com/MyWebService.disco`.  
   
    
   
diff --git a/xml/System.Web.UI.DataVisualization.Charting/LegendItem.xml b/xml/System.Web.UI.DataVisualization.Charting/LegendItem.xml
@@ -859,9 +859,12 @@
  If you set the <xref:System.Web.UI.DataVisualization.Charting.LegendItem.MapAreaAttributes%2A> property, a client-side image map will automatically be created. A map area will also be created, with its attribute string appended to the \<map> tag that corresponds to the chart object for which this property is being set.  
   
  For example, setting the Target attribute using this property and the <xref:System.Web.UI.DataVisualization.Charting.LegendItem.Url%2A> property of the first data point will result in HTML code that is similar to the following code:  
-  
- \<img id="Chart1" usemap="#Chart1ImageMap" src="ChartPic_000002.jpg?6735e83b-f0cd-4225-8be4-047695a61040" border="0" />...\<map name="Chart1ImageMap">\<area shape="rect" href="http://www.SomeDomain.ca" COORDS="69,120,106,309" target\=_blank>\</map>  
-  
+
+```html  
+<img id="Chart1" usemap="#Chart1ImageMap" src="ChartPic_000002.jpg?6735e83b-f0cd-4225-8be4-047695a61040" border="0" />...
+<map name="Chart1ImageMap"><area shape="rect" href="http://www.SomeDomain.ca" COORDS="69,120,106,309" target=_blank></map>
+```
+
  Because the entire string is appended to the \<map> tag, multiple attributes should be separated with a space.  
   
  The <xref:System.Web.UI.DataVisualization.Charting.LegendItem.MapAreaAttributes%2A> property can be used in conjunction with the <xref:System.Web.UI.DataVisualization.Charting.LegendItem.Url%2A> property to specify map area attributes, for example, target= _blank, as well as client-side event handlers, for example, OnClick="MyEvent()".  
@@ -1733,8 +1736,11 @@
 ## Remarks  
  If you set this property, a client-side image map will be automatically created. A map area will also be created with its HREF attribute set to the specified anchor or URL. This map area will also use the dimensions that correspond to the relevant chart element. For example, if the <xref:System.Web.UI.DataVisualization.Charting.LegendItem.Url%2A> property is set for a data point, then HTML code similar to the following will be generated at run time:  
   
- \<img id="Chart1" USEMAP="#Chart1ImageMap" src="ChartPic_000002.jpg?6735e83b-f0cd-4225-8be4-047695a61040" border="0" />...\<MAP NAME="Chart1ImageMap">\<AREA SHAPE="rect" HREF="http://www.healthquotes.ca" COORDS= "69,120,106,309">\</MAP>  
-  
+```html
+<img id="Chart1" USEMAP="#Chart1ImageMap" src="ChartPic_000002.jpg?6735e83b-f0cd-4225-8be4-047695a61040" border="0" />...
+<MAP NAME="Chart1ImageMap"><AREA SHAPE="rect" HREF="http://www.healthquotes.ca" COORDS= "69,120,106,309"></MAP>  
+```
+
  Setting this property will have no effect if the <xref:System.Web.UI.DataVisualization.Charting.Chart.IsMapEnabled%2A> property is set to `false`. The default value is `true`.  
   
  > [!IMPORTANT] 
@@ -1754,4 +1760,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>
diff --git a/xml/System.Web.UI.DataVisualization.Charting/MapArea.xml b/xml/System.Web.UI.DataVisualization.Charting/MapArea.xml
@@ -403,7 +403,10 @@
 ## Remarks  
  If you set this property, a client-side image map will be automatically created, and a map area will be created with the attribute string appended to the \<MAP> tag that corresponds to the <xref:System.Web.UI.DataVisualization.Charting.Chart> object that this property is being set for. For example, setting the Target attribute using this property and setting the `Url` property of the first data point will result in HTML code that is similar to the following:  
   
- \<img id="Chart1" USEMAP="#Chart1ImageMap" src="ChartPic_000002.jpg?6735e83b-f0cd-4225-8be4-047695a61040" border="0" />...\<MAP NAME="Chart1ImageMap">\<AREA SHAPE="rect" HREF="http://www.SomeDomain.ca" COORDS="69,120,106,309" Target\=_Blank>\</MAP>  
+```html
+<img id="Chart1" USEMAP="#Chart1ImageMap" src="ChartPic_000002.jpg?6735e83b-f0cd-4225-8be4-047695a61040" border="0" />...
+<MAP NAME="Chart1ImageMap"><AREA SHAPE="rect" HREF="http://www.SomeDomain.ca" COORDS="69,120,106,309" Target=_Blank></MAP>
+```
   
  Because the entire string is appended to the \<MAP> tag, multiple attributes should be separated with a space.  
   
@@ -665,9 +668,12 @@
   
 ## Remarks  
  When you set this property, a client-side image map will automatically be created, and a map area will be created with the HREF attribute set to the specified anchor or URL. This map area will also use the dimensions that correspond to the relevant chart element. For example, if the HREF property is set for a data point, then HTML code similar to the following will be generated at run time:  
-  
- &lt;img id="Chart1" USEMAP="#Chart1ImageMap" src="ChartPic_000002.jpg?6735e83b-f0cd-4225-8be4-047695a61040" border="0" /&gt;\<BR>...\<BR>&lt;MAP NAME="Chart1ImageMap"&gt;\<BR>&lt;AREA SHAPE="rect" HREF="http://www.healthquotes.ca" COORDS= "69,120,106,309"&gt;\<BR>&lt;/MAP&gt;  
-  
+
+```html 
+<img id="Chart1" USEMAP="#Chart1ImageMap" src="ChartPic_000002.jpg?6735e83b-f0cd-4225-8be4-047695a61040" border="0" />
+<BR>...<BR><MAP NAME="Chart1ImageMap"><BR><AREA SHAPE="rect" HREF="http://www.healthquotes.ca" COORDS= "69,120,106,309"><BR></MAP>  
+```
+
  Setting this property will have no effect if the <xref:System.Web.UI.DataVisualization.Charting.Chart.IsMapEnabled%2A> property is set to `false`. The default value is `true`.  
   
  > [!IMPORTANT] 
diff --git a/xml/System.Web.UI.MobileControls/Link.xml b/xml/System.Web.UI.MobileControls/Link.xml
@@ -60,7 +60,7 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- On all devices, the link is rendered in such a way that the <xref:System.Web.UI.MobileControls.TextControl.Text%2A> property displays on the device to the user. When the user invokes the link, the browser navigates to the specified <xref:System.Web.UI.MobileControls.Link.NavigateUrl%2A> property. The application must contain code that verifies that a link is browsable on a particular device. For example, the link http://www.microsoft.com is not browsable on a WML-capable device.  
+ On all devices, the link is rendered in such a way that the <xref:System.Web.UI.MobileControls.TextControl.Text%2A> property displays on the device to the user. When the user invokes the link, the browser navigates to the specified <xref:System.Web.UI.MobileControls.Link.NavigateUrl%2A> property. The application must contain code that verifies that a link is browsable on a particular device. For example, the link <http://www.microsoft.com> is not browsable on a WML-capable device.  
   
  If the <xref:System.Web.UI.MobileControls.TextControl.Text%2A> property is empty, the value in the <xref:System.Web.UI.MobileControls.Link.NavigateUrl%2A> property is also used for the <xref:System.Web.UI.MobileControls.TextControl.Text%2A> property. Specifically, when the text writer renders a link, it first checks the <xref:System.Web.UI.MobileControls.TextControl.Text%2A> property for the text to display; if that property is empty, it displays the value of the <xref:System.Web.UI.MobileControls.Link.NavigateUrl%2A> property.  
   
diff --git a/xml/System.Web.UI/Control.xml b/xml/System.Web.UI/Control.xml
@@ -341,7 +341,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The <xref:System.Web.UI.Control.AppRelativeTemplateSourceDirectory%2A> property contains the application-relative path to the page or user control that contains the current control. For example, if the Web page resides at http://www.contoso.com/application/subdirectory, the <xref:System.Web.UI.Control.AppRelativeTemplateSourceDirectory%2A> property returns "~/subdirectory".  
+ The <xref:System.Web.UI.Control.AppRelativeTemplateSourceDirectory%2A> property contains the application-relative path to the page or user control that contains the current control. For example, if the Web page resides at `http://www.contoso.com/application/subdirectory`, the <xref:System.Web.UI.Control.AppRelativeTemplateSourceDirectory%2A> property returns "~/subdirectory".  
   
  To return the virtual path ("application/subdirectory"), use the <xref:System.Web.UI.Control.TemplateSourceDirectory%2A> property.  
   
@@ -4418,7 +4418,7 @@ HyperLink1.NavigateUrl = HyperLink1.GetRouteUrl("Product",
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The <xref:System.Web.UI.Control.TemplateSourceDirectory%2A> property specifies the path to the page or user control that contains the current control. For example, if the Web page resides at http://www.contoso.com/application/subdirectory, the <xref:System.Web.UI.Control.TemplateSourceDirectory%2A> property returns "application/subdirectory".  
+ The <xref:System.Web.UI.Control.TemplateSourceDirectory%2A> property specifies the path to the page or user control that contains the current control. For example, if the Web page resides at `http://www.contoso.com/application/subdirectory`, the <xref:System.Web.UI.Control.TemplateSourceDirectory%2A> property returns "application/subdirectory".  
   
  To return the application-relative virtual path ("~/subdirectory"), use the <xref:System.Web.UI.Control.AppRelativeTemplateSourceDirectory%2A> property.  
   
diff --git a/xml/System.Web.UI/Page.xml b/xml/System.Web.UI/Page.xml
@@ -814,7 +814,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The <xref:System.Web.UI.Page.ClientQueryString%2A> property contains the query string portion of the URL requested by the browser. For example, if the requested URL is "http://www.contoso.com/default.aspx?id=100", the <xref:System.Web.UI.Page.ClientQueryString%2A> property will contain "id=100". The <xref:System.Web.UI.Page.ClientQueryString%2A> property is encoded; use the <xref:System.Web.HttpServerUtility.UrlDecode%2A?displayProperty=nameWithType> method to decode the query string.  
+ The <xref:System.Web.UI.Page.ClientQueryString%2A> property contains the query string portion of the URL requested by the browser. For example, if the requested URL is `http://www.contoso.com/default.aspx?id=100`, the <xref:System.Web.UI.Page.ClientQueryString%2A> property will contain "id=100". The <xref:System.Web.UI.Page.ClientQueryString%2A> property is encoded; use the <xref:System.Web.HttpServerUtility.UrlDecode%2A?displayProperty=nameWithType> method to decode the query string.  
   
  ]]></format>
         </remarks>
diff --git a/xml/System.Web.UI/ViewStateException.xml b/xml/System.Web.UI/ViewStateException.xml
@@ -205,7 +205,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- This property returns the same value as the `PATH_INFO` variable in the <xref:System.Web.HttpRequest.ServerVariables%2A> property. It returns the portion of the path after the host name. For example, in the URL http://www.contoso.com/virdir/page.html, <xref:System.Web.UI.ViewStateException.Path%2A> would return /virdir/page.html.  
+ This property returns the same value as the `PATH_INFO` variable in the <xref:System.Web.HttpRequest.ServerVariables%2A> property. It returns the portion of the path after the host name. For example, in the URL `http://www.contoso.com/virdir/page.html`, <xref:System.Web.UI.ViewStateException.Path%2A> would return /virdir/page.html.  
   
    
   
diff --git a/xml/System.Windows.Controls/WebBrowser.xml b/xml/System.Windows.Controls/WebBrowser.xml
@@ -71,7 +71,7 @@ private void goNavigateButton_Click(object sender, RoutedEventArgs e)
     // Only absolute URIs can be navigated to  
     if (!uri.IsAbsoluteUri)  
     {  
-        MessageBox.Show("The Address URI must be absolute eg 'http://www.microsoft.com'");  
+        MessageBox.Show("The Address URI must be absolute. For example, 'http://www.microsoft.com'");  
         return;  
     }  
   
@@ -714,7 +714,7 @@ private void goNavigateButton_Click(object sender, RoutedEventArgs e)
     // Only absolute URIs can be navigated to  
     if (!uri.IsAbsoluteUri)  
     {  
-        MessageBox.Show("The Address URI must be absolute eg 'http://www.microsoft.com'");  
+        MessageBox.Show("The Address URI must be absolute. For example, 'http://www.microsoft.com'");  
         return;  
     }  
   
@@ -825,7 +825,7 @@ private void goNavigateButton_Click(object sender, RoutedEventArgs e)
     // Only absolute URIs can be navigated to  
     if (!uri.IsAbsoluteUri)  
     {  
-        MessageBox.Show("The Address URI must be absolute eg 'http://www.microsoft.com'");  
+        MessageBox.Show("The Address URI must be absolute. For example, 'http://www.microsoft.com'");  
         return;  
     }  
   
diff --git a/xml/System.Windows.Xps.Serialization/XpsSerializerFactory.xml b/xml/System.Windows.Xps.Serialization/XpsSerializerFactory.xml
@@ -196,7 +196,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- This method always returns the [!INCLUDE[TLA#tla_uri](~/includes/tlasharptla-uri-md.md)] "http://www.microsoft.com".  
+ This method always returns the uniform resource identifier (URI) `http://www.microsoft.com`.
   
  ]]></format>
         </remarks>
diff --git a/xml/System.Xml.Schema/XmlSchemaSet.xml b/xml/System.Xml.Schema/XmlSchemaSet.xml
@@ -392,7 +392,7 @@ foreach(XmlSchema schema in schemaSet.Schemas("http://www.contoso.com/books"))
 }  
 ```  
   
- In the code example above, `null` is specified as the `targetNamespace` parameter to the <xref:System.Xml.Schema.XmlSchemaSet.Add%2A> method. As a result, the `targetNamespace` defined in the books.xml file is used. In this case, the result of calling the <xref:System.Xml.Schema.XmlSchemaSet.Add%2A> method would be identical if http://www.contoso.com/books had been specified as the `targetNamespace` parameter.  
+ In the code example above, `null` is specified as the `targetNamespace` parameter to the <xref:System.Xml.Schema.XmlSchemaSet.Add%2A> method. As a result, the `targetNamespace` defined in the books.xml file is used. In this case, the result of calling the <xref:System.Xml.Schema.XmlSchemaSet.Add%2A> method would be identical if `http://www.contoso.com/books` had been specified as the `targetNamespace` parameter.  
   
 -   W3C XML Schema allows schemas without a target namespace to be included in schemas with a target namespace defined. In this case, the schema without a target namespace defined is coerced into the target namespace of the including schema. The included schema is treated as if it had that target namespace defined. Similarly, schemas without a target namespace can be added to the <xref:System.Xml.Schema.XmlSchemaSet> and coerced into the target namespace specified by the <xref:System.Xml.Schema.XmlSchemaSet.Add%2A> method, as illustrated in the following example.  
   
@@ -402,7 +402,7 @@ foreach(XmlSchema schema in schemaSet.Schemas("http://www.contoso.com/books"))
 </xs:schema>  
 ```  
   
- If the schema above is added to the <xref:System.Xml.Schema.XmlSchemaSet> with the target namespace http://www.contoso.com/new/targetnamespace (as shown in the code below), it is treated as if the target namespace declared in the schema was `http://www.contoso.com/new/targetnamespace`.  
+ If the schema above is added to the <xref:System.Xml.Schema.XmlSchemaSet> with the target namespace `http://www.contoso.com/new/targetnamespace` (as shown in the code below), it is treated as if the target namespace declared in the schema was `http://www.contoso.com/new/targetnamespace`.  
   
 ```vb  
 Dim schemaSet As XmlSchemaSet = New XmlSchemaSet()  
@@ -429,7 +429,7 @@ foreach(XmlSchema schema in schemaSet.Schemas())
    
   
 ## Examples  
- The following code example adds the http://www.contoso.com/books.xsd schema with a target namespace of http://www.contoso.com/books to the <xref:System.Xml.Schema.XmlSchemaSet>.  
+ The following code example adds the `http://www.contoso.com/books.xsd` schema with a target namespace of `http://www.contoso.com/books` to the <xref:System.Xml.Schema.XmlSchemaSet>.  
   
 ```vb  
 Dim schemaSet As XmlSchemaSet = New XmlSchemaSet()  
@@ -516,7 +516,7 @@ schemaSet.Add("http://www.contoso.com/books", "http://www.contoso.com/books.xsd"
    
   
 ## Examples  
- The following code example adds the books.xsd schema contained in the <xref:System.Xml.XmlTextReader> with a target namespace of http://www.contoso.com/books to the <xref:System.Xml.Schema.XmlSchemaSet>.  
+ The following code example adds the books.xsd schema contained in the <xref:System.Xml.XmlTextReader> with a target namespace of `http://www.contoso.com/books` to the <xref:System.Xml.Schema.XmlSchemaSet>.  
   
 ```vb  
 Dim schemaSet As XmlSchemaSet = New XmlSchemaSet()  
@@ -693,7 +693,7 @@ schemaSet.Compile();
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- Schemas that are indirectly added to the <xref:System.Xml.Schema.XmlSchemaSet> are detected by the <xref:System.Xml.Schema.XmlSchemaSet.Contains%2A> method; for example, imported schemas. As a result, if a schema for the http://www.contoso.com/retail namespace which imports a schema for the http://www.contoso.com/books namespace is added to the <xref:System.Xml.Schema.XmlSchemaSet>, calling <xref:System.Xml.Schema.XmlSchemaSet.Contains%2A> with `http://www.contoso.com/books` as a parameter, it returns `true`.  
+ Schemas that are indirectly added to the <xref:System.Xml.Schema.XmlSchemaSet> are detected by the <xref:System.Xml.Schema.XmlSchemaSet.Contains%2A> method; for example, imported schemas. As a result, if a schema for the `http://www.contoso.com/retail` namespace which imports a schema for the `http://www.contoso.com/books` namespace is added to the <xref:System.Xml.Schema.XmlSchemaSet>, calling <xref:System.Xml.Schema.XmlSchemaSet.Contains%2A> with `http://www.contoso.com/books` as a parameter, it returns `true`.  
   
  ]]></format>
         </remarks>
@@ -1460,7 +1460,7 @@ foreach (XmlSchema schema in schemaSet.Schemas())
    
   
 ## Examples  
- The following example illustrates how to iterate over all the schemas in the http://www.contoso.com/books namespace in the <xref:System.Xml.Schema.XmlSchemaSet>.  
+ The following example illustrates how to iterate over all the schemas in the `http://www.contoso.com/books` namespace in the <xref:System.Xml.Schema.XmlSchemaSet>.  
   
 ```vb  
 Dim schemaSet As XmlSchemaSet = New XmlSchemaSet  

Original file line number	Diff line number	Diff line change
`@@ -71,7 +71,7 @@ private void goNavigateButton_Click(object sender, RoutedEventArgs e)`
`71`	`71`	`// Only absolute URIs can be navigated to`
`72`	`72`	`if (!uri.IsAbsoluteUri)`
`73`	`73`	`{`
`74`		`- MessageBox.Show("The Address URI must be absolute eg 'http://www.microsoft.com'");`
	`74`	`+ MessageBox.Show("The Address URI must be absolute. For example, 'http://www.microsoft.com'");`
`75`	`75`	`return;`
`76`	`76`	`}`
`77`	`77`
`@@ -714,7 +714,7 @@ private void goNavigateButton_Click(object sender, RoutedEventArgs e)`
`714`	`714`	`// Only absolute URIs can be navigated to`
`715`	`715`	`if (!uri.IsAbsoluteUri)`
`716`	`716`	`{`
`717`		`- MessageBox.Show("The Address URI must be absolute eg 'http://www.microsoft.com'");`
	`717`	`+ MessageBox.Show("The Address URI must be absolute. For example, 'http://www.microsoft.com'");`
`718`	`718`	`return;`
`719`	`719`	`}`
`720`	`720`
`@@ -825,7 +825,7 @@ private void goNavigateButton_Click(object sender, RoutedEventArgs e)`
`825`	`825`	`// Only absolute URIs can be navigated to`
`826`	`826`	`if (!uri.IsAbsoluteUri)`
`827`	`827`	`{`
`828`		`- MessageBox.Show("The Address URI must be absolute eg 'http://www.microsoft.com'");`
	`828`	`+ MessageBox.Show("The Address URI must be absolute. For example, 'http://www.microsoft.com'");`
`829`	`829`	`return;`
`830`	`830`	`}`
`831`	`831`