Skip to content

Commit 9fa7560

Browse files
author
Ron Petrusha
authored
Address Policheck issues, Part 1 (#2522)
* Address Policheck issues, Part 1 * Capitalized 'world cup' * Replaced tokens with text
1 parent e6c5213 commit 9fa7560

File tree

19 files changed

+34
-36
lines changed

19 files changed

+34
-36
lines changed

includes/tla2sharptla-metro-md.md

Lines changed: 0 additions & 1 deletion
This file was deleted.

includes/tlasharptla-metro-md.md

Lines changed: 0 additions & 1 deletion
This file was deleted.

xml/System.Data.Services.Client/DataServiceCollection`1.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@
3535
3636
3737
## Examples
38-
The following example is from the code-behind page for an Extensible Application Markup Language (XAML) page that defines the `SalesOrders` window in WPF. When the window is loaded, an <xref:System.Data.Services.Client.DataServiceCollection%601> is created based on the result of a query that returns customers with related objects, filtered by country. This result is bound to the <xref:System.Windows.FrameworkElement.DataContext%2A> property of the <xref:System.Windows.Controls.StackPanel> that is the root layout control for the WPF window.
38+
The following example is from the code-behind page for an Extensible Application Markup Language (XAML) page that defines the `SalesOrders` window in WPF. When the window is loaded, an <xref:System.Data.Services.Client.DataServiceCollection%601> is created based on the result of a query that returns customers with related objects, filtered by country/region. This result is bound to the <xref:System.Windows.FrameworkElement.DataContext%2A> property of the <xref:System.Windows.Controls.StackPanel> that is the root layout control for the WPF window.
3939
4040
[!code-csharp[Astoria Northwind Client#WpfDataBinding](~/samples/snippets/csharp/VS_Snippets_Misc/astoria_northwind_client/cs/customerorderswpf.xaml.cs#wpfdatabinding)]
4141
[!code-vb[Astoria Northwind Client#WpfDataBinding](~/samples/snippets/visualbasic/VS_Snippets_Misc/astoria_northwind_client/vb/customerorderswpf.xaml.vb#wpfdatabinding)]
@@ -406,7 +406,7 @@
406406
407407
408408
## Examples
409-
The following example is from the code-behind page for an Extensible Application Markup Language (XAML) page that defines the `SalesOrders` window in WPF. When the window is loaded, a <xref:System.Data.Services.Client.DataServiceCollection%601> is created based on the result of a query that returns customers, filtered by country. All of the pages of this paged result are loaded, along with the related orders, and are bound to the <xref:System.Windows.FrameworkElement.DataContext%2A> property of the <xref:System.Windows.Controls.StackPanel> that is the root layout control for the WPF window. For more information, see [How to: Bind Data to Windows Presentation Foundation Elements](~/docs/framework/data/wcf/bind-data-to-wpf-elements-wcf-data-services.md).
409+
The following example is from the code-behind page for an Extensible Application Markup Language (XAML) page that defines the `SalesOrders` window in WPF. When the window is loaded, a <xref:System.Data.Services.Client.DataServiceCollection%601> is created based on the result of a query that returns customers, filtered by country/region. All of the pages of this paged result are loaded, along with the related orders, and are bound to the <xref:System.Windows.FrameworkElement.DataContext%2A> property of the <xref:System.Windows.Controls.StackPanel> that is the root layout control for the WPF window. For more information, see [How to: Bind Data to Windows Presentation Foundation Elements](~/docs/framework/data/wcf/bind-data-to-wpf-elements-wcf-data-services.md).
410410
411411
[!code-csharp[Astoria Northwind Client#BindPagedData](~/samples/snippets/csharp/VS_Snippets_Misc/astoria_northwind_client/cs/customerorderswpf3.xaml.cs#bindpageddata)]
412412
[!code-vb[Astoria Northwind Client#BindPagedData](~/samples/snippets/visualbasic/VS_Snippets_Misc/astoria_northwind_client/vb/customerorderswpf3.xaml.vb#bindpageddata)]

xml/System.Globalization/CultureInfo.xml

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1916,9 +1916,9 @@ csc /resource:GreetingStrings.resources Example1.cs
19161916
|Arabic (Yemen)|ar-YE|en-US|
19171917
|Assamese|as|en-US|
19181918
|Assamese (India)|as-IN|en-US|
1919-
|Bengali|bn|en-US|
1920-
|Bengali (Bangladesh)|bn-BD|en-US|
1921-
|Bengali (India)|bn-IN|en-US|
1919+
|Bangla|bn|en-US|
1920+
|Bangla (Bangladesh)|bn-BD|en-US|
1921+
|Bangla (India)|bn-IN|en-US|
19221922
|Tibetan|bo|en-US|
19231923
|Tibetan (PRC)|bo-CN|en-US|
19241924
|Divehi|dv|en-US|
@@ -1952,8 +1952,8 @@ csc /resource:GreetingStrings.resources Example1.cs
19521952
|Nepali|ne|en-US|
19531953
|Nepali (Nepal)|ne-NP|en-US|
19541954
|Norwegian|no|nb-NO|
1955-
|Oriya|or|en-US|
1956-
|Oriya (India)|or-IN|en-US|
1955+
|Odiya|or|en-US|
1956+
|Odiya (India)|or-IN|en-US|
19571957
|Punjabi|pa|en-US|
19581958
|Punjabi (India)|pa-IN|en-US|
19591959
|Dari|prs|en-US|

xml/System.Globalization/PersianCalendar.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@
4141
<format type="text/markdown"><![CDATA[
4242
4343
## Remarks
44-
The Persian calendar is used in most countries where Persian is spoken, although some regions use different month names. The Persian calendar is the official calendar of Iran and Afghanistan, and it is one of the alternative calendars in regions such as Kazakhstan and Tajikistan.
44+
The Persian calendar is used in most countries/regions where Persian is spoken, although some regions use different month names. The Persian calendar is the official calendar of Iran and Afghanistan, and it is one of the alternative calendars in regions such as Kazakhstan and Tajikistan.
4545
4646
> [!NOTE]
4747
> For information about using the <xref:System.Globalization.PersianCalendar> class and the other calendar classes in the .NET Framework, see [Working with Calendars](~/docs/standard/datetime/working-with-calendars.md).

xml/System.Globalization/RegionInfo.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -947,7 +947,7 @@
947947
|Lithuania|Lithuanian Litas|LTL|
948948
|Luxembourg|Euro|EUR|
949949
|Macao SAR|Macao Pataca|MOP|
950-
|Macedonia (FYROM)|Macedonian Denar|MKD|
950+
|North Macedonia|Macedonian Denar|MKD|
951951
|Malaysia|Malaysian Ringgit|MYR|
952952
|Maldives|Rufiyaa|MVR|
953953
|Mexico|Mexican Peso|MXN|

xml/System.Printing/PrintJobType.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@
5858
</ReturnValue>
5959
<MemberValue>0</MemberValue>
6060
<Docs>
61-
<summary>Not specified whether the print job is [!INCLUDE[TLA2#tla_metro](~/includes/tla2sharptla-metro-md.md)].</summary>
61+
<summary>Not specified whether the print job is XPS.</summary>
6262
</Docs>
6363
</Member>
6464
<Member MemberName="Xps">
@@ -79,7 +79,7 @@
7979
</ReturnValue>
8080
<MemberValue>1</MemberValue>
8181
<Docs>
82-
<summary>An [!INCLUDE[TLA2#tla_metro](~/includes/tla2sharptla-metro-md.md)] print job.</summary>
82+
<summary>An XPS print job.</summary>
8383
</Docs>
8484
</Member>
8585
</Members>

xml/System.Speech.Recognition.SrgsGrammar/SrgsDocument.xml

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -79,7 +79,7 @@
7979
8080
8181
## Examples
82-
The following example creates an <xref:System.Speech.Recognition.SrgsGrammar.SrgsDocument> object and then creates a public rule named `winnerRule`. It then creates an <xref:System.Speech.Recognition.SrgsGrammar.SrgsItem> that consists of the string "A nation that has won the world cup is:", and adds this item to the <xref:System.Speech.Recognition.SrgsGrammar.SrgsRule.Elements%2A> property of the rule. The example then creates two more rules (`ruleEurope` and `ruleSAmerica`), each of which is an <xref:System.Speech.Recognition.SrgsGrammar.SrgsOneOf> object that contains three <xref:System.Speech.Recognition.SrgsGrammar.SrgsItem> objects. After that, another <xref:System.Speech.Recognition.SrgsGrammar.SrgsOneOf> object is created that contains <xref:System.Speech.Recognition.SrgsGrammar.SrgsRuleRef> objects that refer to `ruleEurope` and `ruleSAmerica`. The new <xref:System.Speech.Recognition.SrgsGrammar.SrgsOneOf> object is then added to the <xref:System.Speech.Recognition.SrgsGrammar.SrgsRule.Elements%2A> property of `winnerRule`. After this, all three rules (`winnerRule`, `ruleEurope`, and `ruleSAmerica`) are added to the <xref:System.Speech.Recognition.SrgsGrammar.SrgsDocument.Rules%2A> property of <xref:System.Speech.Recognition.SrgsGrammar.SrgsDocument>. Finally, the three rules are compiled into a binary representation of the grammar.
82+
The following example creates an <xref:System.Speech.Recognition.SrgsGrammar.SrgsDocument> object and then creates a public rule named `winnerRule`. It then creates an <xref:System.Speech.Recognition.SrgsGrammar.SrgsItem> that consists of the string "A nation that has won the World Cup is:", and adds this item to the <xref:System.Speech.Recognition.SrgsGrammar.SrgsRule.Elements%2A> property of the rule. The example then creates two more rules (`ruleEurope` and `ruleSAmerica`), each of which is an <xref:System.Speech.Recognition.SrgsGrammar.SrgsOneOf> object that contains three <xref:System.Speech.Recognition.SrgsGrammar.SrgsItem> objects. After that, another <xref:System.Speech.Recognition.SrgsGrammar.SrgsOneOf> object is created that contains <xref:System.Speech.Recognition.SrgsGrammar.SrgsRuleRef> objects that refer to `ruleEurope` and `ruleSAmerica`. The new <xref:System.Speech.Recognition.SrgsGrammar.SrgsOneOf> object is then added to the <xref:System.Speech.Recognition.SrgsGrammar.SrgsRule.Elements%2A> property of `winnerRule`. After this, all three rules (`winnerRule`, `ruleEurope`, and `ruleSAmerica`) are added to the <xref:System.Speech.Recognition.SrgsGrammar.SrgsDocument.Rules%2A> property of <xref:System.Speech.Recognition.SrgsGrammar.SrgsDocument>. Finally, the three rules are compiled into a binary representation of the grammar.
8383
8484
```csharp
8585
public void WorldSoccerWinners ()
@@ -92,7 +92,7 @@ public void WorldSoccerWinners ()
9292
winnerRule.Scope = SrgsRuleScope.Public;
9393
9494
// Add the introduction.
95-
winnerRule.Elements.Add(new SrgsItem("A nation that has won the world cup is: "));
95+
winnerRule.Elements.Add(new SrgsItem("A nation that has won the World Cup is: "));
9696
9797
// Create the rule for the European nations.
9898
SrgsOneOf oneOfEurope = new SrgsOneOf(new SrgsItem[] {new SrgsItem("England"),
@@ -668,7 +668,7 @@ public void WorldSoccerWinners ()
668668
winnerRule.Scope = SrgsRuleScope.Public;
669669
670670
// Add the introduction.
671-
winnerRule.Elements.Add(new SrgsItem("A nation that has won the world cup is: "));
671+
winnerRule.Elements.Add(new SrgsItem("A nation that has won the World Cup is: "));
672672
673673
// Create the rule for the European nations.
674674
SrgsOneOf oneOfEurope = new SrgsOneOf(new SrgsItem[] {new SrgsItem("England"),
@@ -755,7 +755,7 @@ public void WorldSoccerWinners ()
755755
<format type="text/markdown"><![CDATA[
756756
757757
## Examples
758-
The following example creates an <xref:System.Speech.Recognition.SrgsGrammar.SrgsDocument> object, and then creates a public rule named `winnerRule`. It then creates an <xref:System.Speech.Recognition.SrgsGrammar.SrgsItem> that consists of the string "A nation that has won the world cup is:", and adds this item to the <xref:System.Speech.Recognition.SrgsGrammar.SrgsRule.Elements%2A> property of the rule. The example then creates two more rules (`ruleEurope` and `ruleSAmerica`), each of which is an <xref:System.Speech.Recognition.SrgsGrammar.SrgsOneOf> object that contains three <xref:System.Speech.Recognition.SrgsGrammar.SrgsItem> objects. After that, another <xref:System.Speech.Recognition.SrgsGrammar.SrgsOneOf> object is created that contains <xref:System.Speech.Recognition.SrgsGrammar.SrgsRuleRef> objects that refer to `ruleEurope` and `ruleSAmerica`. The new <xref:System.Speech.Recognition.SrgsGrammar.SrgsOneOf> object is then added to the <xref:System.Speech.Recognition.SrgsGrammar.SrgsRule.Elements%2A> property of `winnerRule`. After this, all three rules (`winnerRule`, `ruleEurope`, and `ruleSAmerica`) are added to the <xref:System.Speech.Recognition.SrgsGrammar.SrgsDocument.Rules%2A> property of the <xref:System.Speech.Recognition.SrgsGrammar.SrgsDocument>. Finally, the example creates an empty XML file and an instance of <xref:System.Xml.XmlWriter>. The <xref:System.Speech.Recognition.SrgsGrammar.SrgsDocument.WriteSrgs%2A> method uses the <xref:System.Xml.XmlWriter> instance to write the contents of the <xref:System.Speech.Recognition.SrgsGrammar.SrgsDocument> to the XML file.
758+
The following example creates an <xref:System.Speech.Recognition.SrgsGrammar.SrgsDocument> object, and then creates a public rule named `winnerRule`. It then creates an <xref:System.Speech.Recognition.SrgsGrammar.SrgsItem> that consists of the string "A nation that has won the World Cup is:", and adds this item to the <xref:System.Speech.Recognition.SrgsGrammar.SrgsRule.Elements%2A> property of the rule. The example then creates two more rules (`ruleEurope` and `ruleSAmerica`), each of which is an <xref:System.Speech.Recognition.SrgsGrammar.SrgsOneOf> object that contains three <xref:System.Speech.Recognition.SrgsGrammar.SrgsItem> objects. After that, another <xref:System.Speech.Recognition.SrgsGrammar.SrgsOneOf> object is created that contains <xref:System.Speech.Recognition.SrgsGrammar.SrgsRuleRef> objects that refer to `ruleEurope` and `ruleSAmerica`. The new <xref:System.Speech.Recognition.SrgsGrammar.SrgsOneOf> object is then added to the <xref:System.Speech.Recognition.SrgsGrammar.SrgsRule.Elements%2A> property of `winnerRule`. After this, all three rules (`winnerRule`, `ruleEurope`, and `ruleSAmerica`) are added to the <xref:System.Speech.Recognition.SrgsGrammar.SrgsDocument.Rules%2A> property of the <xref:System.Speech.Recognition.SrgsGrammar.SrgsDocument>. Finally, the example creates an empty XML file and an instance of <xref:System.Xml.XmlWriter>. The <xref:System.Speech.Recognition.SrgsGrammar.SrgsDocument.WriteSrgs%2A> method uses the <xref:System.Xml.XmlWriter> instance to write the contents of the <xref:System.Speech.Recognition.SrgsGrammar.SrgsDocument> to the XML file.
759759
760760
```csharp
761761
public void WorldSoccerWinners ()
@@ -768,7 +768,7 @@ public void WorldSoccerWinners ()
768768
winnerRule.Scope = SrgsRuleScope.Public;
769769
770770
// Add the introduction.
771-
winnerRule.Elements.Add(new SrgsItem("A nation that has won the world cup is: "));
771+
winnerRule.Elements.Add(new SrgsItem("A nation that has won the World Cup is: "));
772772
773773
// Create the rule for the European nations.
774774
SrgsOneOf oneOfEurope = new SrgsOneOf(new SrgsItem[] {new SrgsItem("England"),

xml/System.Threading.Tasks/TaskScheduler.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -373,9 +373,9 @@ This example has some limitations. For example, only 32-bits-per-pixel images ar
373373
## Remarks
374374
A class derived from <xref:System.Threading.Tasks.TaskScheduler> implements this method in order to support integration with debuggers. This method will only be invoked by the .NET Framework when the debugger requests access to the data. The enumerable returned will be traversed by debugging utilities to access the tasks currently queued to this scheduler, enabling the debugger to provide a representation of this information in the user interface.
375375
376-
It is important to note that, when this method is called, all other threads in the process will be frozen. Therefore, it's important to avoid synchronization with other threads that may lead to blocking. If synchronization is necessary, and you are unable to acquire the lock in this method, then you should throw an exception so that the debugger does not hang. The following example shows one possible approach in C#:
376+
It is important to note that, when this method is called, all other threads in the process will be frozen. Therefore, it's important to avoid synchronization with other threads that may lead to blocking. If synchronization is necessary, and you are unable to acquire the lock in this method, then you should throw an exception so that the debugger does not block. The following example shows one possible approach in C#:
377377
378-
```
378+
```csharp
379379
protected override IEnumerable<Task> GetScheduledTasks()
380380
{
381381
bool lockTaken = false;

xml/System.Threading/Thread.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2425,7 +2425,7 @@ Main thread: ThreadProc.Join has returned. Press Enter to end program.
24252425
If the thread has already terminated when <xref:System.Threading.Thread.Join%2A> is called, the method returns immediately.
24262426
24272427
> [!WARNING]
2428-
> You should never call the <xref:System.Threading.Thread.Join%2A> method of the <xref:System.Threading.Thread> object that represents the current thread from the current thread. This causes your app to hang because the current thread waits upon itself indefinitely,
2428+
> You should never call the <xref:System.Threading.Thread.Join%2A> method of the <xref:System.Threading.Thread> object that represents the current thread from the current thread. This causes your app to become unresponsive because the current thread waits upon itself indefinitely,
24292429
24302430
This method changes the state of the calling thread to include <xref:System.Threading.ThreadState.WaitSleepJoin?displayProperty=nameWithType>. You cannot invoke `Join` on a thread that is in the <xref:System.Threading.ThreadState.Unstarted?displayProperty=nameWithType> state.
24312431

0 commit comments

Comments
 (0)