Skip to content

Commit 13ca20e

Browse files
gewarrengewarren
committed
human edits
1 parent 3e59cf9 commit 13ca20e

File tree

4 files changed

+20
-24
lines changed

4 files changed

+20
-24
lines changed

‎docs/core/compatibility/10.0.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,7 @@ If you're migrating an app to .NET 10, the breaking changes listed here might af
6868

6969
| Title | Type of change | Introduced version |
7070
|-------|-------------------|--------------------|
71-
| [HTTP3 support in System.Net.Http disabled by default with PublishTrimmed](networking/10.0/http3-disabled-with-publishtrimmed.md) | Source incompatible | Preview 6 |
71+
| [HTTP/3 support disabled by default with PublishTrimmed](networking/10.0/http3-disabled-with-publishtrimmed.md) | Source incompatible | Preview 6 |
7272
| [HttpClient/SslStream default certificate revocation check mode changed to Online](networking/10.0/ssl-certificate-revocation-check-default.md) | Behavioral change | Preview 6 |
7373
| [Streaming HTTP responses enabled by default in browser HTTP clients](networking/10.0/default-http-streaming.md) | Behavioral change | Preview 3 |
7474

‎docs/core/compatibility/networking/10.0/http3-disabled-with-publishtrimmed.md‎

Lines changed: 15 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,55 +1,51 @@
11
---
2-
title: "Breaking change - HTTP3 support in System.Net.Http disabled by default with PublishTrimmed"
3-
description: "Learn about the breaking change in .NET 10 where HTTP3 support is disabled by default when PublishTrimmed or PublishAot is set to true."
4-
ms.date: 1/20/2025
2+
title: "Breaking change - HTTP/3 support in System.Net.Http disabled by default with PublishTrimmed"
3+
description: "Learn about the breaking change in .NET 10 where HTTP/3 support is disabled by default when PublishTrimmed or PublishAot is set to true."
4+
ms.date: 07/22/2025
55
ai-usage: ai-assisted
66
ms.custom: https://github.com/dotnet/docs/issues/47443
77
---
88

9-
# HTTP3 support in System.Net.Http disabled by default with PublishTrimmed
9+
# HTTP/3 support in System.Net.Http disabled by default with PublishTrimmed
1010

11-
Setting `PublishTrimmed` or `PublishAot` to `true` in the project disables HTTP3 support in System.Net.Http by default.
11+
Setting `PublishTrimmed` or `PublishAot` to `true` in the project disables HTTP/3 support in <xref:System.Net.Http> by default.
1212

1313
## Version introduced
1414

1515
.NET 10 Preview 6
1616

1717
## Previous behavior
1818

19-
Previously, HTTP3 support was allowed, but might not have actually worked by default in environments where the msquic native library is not available. This resulted in HTTP3 not actually working while the app carried all the code related to it.
19+
Previously, HTTP/3 support was allowed, but might not have actually worked by default in environments where the msquic native library wasn't available. This resulted in HTTP/3 not actually working while the app carried all the code related to it.
2020

2121
## New behavior
2222

23-
Starting in .NET 10, HTTP3 is disabled and the code for it is not included when `PublishTrimmed` or `PublishAot` is set to `true`.
23+
Starting in .NET 10, HTTP/3 is disabled and the code for it isn't included when `PublishTrimmed` or `PublishAot` is set to `true`.
2424

2525
## Type of breaking change
2626

2727
This change can affect [source compatibility](../../categories.md#source-compatibility).
2828

2929
## Reason for change
3030

31-
Since making HTTP3 work requires extra gestures and often doesn't work by default, the runtime no longer carries the code for it in trimmed or AOT-compiled applications to reduce application size and complexity.
31+
Since making HTTP/3 work requires extra gestures and often doesn't work by default, the runtime no longer carries the code for it in trimmed or AOT-compiled applications.
3232

3333
## Recommended action
3434

35-
To enable HTTP3 support in applications that use `PublishTrimmed` or `PublishAot`, set the `<Http3Support>` property to `true` in your project file:
35+
To enable HTTP/3 support in applications that use `PublishTrimmed` or `PublishAot`, set the `<HTTP/3Support>` property to `true` in your project file:
3636

3737
```xml
3838
<PropertyGroup>
39+
...
3940
<PublishTrimmed>true</PublishTrimmed>
40-
<Http3Support>true</Http3Support>
41+
<HTTP/3Support>true</HTTP/3Support>
4142
</PropertyGroup>
4243
```
4344

44-
Or for AOT scenarios:
45+
## Affected APIs
4546

46-
```xml
47-
<PropertyGroup>
48-
<PublishAot>true</PublishAot>
49-
<Http3Support>true</Http3Support>
50-
</PropertyGroup>
51-
```
47+
None.
5248

53-
## Affected APIs
49+
## See also
5450

55-
None.
51+
- [Trimming options](../../../deploying/trimming/trimming-options.md)

‎docs/core/compatibility/toc.yml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ items:
6262
href: interop/10.0/search-assembly-directory.md
6363
- name: Networking
6464
items:
65-
- name: HTTP3 support in System.Net.Http disabled by default with PublishTrimmed
65+
- name: HTTP/3 support disabled by default with PublishTrimmed
6666
href: networking/10.0/http3-disabled-with-publishtrimmed.md
6767
- name: HttpClient/SslStream default certificate revocation check mode changed to Online
6868
href: networking/10.0/ssl-certificate-revocation-check-default.md

‎docs/core/deploying/trimming/trimming-options.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -64,10 +64,10 @@ The SDK also makes it possible to disable debugger support using the property `D
6464

6565
Several feature areas of the framework libraries come with trimmer directives that make it possible to remove the code for disabled features.
6666

67-
| MSBuild property | Description |
68-
| - | - |
67+
| MSBuild property | Description |
68+
|--------------------------|-------------|
6969
| `AutoreleasePoolSupport` | When set to `false`, removes code that creates [autorelease pools](../../runtime-config/threading.md#autoreleasepool-for-managed-threads) on supported platforms. `false` is the default for the .NET SDK. |
70-
| `DebuggerSupport` | When set to `false`, removes code that enables better debugging experiences. This setting also [removes symbols](#remove-symbols). |
70+
| `DebuggerSupport` | When set to `false`, removes code that enables better debugging experiences. This setting also [removes symbols](#remove-symbols). |
7171
| `EnableUnsafeBinaryFormatterSerialization` | When set to `false`, removes BinaryFormatter serialization support. For more information, see [BinaryFormatter serialization methods are obsolete](../../compatibility/serialization/5.0/binaryformatter-serialization-obsolete.md) and [In-box BinaryFormatter implementation removed and always throws](../../compatibility/serialization/9.0/binaryformatter-removal.md). |
7272
| `EnableUnsafeUTF7Encoding` | When set to `false`, removes insecure UTF-7 encoding code. For more information, see [UTF-7 code paths are obsolete](../../compatibility/core-libraries/5.0/utf-7-code-paths-obsolete.md). |
7373
| `EventSourceSupport` | When set to `false`, removes EventSource-related code and logic. |

0 commit comments

Comments
 (0)