Skip to content

Commit 08565a6

Browse files
mairawmairaw
authored
markdig fixes - Part 3 (#2554)
* markdig fixes * add missing langid * Apply suggestions from peer review Co-Authored-By: Ron Petrusha <[email protected]> * feedback
1 parent 13fa3eb commit 08565a6

File tree

10 files changed

+30
-60
lines changed

10 files changed

+30
-60
lines changed

‎xml/Microsoft.VisualBasic/FileSystem.xml

Lines changed: 1 addition & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -3638,32 +3638,7 @@
36383638
<Docs>
36393639
<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>
36403640
<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>
3641-
<returns>The value returned by <see langword="GetAttr" /> is the sum of the following enumeration values:
3642-
3643-
<list type="table"><item><term> Value
3644-
3645-
</term><description> Constant
3646-
3647-
</description><description> Description
3648-
3649-
</description></item><item><term><see langword="Normal" /></term><description><see langword="vbNormal" /></description><description> Normal.
3650-
3651-
</description></item><item><term><see langword="ReadOnly" /></term><description><see langword="vbReadOnly" /></description><description> Read-only.
3652-
3653-
</description></item><item><term><see langword="Hidden" /></term><description><see langword="vbHidden" /></description><description> Hidden.
3654-
3655-
</description></item><item><term><see langword="System" /></term><description><see langword="vbSystem" /></description><description> System file.
3656-
3657-
</description></item><item><term><see langword="Directory" /></term><description><see langword="vbDirectory" /></description><description> Directory or folder.
3658-
3659-
</description></item><item><term><see langword="Archive" /></term><description><see langword="vbArchive" /></description><description> File has changed since last backup.
3660-
3661-
</description></item><item><term><see langword="Alias" /></term><description><see langword="vbAlias" /></description><description> File has a different name.
3662-
3663-
</description></item></list><block subset="none" type="note"><para>
3664-
These enumerations are specified by the Visual Basic language. The names can be used anywhere in your code in place of the actual values.
3665-
3666-
</para></block></returns>
3641+
<returns>A bitwise combination of the enumeration values.</returns>
36673642
<remarks>
36683643
<format type="text/markdown"><![CDATA[
36693644

‎xml/System.Threading.Tasks/TaskFactory`1.xml

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -596,7 +596,7 @@
596596
<Docs>
597597
<param name="tasks">The array of tasks from which to continue.</param>
598598
<param name="continuationFunction">The function delegate to execute asynchronously when all tasks in the <paramref name="tasks" /> array have completed.</param>
599-
<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>
599+
<param name="continuationOptions">One of the enumeration values that controls the behavior of the created continuation task. The <see langword="NotOn*" /> and <see langword="OnlyOn*" /> values are not valid.</param>
600600
<summary>Creates a continuation task that will be started upon the completion of a set of provided Tasks.</summary>
601601
<returns>The new continuation task.</returns>
602602
<remarks>
@@ -661,7 +661,7 @@
661661
<param name="tasks">The array of tasks from which to continue.</param>
662662
<param name="continuationFunction">The function delegate to execute asynchronously when all tasks in the <paramref name="tasks" /> array have completed.</param>
663663
<param name="cancellationToken">The cancellation token that will be assigned to the new continuation task.</param>
664-
<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>
664+
<param name="continuationOptions">One of the enumeration values that controls the behavior of the created continuation task. The <see langword="NotOn*" /> and <see langword="OnlyOn*" /> values are not valid.</param>
665665
<param name="scheduler">The scheduler that is used to schedule the created continuation task.</param>
666666
<summary>Creates a continuation task that will be started upon the completion of a set of provided Tasks.</summary>
667667
<returns>The new continuation task.</returns>
@@ -871,7 +871,7 @@
871871
<typeparam name="TAntecedentResult">The type of the result of the antecedent <paramref name="tasks" />.</typeparam>
872872
<param name="tasks">The array of tasks from which to continue.</param>
873873
<param name="continuationFunction">The function delegate to execute asynchronously when all tasks in the <paramref name="tasks" /> array have completed.</param>
874-
<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>
874+
<param name="continuationOptions">One of the enumeration values that controls the behavior of the created continuation task. The <see langword="NotOn*" /> and <see langword="OnlyOn*" /> values are not valid.</param>
875875
<summary>Creates a continuation task that will be started upon the completion of a set of provided tasks.</summary>
876876
<returns>The new continuation task.</returns>
877877
<remarks>
@@ -940,7 +940,7 @@
940940
<param name="tasks">The array of tasks from which to continue.</param>
941941
<param name="continuationFunction">The function delegate to execute asynchronously when all tasks in the <paramref name="tasks" /> array have completed.</param>
942942
<param name="cancellationToken">The cancellation token that will be assigned to the new continuation task.</param>
943-
<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>
943+
<param name="continuationOptions">One of the enumeration values that controls the behavior of the created continuation task. The <see langword="NotOn*" /> and <see langword="OnlyOn*" /> values are not valid.</param>
944944
<param name="scheduler">The scheduler that is used to schedule the created continuation task.</param>
945945
<summary>Creates a continuation task that will be started upon the completion of a set of provided tasks.</summary>
946946
<returns>The new continuation task.</returns>
@@ -1154,7 +1154,7 @@
11541154
<Docs>
11551155
<param name="tasks">The array of tasks from which to continue when one task completes.</param>
11561156
<param name="continuationFunction">The function delegate to execute asynchronously when one task in the <paramref name="tasks" /> array completes.</param>
1157-
<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>
1157+
<param name="continuationOptions">One of the enumeration values that controls the behavior of the created continuation task. The <see langword="NotOn*" /> and <see langword="OnlyOn*" /> values are not valid.</param>
11581158
<summary>Creates a continuation task that will be started upon the completion of any task in the provided set.</summary>
11591159
<returns>The new continuation task.</returns>
11601160
<remarks>
@@ -1223,7 +1223,7 @@
12231223
<param name="tasks">The array of tasks from which to continue when one task completes.</param>
12241224
<param name="continuationFunction">The function delegate to execute asynchronously when one task in the <paramref name="tasks" /> array completes.</param>
12251225
<param name="cancellationToken">The cancellation token that will be assigned to the new continuation task.</param>
1226-
<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>
1226+
<param name="continuationOptions">One of the enumeration values that controls the behavior of the created continuation task. The <see langword="NotOn*" /> and <see langword="OnlyOn*" /> values are not valid.</param>
12271227
<param name="scheduler">The task scheduler that is used to schedule the created continuation task.</param>
12281228
<summary>Creates a continuation task that will be started upon the completion of any task in the provided set.</summary>
12291229
<returns>The new continuation task.</returns>
@@ -1445,7 +1445,7 @@
14451445
<typeparam name="TAntecedentResult">The type of the result of the antecedent <paramref name="tasks" />.</typeparam>
14461446
<param name="tasks">The array of tasks from which to continue when one task completes.</param>
14471447
<param name="continuationFunction">The function delegate to execute asynchronously when one task in the <paramref name="tasks" /> array completes.</param>
1448-
<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>
1448+
<param name="continuationOptions">One of the enumeration values that controls the behavior of the created continuation task. The <see langword="NotOn*" /> and <see langword="OnlyOn*" /> values are not valid.</param>
14491449
<summary>Creates a continuation task that will be started upon the completion of any task in the provided set.</summary>
14501450
<returns>The new continuation <see cref="T:System.Threading.Tasks.Task`1" />.</returns>
14511451
<remarks>
@@ -1518,7 +1518,7 @@
15181518
<param name="tasks">The array of tasks from which to continue when one task completes.</param>
15191519
<param name="continuationFunction">The function delegate to execute asynchronously when one task in the <paramref name="tasks" /> array completes.</param>
15201520
<param name="cancellationToken">The cancellation token that will be assigned to the new continuation task.</param>
1521-
<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>
1521+
<param name="continuationOptions">One of the enumeration values that controls the behavior of the created continuation task. The <see langword="NotOn*" /> and <see langword="OnlyOn*" /> values are not valid.</param>
15221522
<param name="scheduler">The <see cref="T:System.Threading.Tasks.TaskScheduler" /> that is used to schedule the created continuation <see cref="T:System.Threading.Tasks.Task`1" />.</param>
15231523
<summary>Creates a continuation task that will be started upon the completion of any task in the provided set.</summary>
15241524
<returns>The new continuation <see cref="T:System.Threading.Tasks.Task`1" />.</returns>
@@ -2844,4 +2844,4 @@
28442844
</Docs>
28452845
</Member>
28462846
</Members>
2847-
</Type>
2847+
</Type>

‎xml/System.Web.UI.DataVisualization.Charting/BorderSkinStyle.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121
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.
2222
2323
> [!NOTE]
24-
> 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.
24+
> 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.
2525
2626
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.
2727

‎xml/System.Web.UI.WebControls/AdRotator.xml

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -88,11 +88,11 @@
8888
|`Width`|The width of the image, in pixels (optional).|
8989
|`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.|
9090
|`Keyword`|A category for the advertisement (for example, "computers") that you can filter by (optional).|
91-
|`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.|
91+
|`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.|
9292
9393
The following example shows the format for the XML advertisement file.
9494
95-
```
95+
```xml
9696
<Advertisements>
9797
<Ad>
9898
<ImageUrl>
@@ -172,7 +172,7 @@
172172
173173
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.
174174
175-
```
175+
```xml
176176
<Advertisements>
177177
<Ad>
178178
<ImageUrl>~/Images/image1.jpg</ImageUrl>
@@ -292,7 +292,7 @@
292292
293293
The following code example demonstrates how to format the XML file that contains the advertisement information. For more information on the XML file, see the <xref:System.Web.UI.WebControls.AdRotator.AdvertisementFile%2A> property.
294294
295-
```
295+
```xml
296296
<Advertisements>
297297
<Ad>
298298
<ImageUrl>~/Images/image1.jpg</ImageUrl>
@@ -418,7 +418,7 @@
418418
419419
The following code example shows the file format of the XML advertisement file.
420420
421-
```
421+
```xml
422422
<Advertisements>
423423
<Ad>
424424
<ImageUrl>~/Images/image1.jpg</ImageUrl>
@@ -489,7 +489,7 @@
489489
490490
The following is the sample XML data for the previous example.
491491
492-
```
492+
```xml
493493
<Advertisements>
494494
<Ad>
495495
<ImageUrl>~/Images/ad1.gif</ImageUrl>
@@ -620,7 +620,7 @@
620620
621621
The following is the sample XML data for the previous example.
622622
623-
```
623+
```xml
624624
<Advertisements>
625625
<Ad>
626626
<ImageUrl>~/Images/ad1.gif</ImageUrl>
@@ -708,7 +708,7 @@
708708
709709
The following code example demonstrates how to specify a keyword for each advertisement in the XML advertisement file. For more information on the file format, see the <xref:System.Web.UI.WebControls.AdRotator.AdvertisementFile%2A> member.
710710
711-
```
711+
```xml
712712
<Advertisements>
713713
<Ad>
714714
<ImageUrl>~/Images/image1.jpg</ImageUrl>
@@ -778,7 +778,7 @@
778778
779779
The following is the sample XML data for the previous example.
780780
781-
```
781+
```xml
782782
<Advertisements>
783783
<Ad>
784784
<ImageUrl>~/Images/ad1.gif</ImageUrl>
@@ -854,7 +854,7 @@
854854
855855
The following code example demonstrates how to format the XML file that contains the advertisement information. For more information on the XML file, see the <xref:System.Web.UI.WebControls.AdRotator.AdvertisementFile%2A> property.
856856
857-
```
857+
```xml
858858
<Advertisements>
859859
<Ad>
860860
<ImageUrl>~/Images/image1.jpg</ImageUrl>
@@ -1164,7 +1164,7 @@
11641164
11651165
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.
11661166
1167-
```
1167+
```xml
11681168
<Advertisements>
11691169
<Ad>
11701170
<ImageUrl>~/Images/image1.jpg</ImageUrl>
@@ -1226,4 +1226,4 @@
12261226
</Docs>
12271227
</Member>
12281228
</Members>
1229-
</Type>
1229+
</Type>

‎xml/System.Windows.Forms/KeyPressEventArgs.xml

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -222,10 +222,6 @@
222222
> [!NOTE]
223223
> For information about how to detect any of the non-character keys mentioned above, see the <xref:System.Windows.Forms.KeyEventArgs> class.
224224
225-
-
226-
227-
228-
229225
## Examples
230226
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.
231227

‎xml/System.Windows.Media.Media3D/Point3DCollection.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -80,7 +80,7 @@
8080
*oneOrMorePoint3Ds*
8181
One or more <xref:System.Windows.Media.Media3D.Point3D> structures, with each set of values delimited by commas and/or one or more spaces.
8282
83-
<xref:System.Windows.Media.Media3D.Point3D> *[delimiter* <xref:System.Windows.Media.Media3D.Point3D> *]\**
83+
<xref:System.Windows.Media.Media3D.Point3D>_[delimiter_<xref:System.Windows.Media.Media3D.Point3D>_]\*_
8484
8585
For example, `"0,0,5 100,100,125 200,100,30"` and `"0,0,5,100,100,125,200,100,30"` are both valid.
8686

‎xml/System.Windows.Media/Int32Collection.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@
7272
*oneOrMoreKInt32Values*
7373
One or more <xref:System.Int32> values, with each pair delimited by a single comma and/or one or more spaces:
7474
75-
<xref:System.Int32> *[delimiter* <xref:System.Int32> *]\**
75+
<xref:System.Int32>_[delimiter_<xref:System.Int32>_]\*_
7676
7777
For example, `"5 10 43"` and `"5,10,43"` are both valid.
7878

‎xml/System.Windows.Media/VectorCollection.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@
7272
*oneOrMoreVectors*
7373
One or more vector values, with each pair delimited by a single comma and/or one or more spaces:
7474
75-
<xref:System.Windows.Vector> *[delimiter* <xref:System.Windows.Vector> *]\**
75+
<xref:System.Windows.Vector>_[delimiter_<xref:System.Windows.Vector>_]\*_
7676
7777
For example, `"0,0 100,100 200,100"` and `"0,0,100,100,200,100"` are both valid.
7878

0 commit comments

Comments
 (0)