Skip to content

Commit ecbcfd4

Browse files
authored
Standardize .NET 5 terminology (dotnet#7418)
1 parent 8ccdcc7 commit ecbcfd4

32 files changed

+185
-184
lines changed

xml/System.Diagnostics/Activity.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -381,7 +381,7 @@ This key/value pair is included in the collection returned by the <xref:System.D
381381
382382
The `Activity` instance tries to use the same format for IDs as its parent. If the activity has no parent, this property determines the default format to use.
383383
384-
In .NET 5.0 and later, the default format is <xref:System.Diagnostics.ActivityIdFormat.W3C?displayProperty=nameWithType>. In previous versions, the default format is <xref:System.Diagnostics.ActivityIdFormat.Hierarchical?displayProperty=nameWithType>.
384+
In .NET 5 and later versions, the default format is <xref:System.Diagnostics.ActivityIdFormat.W3C?displayProperty=nameWithType>. In previous versions, the default format is <xref:System.Diagnostics.ActivityIdFormat.Hierarchical?displayProperty=nameWithType>.
385385
386386
]]></format>
387387
</remarks>
@@ -1532,7 +1532,7 @@ Call <xref:System.Diagnostics.DiagnosticSource.StopActivity%2A?displayProperty=n
15321532
<Docs>
15331533
<summary>Gets a collection of key/value pairs that represent information that will be logged along with the <see cref="T:System.Diagnostics.Activity" /> to the logging system.</summary>
15341534
<value>Information that will be logged along with the <see cref="T:System.Diagnostics.Activity" /> to the logging system.</value>
1535-
<remarks>In .NET 5.0 and later versions, the order of the tags in the list matches the order in which they're added to the list. In previous versions, the order is reversed, that is, the first item added is last in the list.</remarks>
1535+
<remarks>In .NET 5 and later versions, the order of the tags in the list matches the order in which they're added to the list. In previous versions, the order is reversed, that is, the first item added is last in the list.</remarks>
15361536
</Docs>
15371537
</Member>
15381538
<Member MemberName="TraceId">

xml/System.Net.Http/HttpClient.xml

Lines changed: 73 additions & 73 deletions
Large diffs are not rendered by default.

xml/System.Net.Http/HttpRequestException.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -203,7 +203,7 @@
203203
<Docs>
204204
<summary>Gets the HTTP status code to be returned with the exception.</summary>
205205
<value>An HTTP status code if the exception represents a non-successful result, otherwise <c>null</c>.</value>
206-
<remarks>This property was introduced in .NET 5.0.</remarks>
206+
<remarks>This property was introduced in .NET 5.</remarks>
207207
</Docs>
208208
</Member>
209209
</Members>

xml/System.Net.Http/WinHttpHandler.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@
3939
4040
This class is also available for use in Desktop apps by installing it as a NuGet package. For more information, see [System.Net.Http.WinHttpHandler NuGet package](https://www.nuget.org/packages/System.Net.Http.WinHttpHandler/).
4141
42-
Starting in .NET 5.0, <xref:System.Net.Http.WinHttpHandler> is no longer included in the *System.Net.Http.dll* assembly as part of the .NET runtime. For more information, see [WinHttpHandler removed from .NET runtime](/dotnet/core/compatibility/3.1-5.0#winhttphandler-removed-from-net-runtime).
42+
Starting in .NET 5, <xref:System.Net.Http.WinHttpHandler> is no longer included in the *System.Net.Http.dll* assembly as part of the .NET runtime. For more information, see [WinHttpHandler removed from .NET runtime](/dotnet/core/compatibility/3.1-5.0#winhttphandler-removed-from-net-runtime).
4343
4444
]]></format>
4545
</remarks>

xml/System.Net.Security/SslClientAuthenticationOptions.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@
3030
<format type="text/markdown"><![CDATA[
3131
3232
## Remarks
33-
This property bag is used as argument for <xref:System.Net.Security.SslStream.AuthenticateAsClientAsync%2A> and, in .NET 5.0 and later versions, for <xref:System.Net.Security.SslStream.AuthenticateAsClient%2A>.
33+
This property bag is used as argument for <xref:System.Net.Security.SslStream.AuthenticateAsClientAsync%2A> and, in .NET 5 and later versions, for <xref:System.Net.Security.SslStream.AuthenticateAsClient%2A>.
3434
3535
The <xref:System.Net.Http.SocketsHttpHandler> uses this property bag in the <xref: System.Net.Http.SocketsHttpHandler.SslOptions%2A> property.
3636

xml/System.Net.Sockets/MulticastOption.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -282,7 +282,7 @@
282282
]]></format>
283283
</remarks>
284284
<exception cref="T:System.ArgumentNullException">
285-
.NET 5.0 and later versions: <paramref name="group" /> is <see langword="null" />.</exception>
285+
.NET 5 and later versions: <paramref name="group" /> is <see langword="null" />.</exception>
286286
</Docs>
287287
</Member>
288288
<Member MemberName="InterfaceIndex">

xml/System.Net.Sockets/Socket.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9919,7 +9919,7 @@ You must call the Bind method before performing this operation.</exception>
99199919

99209920
The <paramref name="checkError" /> parameter is <see langword="null" /> or empty.</exception>
99219921
<exception cref="T:System.Net.Sockets.SocketException">An error occurred when attempting to access the socket.</exception>
9922-
<exception cref="T:System.ObjectDisposedException">.NET 5.0 and later: One or more sockets are disposed.</exception>
9922+
<exception cref="T:System.ObjectDisposedException">.NET 5 and later: One or more sockets are disposed.</exception>
99239923
<altmember cref="T:System.Collections.IList" />
99249924
<altmember cref="M:System.Net.Sockets.Socket.Accept" />
99259925
<altmember cref="M:System.Net.Sockets.Socket.Connect(System.Net.EndPoint)" />

xml/System.Net/ServicePoint.xml

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -207,13 +207,13 @@
207207
<remarks>
208208
<format type="text/markdown"><![CDATA[
209209
210-
## Remarks
211-
Although a <xref:System.Net.ServicePoint> object can make multiple connections to an Internet resource, it can maintain only one certificate.
212-
210+
## Remarks
211+
212+
Although a <xref:System.Net.ServicePoint> object can make multiple connections to an Internet resource, it can maintain only one certificate.
213+
213214
> [!NOTE]
214-
> Starting in .NET Core 1.0 and later including .NET 5.0 and later, the <xref:System.Net.ServicePoint.Certificate%2A> property always returns null. The <xref:System.Net.Http.HttpClientHandler.ServerCertificateCustomValidationCallback%2A> is the recomendded way to access the server certificate.
215+
> In .NET Core and .NET 5+, the <xref:System.Net.ServicePoint.Certificate> property always returns null. To access the server certificate, use <xref:System.Net.Http.HttpClientHandler.ServerCertificateCustomValidationCallback%2A>.
215216
216-
217217
## Examples
218218
The following code example displays the value of this property.
219219

xml/System.Net/WebHeaderCollection.xml

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -87,7 +87,7 @@
8787
## Remarks
8888
The <xref:System.Net.WebHeaderCollection> class is generally accessed through <xref:System.Net.WebRequest.Headers%2A?displayProperty=nameWithType> or <xref:System.Net.WebResponse.Headers%2A?displayProperty=nameWithType>.
8989
90-
On .NET Framework, some common headers are considered restricted and are either exposed directly by the API (such as `Content-Type`) or protected by the system and cannot be changed. This does *not* apply to .NET Core and .NET 5+ - none of the headers are restricted there.
90+
On .NET Framework, some common headers are considered restricted and are either exposed directly by the API (such as `Content-Type`) or protected by the system and cannot be changed. This does *not* apply to .NET Core and .NET 5+, where none of the headers are restricted.
9191
9292
The restricted headers are:
9393
@@ -302,7 +302,7 @@
302302
> The length of the *value* portion of `header`, that is, the string after the colon (:), is validated only in .NET Framework and .NET Core versions 2.0 - 3.1.
303303
> - On all applicable .NET Framework versions: A <xref:System.Net.WebHeaderCollection> instance that's returned by the <xref:System.Net.HttpListenerResponse.Headers%2A> property will throw an <xref:System.ArgumentOutOfRangeException> if the length of the *value* portion of `header` is greater than 65535. All other <xref:System.Net.WebHeaderCollection> instances accept a *value* of any length.
304304
> - On .NET Core versions through version 3.1: A <xref:System.Net.WebHeaderCollection> instance used with any header of type <xref:System.Net.HttpResponseHeader> will throw an <xref:System.ArgumentOutOfRangeException> if the length of the *value* portion of `header` is greater than 65535. All other <xref:System.Net.WebHeaderCollection> instances accept a *value* of any length.
305-
> - On .NET 5.0 and later versions: <xref:System.Net.WebHeaderCollection> accepts a *value* of any length.
305+
> - On .NET 5 and later versions: <xref:System.Net.WebHeaderCollection> accepts a *value* of any length.
306306
]]></format>
307307
</remarks>
308308
<exception cref="T:System.ArgumentNullException">
@@ -383,7 +383,7 @@
383383
> The length of `value` is validated only in .NET Framework and .NET Core versions 2.0 - 3.1.
384384
> - On all applicable .NET Framework versions: A <xref:System.Net.WebHeaderCollection> instance that's returned by the <xref:System.Net.HttpListenerResponse.Headers%2A> property will throw an <xref:System.ArgumentOutOfRangeException> if the length of `value` is greater than 65535. All other <xref:System.Net.WebHeaderCollection> instances accept a `value` of any length.
385385
> - On .NET Core versions through version 3.1: A <xref:System.Net.WebHeaderCollection> instance used with any header of type <xref:System.Net.HttpResponseHeader> will throw an <xref:System.ArgumentOutOfRangeException> if the length of `value` is greater than 65535. All other <xref:System.Net.WebHeaderCollection> instances accept a `value` of any length.
386-
> - On .NET 5.0 and later versions: <xref:System.Net.WebHeaderCollection> accepts a `value` of any length.
386+
> - On .NET 5 and later versions: <xref:System.Net.WebHeaderCollection> accepts a `value` of any length.
387387
]]></format>
388388
</remarks>
389389
<exception cref="T:System.ArgumentOutOfRangeException">.NET Framework and .NET Core versions 2.0 - 3.1 only: The length of <paramref name="value" /> is greater than 65535.</exception>
@@ -447,7 +447,7 @@
447447
> The length of `value` is validated only in .NET Framework and .NET Core versions 2.0 - 3.1.
448448
> - On all applicable .NET Framework versions: A <xref:System.Net.WebHeaderCollection> instance that's returned by the <xref:System.Net.HttpListenerResponse.Headers%2A> property will throw an <xref:System.ArgumentOutOfRangeException> if the length of `value` is greater than 65535. All other <xref:System.Net.WebHeaderCollection> instances accept a `value` of any length.
449449
> - On .NET Core versions through version 3.1: A <xref:System.Net.WebHeaderCollection> instance used with any header of type <xref:System.Net.HttpResponseHeader> will throw an <xref:System.ArgumentOutOfRangeException> if the length of `value` is greater than 65535. All other <xref:System.Net.WebHeaderCollection> instances accept a `value` of any length.
450-
> - On .NET 5.0 and later versions: <xref:System.Net.WebHeaderCollection> accepts a `value` of any length.
450+
> - On .NET 5 and later versions: <xref:System.Net.WebHeaderCollection> accepts a `value` of any length.
451451
]]></format>
452452
</remarks>
453453
<exception cref="T:System.ArgumentOutOfRangeException">.NET Framework and .NET Core versions 2.0 - 3.1 only: The length of <paramref name="value" /> is greater than 65535.</exception>
@@ -521,7 +521,7 @@
521521
> The length of `value` is validated only in .NET Framework and .NET Core versions 2.0 - 3.1.
522522
> - On all applicable .NET Framework versions: A <xref:System.Net.WebHeaderCollection> instance that's returned by the <xref:System.Net.HttpListenerResponse.Headers%2A> property will throw an <xref:System.ArgumentOutOfRangeException> if the length of `value` is greater than 65535. All other <xref:System.Net.WebHeaderCollection> instances accept a `value` of any length.
523523
> - On .NET Core versions through version 3.1: A <xref:System.Net.WebHeaderCollection> instance used with any header of type <xref:System.Net.HttpResponseHeader> will throw an <xref:System.ArgumentOutOfRangeException> if the length of `value` is greater than 65535. All other <xref:System.Net.WebHeaderCollection> instances accept a `value` of any length.
524-
> - On .NET 5.0 and later versions: <xref:System.Net.WebHeaderCollection> accepts a `value` of any length.
524+
> - On .NET 5 and later versions: <xref:System.Net.WebHeaderCollection> accepts a `value` of any length.
525525
]]></format>
526526
</remarks>
527527
<exception cref="T:System.ArgumentException">
@@ -593,7 +593,7 @@
593593
> The length of `headerValue` is validated only in .NET Framework and .NET Core versions 2.0 - 3.1.
594594
> - On all applicable .NET Framework versions: A <xref:System.Net.WebHeaderCollection> instance that's returned by the <xref:System.Net.HttpListenerResponse.Headers%2A> property will throw an <xref:System.ArgumentOutOfRangeException> if the length of `headerValue` is greater than 65535. All other <xref:System.Net.WebHeaderCollection> instances accept a `headerValue` of any length.
595595
> - On .NET Core versions through version 3.1: A <xref:System.Net.WebHeaderCollection> instance used with any header of type <xref:System.Net.HttpResponseHeader> will throw an <xref:System.ArgumentOutOfRangeException> if the length of `headerValue` is greater than 65535. All other <xref:System.Net.WebHeaderCollection> instances accept a `headerValue` of any length.
596-
> - On .NET 5.0 and later versions: <xref:System.Net.WebHeaderCollection> accepts a `headerValue` of any length.
596+
> - On .NET 5 and later versions: <xref:System.Net.WebHeaderCollection> accepts a `headerValue` of any length.
597597
]]></format>
598598
</remarks>
599599
<exception cref="T:System.ArgumentException">
@@ -1516,7 +1516,7 @@
15161516
> The length of `value` is validated only in .NET Framework and .NET Core versions 2.0 - 3.1.
15171517
> - On all applicable .NET Framework versions: A <xref:System.Net.WebHeaderCollection> instance that's returned by the <xref:System.Net.HttpListenerResponse.Headers%2A> property will throw an <xref:System.ArgumentOutOfRangeException> if the length of `value` is greater than 65535. All other <xref:System.Net.WebHeaderCollection> instances accept a `value` of any length.
15181518
> - On .NET Core versions through version 3.1: A <xref:System.Net.WebHeaderCollection> instance used with any header of type <xref:System.Net.HttpResponseHeader> will throw an <xref:System.ArgumentOutOfRangeException> if the length of `value` is greater than 65535. All other <xref:System.Net.WebHeaderCollection> instances accept a `value` of any length.
1519-
> - On .NET 5.0 and later versions: <xref:System.Net.WebHeaderCollection> accepts a `value` of any length.
1519+
> - On .NET 5 and later versions: <xref:System.Net.WebHeaderCollection> accepts a `value` of any length.
15201520
]]></format>
15211521
</remarks>
15221522
<exception cref="T:System.ArgumentOutOfRangeException">.NET Framework and .NET Core versions 2.0 - 3.1 only: The length of <paramref name="value" /> is greater than 65535.</exception>
@@ -1914,7 +1914,7 @@
19141914
> The length of `value` is validated only in .NET Framework and .NET Core versions 2.0 - 3.1.
19151915
> - On all applicable .NET Framework versions: A <xref:System.Net.WebHeaderCollection> instance that's returned by the <xref:System.Net.HttpListenerResponse.Headers%2A> property will throw an <xref:System.ArgumentOutOfRangeException> if the length of `value` is greater than 65535. All other <xref:System.Net.WebHeaderCollection> instances accept a `value` of any length.
19161916
> - On .NET Core versions through version 3.1: A <xref:System.Net.WebHeaderCollection> instance used with any header of type <xref:System.Net.HttpResponseHeader> will throw an <xref:System.ArgumentOutOfRangeException> if the length of `value` is greater than 65535. All other <xref:System.Net.WebHeaderCollection> instances accept a `value` of any length.
1917-
> - On .NET 5.0 and later versions: <xref:System.Net.WebHeaderCollection> accepts a `value` of any length.
1917+
> - On .NET 5 and later versions: <xref:System.Net.WebHeaderCollection> accepts a `value` of any length.
19181918
]]></format>
19191919
</remarks>
19201920
<exception cref="T:System.ArgumentOutOfRangeException">.NET Framework and .NET Core versions 2.0 - 3.1 only: The length of <paramref name="value" /> is greater than 65535.</exception>
@@ -1978,7 +1978,7 @@
19781978
> The length of `value` is validated only in .NET Framework and .NET Core versions 2.0 - 3.1.
19791979
> - On all applicable .NET Framework versions: A <xref:System.Net.WebHeaderCollection> instance that's returned by the <xref:System.Net.HttpListenerResponse.Headers%2A> property will throw an <xref:System.ArgumentOutOfRangeException> if the length of `value` is greater than 65535. All other <xref:System.Net.WebHeaderCollection> instances accept a `value` of any length.
19801980
> - On .NET Core versions through version 3.1: A <xref:System.Net.WebHeaderCollection> instance used with any header of type <xref:System.Net.HttpResponseHeader> will throw an <xref:System.ArgumentOutOfRangeException> if the length of `value` is greater than 65535. All other <xref:System.Net.WebHeaderCollection> instances accept a `value` of any length.
1981-
> - On .NET 5.0 and later versions: <xref:System.Net.WebHeaderCollection> accepts a `value` of any length.
1981+
> - On .NET 5 and later versions: <xref:System.Net.WebHeaderCollection> accepts a `value` of any length.
19821982
]]></format>
19831983
</remarks>
19841984
<exception cref="T:System.ArgumentOutOfRangeException">.NET Framework and .NET Core versions 2.0 - 3.1 only: The length of <paramref name="value" /> is greater than 65535.</exception>
@@ -2052,7 +2052,7 @@
20522052
> The length of `value` is validated only in .NET Framework and .NET Core versions 2.0 - 3.1.
20532053
> - On all applicable .NET Framework versions: A <xref:System.Net.WebHeaderCollection> instance that's returned by the <xref:System.Net.HttpListenerResponse.Headers%2A> property will throw an <xref:System.ArgumentOutOfRangeException> if the length of `value` is greater than 65535. All other <xref:System.Net.WebHeaderCollection> instances accept a `value` of any length.
20542054
> - On .NET Core versions through version 3.1: A <xref:System.Net.WebHeaderCollection> instance used with any header of type <xref:System.Net.HttpResponseHeader> will throw an <xref:System.ArgumentOutOfRangeException> if the length of `value` is greater than 65535. All other <xref:System.Net.WebHeaderCollection> instances accept a `value` of any length.
2055-
> - On .NET 5.0 and later versions: <xref:System.Net.WebHeaderCollection> accepts a `value` of any length.
2055+
> - On .NET 5 and later versions: <xref:System.Net.WebHeaderCollection> accepts a `value` of any length.
20562056
]]></format>
20572057
</remarks>
20582058
<exception cref="T:System.ArgumentNullException">

xml/System.Numerics/Vector2.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1028,7 +1028,7 @@
10281028
10291029
## Remarks
10301030
1031-
The behavior of this method changed in .NET 5.0. For more information, see [Behavior change for Vector2.Lerp and Vector4.Lerp](/dotnet/core/compatibility/3.1-5.0#behavior-change-for-vector2lerp-and-vector4lerp).
1031+
The behavior of this method changed in .NET 5. For more information, see [Behavior change for Vector2.Lerp and Vector4.Lerp](/dotnet/core/compatibility/3.1-5.0#behavior-change-for-vector2lerp-and-vector4lerp).
10321032
10331033
]]></format>
10341034
</remarks>

0 commit comments

Comments
 (0)