Skip to content

Commit eb71b96

Browse files
authored
fix that/which grammar (#11145)
1 parent ad0a0a4 commit eb71b96

File tree

66 files changed

+8915
-8947
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

66 files changed

+8915
-8947
lines changed

Diff for: xml/System.Buffers.Text/Base64Url.xml

+3-3
Original file line numberDiff line numberDiff line change
@@ -483,9 +483,9 @@
483483
<Parameter Name="source" Type="System.ReadOnlySpan&lt;System.Byte&gt;" />
484484
</Parameters>
485485
<Docs>
486-
<param name="source">The input span which contains binary data that needs to be encoded.</param>
487-
<summary>Encodes the span of binary data into unicode string represented as Base64Url ASCII chars.</summary>
488-
<returns>A string which contains the result of the operation, i.e. the ASCII string in Base64Url.</returns>
486+
<param name="source">The input span that contains binary data that needs to be encoded.</param>
487+
<summary>Encodes the span of binary data into Unicode string represented as Base64Url ASCII chars.</summary>
488+
<returns>A string that contains the result of the operation, i.e. the ASCII string in Base64Url.</returns>
489489
<remarks>This implementation of the base64url encoding omits the optional padding characters.</remarks>
490490
</Docs>
491491
</Member>

Diff for: xml/System.CommandLine.Builder/CommandLineBuilderExtensions.xml

+4-4
Original file line numberDiff line numberDiff line change
@@ -191,12 +191,12 @@
191191
<returns>The same instance of <see cref="T:System.CommandLine.Builder.CommandLineBuilder" />.</returns>
192192
<remarks>
193193
POSIX conventions recommend that single-character options be allowed to be specified together after a single <c>-</c> prefix. When <see cref="M:System.CommandLine.Builder.CommandLineBuilderExtensions.EnablePosixBundling(System.CommandLine.Builder.CommandLineBuilder,System.Boolean)" /> is set to <see langword="true" />, the following command lines are equivalent:
194-
194+
195195
<code>
196196
&gt; myapp -a -b -c
197197
&gt; myapp -abc
198198
</code>
199-
199+
200200
If an argument is provided after an option bundle, it applies to the last option in the bundle. When <see cref="M:System.CommandLine.Builder.CommandLineBuilderExtensions.EnablePosixBundling(System.CommandLine.Builder.CommandLineBuilder,System.Boolean)" /> is set to <see langword="true" />, all of the following command lines are equivalent:
201201
<code>
202202
&gt; myapp -a -b -c arg
@@ -600,7 +600,7 @@
600600
<Docs>
601601
<param name="builder">A command line builder.</param>
602602
<summary>
603-
Enables the use of the <c>[suggest]</c> directive which when specified in command line input short circuits normal command handling and writes a newline-delimited list of suggestions suitable for use by most shells to provide command line completions.
603+
Enables the use of the <c>[suggest]</c> directive, which, when specified in command-line input, short circuits normal command handling and writes a newline-delimited list of suggestions suitable for use by most shells to provide command-line completions.
604604
</summary>
605605
<returns>The same instance of <see cref="T:System.CommandLine.Builder.CommandLineBuilder" />.</returns>
606606
<remarks>The <c>dotnet-suggest</c> tool requires the suggest directive to be enabled for an application to provide completions.</remarks>
@@ -682,7 +682,7 @@
682682
<Docs>
683683
<param name="builder">A command line builder.</param>
684684
<summary>
685-
Enables the use of a option (defaulting to the alias <c>--version</c>) which when specified in command line input will short circuit normal command handling and instead write out version information before exiting.
685+
Enables the use of a option (defaulting to the alias <c>--version</c>), which, when specified in command-line input, short circuits normal command handling and instead write out version information before exiting.
686686
</summary>
687687
<returns>The same instance of <see cref="T:System.CommandLine.Builder.CommandLineBuilder" />.</returns>
688688
<remarks>To be added.</remarks>

Diff for: xml/System.CommandLine.Parsing/ParseArgument`1.xml

+1-1
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@
2626
<ReturnType>T</ReturnType>
2727
</ReturnValue>
2828
<Docs>
29-
<typeparam name="T">The type which the argument is to be parsed as.</typeparam>
29+
<typeparam name="T">The type that the argument is to be parsed as.</typeparam>
3030
<param name="result">The argument result.</param>
3131
<summary>
3232
Performs custom parsing of an argument.

Diff for: xml/System.ComponentModel.Design/CollectionEditor.xml

+63-63
Original file line numberDiff line numberDiff line change
@@ -52,15 +52,15 @@
5252
<Docs>
5353
<summary>Provides a user interface that can edit most types of collections at design time.</summary>
5454
<remarks>
55-
<format type="text/markdown"><![CDATA[
56-
57-
## Examples
58-
The following code example uses an <xref:System.ComponentModel.EditorAttribute> to associate the <xref:System.ComponentModel.Design.CollectionEditor> with a property.
59-
55+
<format type="text/markdown"><![CDATA[
56+
57+
## Examples
58+
The following code example uses an <xref:System.ComponentModel.EditorAttribute> to associate the <xref:System.ComponentModel.Design.CollectionEditor> with a property.
59+
6060
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/EditorAttributesExample/CPP/class1.cpp" id="Snippet1":::
6161
:::code language="csharp" source="~/snippets/csharp/System.ComponentModel.Design/CollectionEditor/Overview/class1.cs" id="Snippet1":::
62-
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Winforms/EditorAttributesExample/VB/class1.vb" id="Snippet1":::
63-
62+
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Winforms/EditorAttributesExample/VB/class1.vb" id="Snippet1":::
63+
6464
]]></format>
6565
</remarks>
6666
<block subset="none" type="overrides">
@@ -188,13 +188,13 @@
188188
<returns>
189189
<see langword="true" /> if it is permissible to remove this value from the collection; otherwise, <see langword="false" />. The default implementation always returns <see langword="true" />.</returns>
190190
<remarks>
191-
<format type="text/markdown"><![CDATA[
192-
193-
## Remarks
194-
When implemented in a derived class, this method indicates whether the specified value can be removed from the collection. By default, this method always returns `true`.
195-
196-
This method is called when the user tries to remove an item that is an original member of the collection. This method is not called when removing items that were added in the current editing session because they are not yet part of the collection.
197-
191+
<format type="text/markdown"><![CDATA[
192+
193+
## Remarks
194+
When implemented in a derived class, this method indicates whether the specified value can be removed from the collection. By default, this method always returns `true`.
195+
196+
This method is called when the user tries to remove an item that is an original member of the collection. This method is not called when removing items that were added in the current editing session because they are not yet part of the collection.
197+
198198
]]></format>
199199
</remarks>
200200
</Docs>
@@ -235,11 +235,11 @@
235235
<returns>
236236
<see langword="true" /> if it multiple collection members can be selected at the same time; otherwise, <see langword="false" />. By default, this returns <see langword="true" />.</returns>
237237
<remarks>
238-
<format type="text/markdown"><![CDATA[
239-
240-
## Remarks
241-
This method indicates whether multiple collection members can be selected within the collection editor dialog box.
242-
238+
<format type="text/markdown"><![CDATA[
239+
240+
## Remarks
241+
This method indicates whether multiple collection members can be selected within the collection editor dialog box.
242+
243243
]]></format>
244244
</remarks>
245245
</Docs>
@@ -278,11 +278,11 @@
278278
<summary>Gets the data type of each item in the collection.</summary>
279279
<value>The data type of the collection items.</value>
280280
<remarks>
281-
<format type="text/markdown"><![CDATA[
282-
283-
## Remarks
284-
This property represents the data type of the items of the collection.
285-
281+
<format type="text/markdown"><![CDATA[
282+
283+
## Remarks
284+
This property represents the data type of the items of the collection.
285+
286286
]]></format>
287287
</remarks>
288288
</Docs>
@@ -327,11 +327,11 @@
327327
<summary>Gets the data type of the collection object.</summary>
328328
<value>The data type of the collection object.</value>
329329
<remarks>
330-
<format type="text/markdown"><![CDATA[
331-
332-
## Remarks
333-
This property represents the data type of the collection object.
334-
330+
<format type="text/markdown"><![CDATA[
331+
332+
## Remarks
333+
This property represents the data type of the collection object.
334+
335335
]]></format>
336336
</remarks>
337337
</Docs>
@@ -458,15 +458,15 @@
458458
<summary>Gets the data type that this collection contains.</summary>
459459
<returns>The data type of the items in the collection, or an <see cref="T:System.Object" /> if no <see langword="Item" /> property can be located on the collection.</returns>
460460
<remarks>
461-
<format type="text/markdown"><![CDATA[
462-
463-
## Remarks
464-
You can retrieve the data type of the items of the collection from the <xref:System.ComponentModel.Design.CollectionEditor.CollectionItemType%2A> property, which is faster than this method.
465-
466-
This method does not need to be called by users, except in derived classes where this method has been overridden and implemented.
467-
468-
The default implementation of this method returns the data type of the `Item` property of the collection, if it exists.
469-
461+
<format type="text/markdown"><![CDATA[
462+
463+
## Remarks
464+
You can retrieve the data type of the items of the collection from the <xref:System.ComponentModel.Design.CollectionEditor.CollectionItemType%2A> property, which is faster than this method.
465+
466+
This method does not need to be called by users, except in derived classes where this method has been overridden and implemented.
467+
468+
The default implementation of this method returns the data type of the `Item` property of the collection, if it exists.
469+
470470
]]></format>
471471
</remarks>
472472
<block subset="none" type="overrides">
@@ -552,15 +552,15 @@
552552
<summary>Gets the data types that this collection editor can contain.</summary>
553553
<returns>An array of data types that this collection can contain.</returns>
554554
<remarks>
555-
<format type="text/markdown"><![CDATA[
556-
557-
## Remarks
558-
You can retrieve the data type of the items of the collection from the <xref:System.ComponentModel.Design.CollectionEditor.NewItemTypes%2A> property, which is faster than this method.
559-
560-
This method does not need to be called by users, except in derived classes where this method has been overridden and implemented.
561-
562-
The default implementation of this method returns the type of all the collection items in a Type array.
563-
555+
<format type="text/markdown"><![CDATA[
556+
557+
## Remarks
558+
You can retrieve the data type of the items of the collection from the <xref:System.ComponentModel.Design.CollectionEditor.NewItemTypes%2A> property, which is faster than this method.
559+
560+
This method does not need to be called by users, except in derived classes where this method has been overridden and implemented.
561+
562+
The default implementation of this method returns the type of all the collection items in a Type array.
563+
564564
]]></format>
565565
</remarks>
566566
<block subset="none" type="overrides">
@@ -840,7 +840,7 @@
840840
<Docs>
841841
<param name="instance">An <see cref="T:System.Collections.ArrayList" /> returned as an object.</param>
842842
<summary>Returns a list containing the given object.</summary>
843-
<returns>An <see cref="T:System.Collections.ArrayList" /> which contains the individual objects to be created.</returns>
843+
<returns>An <see cref="T:System.Collections.ArrayList" /> that contains the individual objects to be created.</returns>
844844
<remarks>To be added.</remarks>
845845
</Docs>
846846
</Member>
@@ -919,11 +919,11 @@
919919
<summary>Gets the Help keyword to display the Help topic or topic list for when the editor's dialog box Help button or the F1 key is pressed.</summary>
920920
<value>The Help keyword to display the Help topic or topic list for when Help is requested from the editor.</value>
921921
<remarks>
922-
<format type="text/markdown"><![CDATA[
923-
924-
## Remarks
925-
Override this property to display a different Help topic.
926-
922+
<format type="text/markdown"><![CDATA[
923+
924+
## Remarks
925+
Override this property to display a different Help topic.
926+
927927
]]></format>
928928
</remarks>
929929
</Docs>
@@ -962,11 +962,11 @@
962962
<summary>Gets the available types of items that can be created for this collection.</summary>
963963
<value>The types of items that can be created.</value>
964964
<remarks>
965-
<format type="text/markdown"><![CDATA[
966-
967-
## Remarks
968-
This property indicates the data types that can be added to the collection. By default, this returns a single type of <xref:System.ComponentModel.Design.CollectionEditor.CollectionItemType%2A>. If more than one type is returned, the collection editor UI provides a way to choose which item type to create.
969-
965+
<format type="text/markdown"><![CDATA[
966+
967+
## Remarks
968+
This property indicates the data types that can be added to the collection. By default, this returns a single type of <xref:System.ComponentModel.Design.CollectionEditor.CollectionItemType%2A>. If more than one type is returned, the collection editor UI provides a way to choose which item type to create.
969+
970970
]]></format>
971971
</remarks>
972972
</Docs>
@@ -1019,11 +1019,11 @@
10191019
<summary>Sets the specified array as the items of the collection.</summary>
10201020
<returns>The newly created collection object or, otherwise, the collection indicated by the <paramref name="editValue" /> parameter.</returns>
10211021
<remarks>
1022-
<format type="text/markdown"><![CDATA[
1023-
1024-
## Remarks
1025-
If setting requires that a new object be created, the new object is returned. Otherwise, the `editValue` parameter is returned.
1026-
1022+
<format type="text/markdown"><![CDATA[
1023+
1024+
## Remarks
1025+
If setting requires that a new object be created, the new object is returned. Otherwise, the `editValue` parameter is returned.
1026+
10271027
]]></format>
10281028
</remarks>
10291029
</Docs>

0 commit comments

Comments
 (0)