Skip to content

Commit 8680e37

Browse files
gewarrengewarren
committed
fix that/which grammar
1 parent 60b48d6 commit 8680e37

File tree

72 files changed

+2214
-2264
lines changed

Some content is hidden

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

72 files changed

+2214
-2264
lines changed

‎xml/System.Linq.Expressions/BinaryExpression.xml

+1-1
Original file line numberDiff line numberDiff line change
@@ -486,7 +486,7 @@
486486
## Remarks
487487
If CanReduce returns true, this should return a valid expression.
488488
489-
This method can return another node which itself must be reduced.
489+
This method can return another node that itself must be reduced.
490490
491491
]]></format>
492492
</remarks>

‎xml/System.Linq.Expressions/Expression.xml

+4-4
Original file line numberDiff line numberDiff line change
@@ -9551,7 +9551,7 @@ As with `Func`, the last argument is the return type. It can be set to `System.V
95519551
<Parameter Name="target" Type="System.Linq.Expressions.LabelTarget" Index="0" FrameworkAlternate="dotnet-uwp-10.0;net-10.0;net-5.0;net-6.0;net-7.0;net-8.0;net-9.0;netcore-1.0;netcore-1.1;netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netcore-3.1;netframework-4.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8;netframework-4.8.1;netstandard-1.0;netstandard-1.1;netstandard-1.2;netstandard-1.3;netstandard-1.4;netstandard-1.6;netstandard-2.0;netstandard-2.1" />
95529552
</Parameters>
95539553
<Docs>
9554-
<param name="target">The <see cref="T:System.Linq.Expressions.LabelTarget" /> which this <see cref="T:System.Linq.Expressions.LabelExpression" /> will be associated with.</param>
9554+
<param name="target">The <see cref="T:System.Linq.Expressions.LabelTarget" /> that this <see cref="T:System.Linq.Expressions.LabelExpression" /> will be associated with.</param>
95559555
<summary>Creates a <see cref="T:System.Linq.Expressions.LabelExpression" /> representing a label without a default value.</summary>
95569556
<returns>A <see cref="T:System.Linq.Expressions.LabelExpression" /> without a default value.</returns>
95579557
<remarks>To be added.</remarks>
@@ -9722,7 +9722,7 @@ As with `Func`, the last argument is the return type. It can be set to `System.V
97229722
</Parameter>
97239723
</Parameters>
97249724
<Docs>
9725-
<param name="target">The <see cref="T:System.Linq.Expressions.LabelTarget" /> which this <see cref="T:System.Linq.Expressions.LabelExpression" /> will be associated with.</param>
9725+
<param name="target">The <see cref="T:System.Linq.Expressions.LabelTarget" /> that this <see cref="T:System.Linq.Expressions.LabelExpression" /> will be associated with.</param>
97269726
<param name="defaultValue">The value of this <see cref="T:System.Linq.Expressions.LabelExpression" /> when the label is reached through regular control flow.</param>
97279727
<summary>Creates a <see cref="T:System.Linq.Expressions.LabelExpression" /> representing a label with the given default value.</summary>
97289728
<returns>A <see cref="T:System.Linq.Expressions.LabelExpression" /> with the given default value.</returns>
@@ -20051,7 +20051,7 @@ As with `Func`, the last argument is the return type. It can be set to `System.V
2005120051
</ReturnValue>
2005220052
<Parameters />
2005320053
<Docs>
20054-
<summary>Reduces this node to a simpler expression. If CanReduce returns true, this should return a valid expression. This method can return another node which itself must be reduced.</summary>
20054+
<summary>Reduces this node to a simpler expression. If CanReduce returns true, this should return a valid expression. This method can return another node that itself must be reduced.</summary>
2005520055
<returns>The reduced expression.</returns>
2005620056
<remarks>To be added.</remarks>
2005720057
</Docs>
@@ -20094,7 +20094,7 @@ As with `Func`, the last argument is the return type. It can be set to `System.V
2009420094
</ReturnValue>
2009520095
<Parameters />
2009620096
<Docs>
20097-
<summary>Reduces this node to a simpler expression. If CanReduce returns true, this should return a valid expression. This method can return another node which itself must be reduced.</summary>
20097+
<summary>Reduces this node to a simpler expression. If CanReduce returns true, this should return a valid expression. This method can return another node that itself must be reduced.</summary>
2009820098
<returns>The reduced expression.</returns>
2009920099
<remarks>
2010020100
<format type="text/markdown"><![CDATA[

‎xml/System.Linq.Expressions/LabelExpression.xml

+2-2
Original file line numberDiff line numberDiff line change
@@ -242,8 +242,8 @@
242242
<ReturnType>System.Linq.Expressions.LabelTarget</ReturnType>
243243
</ReturnValue>
244244
<Docs>
245-
<summary>The <see cref="T:System.Linq.Expressions.LabelTarget" /> which this label is associated with.</summary>
246-
<value>The <see cref="T:System.Linq.Expressions.LabelTarget" /> which this label is associated with.</value>
245+
<summary>The <see cref="T:System.Linq.Expressions.LabelTarget" /> that this label is associated with.</summary>
246+
<value>The <see cref="T:System.Linq.Expressions.LabelTarget" /> that this label is associated with.</value>
247247
<remarks>To be added.</remarks>
248248
</Docs>
249249
</Member>

‎xml/System.Linq.Expressions/LambdaExpression.xml

+2-2
Original file line numberDiff line numberDiff line change
@@ -329,7 +329,7 @@
329329
<Parameter Name="method" Type="System.Reflection.Emit.MethodBuilder" Index="0" FrameworkAlternate="netframework-4.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8;netframework-4.8.1" />
330330
</Parameters>
331331
<Docs>
332-
<param name="method">A <see cref="T:System.Reflection.Emit.MethodBuilder" /> which will be used to hold the lambda's IL.</param>
332+
<param name="method">A <see cref="T:System.Reflection.Emit.MethodBuilder" /> that will be used to hold the lambda's IL.</param>
333333
<summary>Compiles the lambda into a method definition.</summary>
334334
<remarks>To be added.</remarks>
335335
</Docs>
@@ -360,7 +360,7 @@
360360
<Parameter Name="debugInfoGenerator" Type="System.Runtime.CompilerServices.DebugInfoGenerator" Index="1" FrameworkAlternate="netframework-4.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8;netframework-4.8.1" />
361361
</Parameters>
362362
<Docs>
363-
<param name="method">A <see cref="T:System.Reflection.Emit.MethodBuilder" /> which will be used to hold the lambda's IL.</param>
363+
<param name="method">A <see cref="T:System.Reflection.Emit.MethodBuilder" /> that will be used to hold the lambda's IL.</param>
364364
<param name="debugInfoGenerator">Debugging information generator used by the compiler to mark sequence points and annotate local variables.</param>
365365
<summary>Compiles the lambda into a method definition and custom debug information.</summary>
366366
<remarks>To be added.</remarks>

‎xml/System.Linq.Expressions/ListInitExpression.xml

+21-21
Original file line numberDiff line numberDiff line change
@@ -57,21 +57,21 @@
5757
<Docs>
5858
<summary>Represents a constructor call that has a collection initializer.</summary>
5959
<remarks>
60-
<format type="text/markdown"><![CDATA[
61-
62-
## Remarks
63-
Use the <xref:System.Linq.Expressions.Expression.ListInit%2A> factory methods to create a <xref:System.Linq.Expressions.ListInitExpression>.
64-
65-
The value of the <xref:System.Linq.Expressions.Expression.NodeType%2A> property of a <xref:System.Linq.Expressions.ListInitExpression> is <xref:System.Linq.Expressions.ExpressionType.ListInit>.
66-
67-
68-
69-
## Examples
70-
The following example creates a <xref:System.Linq.Expressions.ListInitExpression> that represents the initialization of a new dictionary instance that has two key-value pairs.
71-
60+
<format type="text/markdown"><![CDATA[
61+
62+
## Remarks
63+
Use the <xref:System.Linq.Expressions.Expression.ListInit%2A> factory methods to create a <xref:System.Linq.Expressions.ListInitExpression>.
64+
65+
The value of the <xref:System.Linq.Expressions.Expression.NodeType%2A> property of a <xref:System.Linq.Expressions.ListInitExpression> is <xref:System.Linq.Expressions.ExpressionType.ListInit>.
66+
67+
68+
69+
## Examples
70+
The following example creates a <xref:System.Linq.Expressions.ListInitExpression> that represents the initialization of a new dictionary instance that has two key-value pairs.
71+
7272
:::code language="csharp" source="~/snippets/csharp/System.Linq.Expressions/BinaryExpression/Overview/Expression.cs" id="Snippet7":::
73-
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Linq.Expressions.Expression/VB/Expression.vb" id="Snippet7":::
74-
73+
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Linq.Expressions.Expression/VB/Expression.vb" id="Snippet7":::
74+
7575
]]></format>
7676
</remarks>
7777
</Docs>
@@ -346,13 +346,13 @@
346346
<summary>Reduces the binary expression node to a simpler expression.</summary>
347347
<returns>The reduced expression.</returns>
348348
<remarks>
349-
<format type="text/markdown"><![CDATA[
350-
351-
## Remarks
352-
If the `CanReduce` method returns true, this method should return a valid expression.
353-
354-
This method is allowed to return another node which itself must be reduced.
355-
349+
<format type="text/markdown"><![CDATA[
350+
351+
## Remarks
352+
If the `CanReduce` method returns true, this method should return a valid expression.
353+
354+
This method is allowed to return another node that itself must be reduced.
355+
356356
]]></format>
357357
</remarks>
358358
</Docs>

‎xml/System.Linq.Expressions/MemberInitExpression.xml

+21-21
Original file line numberDiff line numberDiff line change
@@ -57,21 +57,21 @@
5757
<Docs>
5858
<summary>Represents calling a constructor and initializing one or more members of the new object.</summary>
5959
<remarks>
60-
<format type="text/markdown"><![CDATA[
61-
62-
## Remarks
63-
Use the <xref:System.Linq.Expressions.Expression.MemberInit%2A> factory methods to create a <xref:System.Linq.Expressions.MemberInitExpression>.
64-
65-
The value of the <xref:System.Linq.Expressions.Expression.NodeType%2A> property of a <xref:System.Linq.Expressions.MemberInitExpression> is <xref:System.Linq.Expressions.ExpressionType.MemberInit>.
66-
67-
68-
69-
## Examples
70-
The following example creates a <xref:System.Linq.Expressions.MemberInitExpression> that represents the initialization of two members of a new object.
71-
60+
<format type="text/markdown"><![CDATA[
61+
62+
## Remarks
63+
Use the <xref:System.Linq.Expressions.Expression.MemberInit%2A> factory methods to create a <xref:System.Linq.Expressions.MemberInitExpression>.
64+
65+
The value of the <xref:System.Linq.Expressions.Expression.NodeType%2A> property of a <xref:System.Linq.Expressions.MemberInitExpression> is <xref:System.Linq.Expressions.ExpressionType.MemberInit>.
66+
67+
68+
69+
## Examples
70+
The following example creates a <xref:System.Linq.Expressions.MemberInitExpression> that represents the initialization of two members of a new object.
71+
7272
:::code language="csharp" source="~/snippets/csharp/System.Linq.Expressions/BinaryExpression/Overview/Expression.cs" id="Snippet9":::
73-
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Linq.Expressions.Expression/VB/Expression.vb" id="Snippet9":::
74-
73+
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Linq.Expressions.Expression/VB/Expression.vb" id="Snippet9":::
74+
7575
]]></format>
7676
</remarks>
7777
</Docs>
@@ -346,13 +346,13 @@
346346
<summary>Reduces the <see cref="T:System.Linq.Expressions.MemberInitExpression" /> to a simpler expression.</summary>
347347
<returns>The reduced expression.</returns>
348348
<remarks>
349-
<format type="text/markdown"><![CDATA[
350-
351-
## Remarks
352-
If the `CanReduce` method returns true, this method should return a valid expression.
353-
354-
This method is allowed to return another node which itself must be reduced.
355-
349+
<format type="text/markdown"><![CDATA[
350+
351+
## Remarks
352+
If the `CanReduce` method returns true, this method should return a valid expression.
353+
354+
This method is allowed to return another node that itself must be reduced.
355+
356356
]]></format>
357357
</remarks>
358358
</Docs>

‎xml/System.Linq.Expressions/UnaryExpression.xml

+43-43
Original file line numberDiff line numberDiff line change
@@ -57,33 +57,33 @@
5757
<Docs>
5858
<summary>Represents an expression that has a unary operator.</summary>
5959
<remarks>
60-
<format type="text/markdown"><![CDATA[
61-
62-
## Remarks
63-
The following table summarizes the factory methods that can be used to create a <xref:System.Linq.Expressions.UnaryExpression> that has a specific node type.
64-
65-
|<xref:System.Linq.Expressions.Expression.NodeType%2A>|Factory Method|
66-
|----------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|
67-
|<xref:System.Linq.Expressions.ExpressionType.ArrayLength>|<xref:System.Linq.Expressions.Expression.ArrayLength%2A>|
68-
|<xref:System.Linq.Expressions.ExpressionType.Convert>|<xref:System.Linq.Expressions.Expression.Convert%2A>|
69-
|<xref:System.Linq.Expressions.ExpressionType.ConvertChecked>|<xref:System.Linq.Expressions.Expression.ConvertChecked%2A>|
70-
|<xref:System.Linq.Expressions.ExpressionType.Negate>|<xref:System.Linq.Expressions.Expression.Negate%2A>|
71-
|<xref:System.Linq.Expressions.ExpressionType.NegateChecked>|<xref:System.Linq.Expressions.Expression.NegateChecked%2A>|
72-
|<xref:System.Linq.Expressions.ExpressionType.Not>|<xref:System.Linq.Expressions.Expression.Not%2A>|
73-
|<xref:System.Linq.Expressions.ExpressionType.Quote>|<xref:System.Linq.Expressions.Expression.Quote%2A>|
74-
|<xref:System.Linq.Expressions.ExpressionType.TypeAs>|<xref:System.Linq.Expressions.Expression.TypeAs%2A>|
75-
|<xref:System.Linq.Expressions.ExpressionType.UnaryPlus>|<xref:System.Linq.Expressions.Expression.UnaryPlus%2A>|
76-
77-
In addition, the <xref:System.Linq.Expressions.Expression.MakeUnary%2A> methods can also be used to create a <xref:System.Linq.Expressions.UnaryExpression>. These factory methods can be used to create a <xref:System.Linq.Expressions.UnaryExpression> of any node type that represents a unary operation. The parameter of these methods that is of type <xref:System.Linq.Expressions.Expression.NodeType%2A> specifies the desired node type.
78-
79-
80-
81-
## Examples
82-
The following example creates a <xref:System.Linq.Expressions.UnaryExpression> object that represents the reference conversion of a non-nullable integer expression to the nullable integer type.
83-
60+
<format type="text/markdown"><![CDATA[
61+
62+
## Remarks
63+
The following table summarizes the factory methods that can be used to create a <xref:System.Linq.Expressions.UnaryExpression> that has a specific node type.
64+
65+
|<xref:System.Linq.Expressions.Expression.NodeType%2A>|Factory Method|
66+
|----------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|
67+
|<xref:System.Linq.Expressions.ExpressionType.ArrayLength>|<xref:System.Linq.Expressions.Expression.ArrayLength%2A>|
68+
|<xref:System.Linq.Expressions.ExpressionType.Convert>|<xref:System.Linq.Expressions.Expression.Convert%2A>|
69+
|<xref:System.Linq.Expressions.ExpressionType.ConvertChecked>|<xref:System.Linq.Expressions.Expression.ConvertChecked%2A>|
70+
|<xref:System.Linq.Expressions.ExpressionType.Negate>|<xref:System.Linq.Expressions.Expression.Negate%2A>|
71+
|<xref:System.Linq.Expressions.ExpressionType.NegateChecked>|<xref:System.Linq.Expressions.Expression.NegateChecked%2A>|
72+
|<xref:System.Linq.Expressions.ExpressionType.Not>|<xref:System.Linq.Expressions.Expression.Not%2A>|
73+
|<xref:System.Linq.Expressions.ExpressionType.Quote>|<xref:System.Linq.Expressions.Expression.Quote%2A>|
74+
|<xref:System.Linq.Expressions.ExpressionType.TypeAs>|<xref:System.Linq.Expressions.Expression.TypeAs%2A>|
75+
|<xref:System.Linq.Expressions.ExpressionType.UnaryPlus>|<xref:System.Linq.Expressions.Expression.UnaryPlus%2A>|
76+
77+
In addition, the <xref:System.Linq.Expressions.Expression.MakeUnary%2A> methods can also be used to create a <xref:System.Linq.Expressions.UnaryExpression>. These factory methods can be used to create a <xref:System.Linq.Expressions.UnaryExpression> of any node type that represents a unary operation. The parameter of these methods that is of type <xref:System.Linq.Expressions.Expression.NodeType%2A> specifies the desired node type.
78+
79+
80+
81+
## Examples
82+
The following example creates a <xref:System.Linq.Expressions.UnaryExpression> object that represents the reference conversion of a non-nullable integer expression to the nullable integer type.
83+
8484
:::code language="csharp" source="~/snippets/csharp/System.Linq.Expressions/BinaryExpression/Overview/Expression.cs" id="Snippet11":::
85-
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Linq.Expressions.Expression/VB/Expression.vb" id="Snippet11":::
86-
85+
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Linq.Expressions.Expression/VB/Expression.vb" id="Snippet11":::
86+
8787
]]></format>
8888
</remarks>
8989
</Docs>
@@ -219,11 +219,11 @@
219219
<value>
220220
<see langword="true" /> if the node represents a lifted call; otherwise, <see langword="false" />.</value>
221221
<remarks>
222-
<format type="text/markdown"><![CDATA[
223-
224-
## Remarks
225-
An operator call is *lifted* if the operator expects a non-nullable operand but a nullable operand is passed to it.
226-
222+
<format type="text/markdown"><![CDATA[
223+
224+
## Remarks
225+
An operator call is *lifted* if the operator expects a non-nullable operand but a nullable operand is passed to it.
226+
227227
]]></format>
228228
</remarks>
229229
</Docs>
@@ -270,11 +270,11 @@
270270
<value>
271271
<see langword="true" /> if the operator's return type is lifted to a nullable type; otherwise, <see langword="false" />.</value>
272272
<remarks>
273-
<format type="text/markdown"><![CDATA[
274-
275-
## Remarks
276-
An operator call is *lifted* if the operator expects a non-nullable operand but a nullable operand is passed to it. If the value of <xref:System.Linq.Expressions.UnaryExpression.IsLiftedToNull%2A> is `true`, the operator returns a nullable type and if the nullable operand evaluates to `null`, the operator returns `null`.
277-
273+
<format type="text/markdown"><![CDATA[
274+
275+
## Remarks
276+
An operator call is *lifted* if the operator expects a non-nullable operand but a nullable operand is passed to it. If the value of <xref:System.Linq.Expressions.UnaryExpression.IsLiftedToNull%2A> is `true`, the operator returns a nullable type and if the nullable operand evaluates to `null`, the operator returns `null`.
277+
278278
]]></format>
279279
</remarks>
280280
</Docs>
@@ -471,13 +471,13 @@
471471
<summary>Reduces the expression node to a simpler expression.</summary>
472472
<returns>The reduced expression.</returns>
473473
<remarks>
474-
<format type="text/markdown"><![CDATA[
475-
476-
## Remarks
477-
If the `CanReduce` method returns true, this should return a valid expression.
478-
479-
This method can return another node which itself must be reduced.
480-
474+
<format type="text/markdown"><![CDATA[
475+
476+
## Remarks
477+
If the `CanReduce` method returns true, this should return a valid expression.
478+
479+
This method can return another node that itself must be reduced.
480+
481481
]]></format>
482482
</remarks>
483483
</Docs>

‎xml/System.Linq/ParallelEnumerable.xml

+2-2
Original file line numberDiff line numberDiff line change
@@ -787,7 +787,7 @@
787787
<Docs>
788788
<param name="source">The input sequence.</param>
789789
<summary>Enables treatment of a data source as if it were ordered, overriding the default of unordered. AsOrdered may only be invoked on non-generic sequences returned by AsParallel, ParallelEnumerable.Range, and ParallelEnumerable.Repeat.</summary>
790-
<returns>The source sequence which will maintain the original ordering in the subsequent query operators.</returns>
790+
<returns>The source sequence that will maintain the original ordering in the subsequent query operators.</returns>
791791
<remarks>
792792
<format type="text/markdown"><![CDATA[
793793

@@ -860,7 +860,7 @@
860860
<typeparam name="TSource">The type of elements of <paramref name="source" />.</typeparam>
861861
<param name="source">The input sequence.</param>
862862
<summary>Enables treatment of a data source as if it were ordered, overriding the default of unordered. AsOrdered may only be invoked on generic sequences returned by AsParallel, ParallelEnumerable.Range, and ParallelEnumerable.Repeat.</summary>
863-
<returns>The source sequence which will maintain the original ordering in the subsequent query operators.</returns>
863+
<returns>The source sequence that will maintain the original ordering in the subsequent query operators.</returns>
864864
<remarks>
865865
<format type="text/markdown"><![CDATA[
866866

0 commit comments

Comments
 (0)