From 21bbfc8c7dcba8a44d408ef095ead9989007932a Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 15 Sep 2026 22:45:23 +0000 Subject: [PATCH 1/8] Initial plan From d903ee7f6805ab9707d86fe4ffa2d805c11aff07 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 15 Sep 2026 22:47:50 +0000 Subject: [PATCH 2/8] Document .NET 11 CLI options Co-authored-by: meaghanlewis <10103121+meaghanlewis@users.noreply.github.com> --- docs/core/tools/dotnet-format.md | 7 ++++++- docs/core/tools/dotnet-reference-add.md | 7 ++++++- docs/core/tools/dotnet-tool-exec.md | 7 ++++++- docs/core/tools/dotnet.md | 3 +++ 4 files changed, 21 insertions(+), 3 deletions(-) diff --git a/docs/core/tools/dotnet-format.md b/docs/core/tools/dotnet-format.md index 2d504ebb8bbf6..db46278943373 100644 --- a/docs/core/tools/dotnet-format.md +++ b/docs/core/tools/dotnet-format.md @@ -2,6 +2,7 @@ title: dotnet format command description: The dotnet format command formats code to match EditorConfig settings for the current directory. ms.date: 09/29/2025 +ai-usage: ai-generated --- # dotnet format @@ -17,7 +18,7 @@ ms.date: 09/29/2025 dotnet format [] [--binarylog ] [--diagnostics ] [--exclude ] [--exclude-diagnostics ] - [--include ] [--include-generated] + [--framework ] [--include ] [--include-generated] [--no-restore] [--report ] [--severity ] [-v|--verbosity ] [--verify-no-changes] [--version] @@ -57,6 +58,10 @@ None of the options below are required for the `dotnet format` command to succee A space-separated list of diagnostic IDs to exclude when fixing code style or third-party issues. Default value is none. For a list of built-in analyzer rule IDs that you can specify, see the [list of IDs for code-analysis style rules](../../fundamentals/code-analysis/style-rules/index.md). +- **`--framework `** + + Specifies the target framework to format. You can't use this option with `--folder`. + - **`--include `** A space-separated list of relative file or folder paths to include in formatting. The default is all files in the solution or project. diff --git a/docs/core/tools/dotnet-reference-add.md b/docs/core/tools/dotnet-reference-add.md index 298b7c49a9d0f..25dc2391e3e6f 100644 --- a/docs/core/tools/dotnet-reference-add.md +++ b/docs/core/tools/dotnet-reference-add.md @@ -2,6 +2,7 @@ title: dotnet reference add command description: The dotnet reference add command provides a convenient option to add project-to-project references. ms.date: 10/28/2025 +ai-usage: ai-generated --- # dotnet reference add @@ -17,7 +18,7 @@ ms.date: 10/28/2025 ## Synopsis ```dotnetcli -dotnet reference add reference [-f|--framework ] +dotnet reference add reference [--file ] [-f|--framework ] [--interactive] [--project ] dotnet reference add -h|--help @@ -60,6 +61,10 @@ There's no CLI command to add a reference to an assembly that isn't in a project ## Options +- **`--file `** + + Specifies the file-based app to operate on. + - **`-f|--framework `** Adds project references only when targeting a specific [framework](../../standard/frameworks.md) using the TFM format. diff --git a/docs/core/tools/dotnet-tool-exec.md b/docs/core/tools/dotnet-tool-exec.md index 2af3fdfe72552..25850f648443d 100644 --- a/docs/core/tools/dotnet-tool-exec.md +++ b/docs/core/tools/dotnet-tool-exec.md @@ -2,6 +2,7 @@ title: dotnet tool exec command description: The dotnet tool exec command downloads and invokes a .NET tool in one step without permanent installation. ms.date: 09/06/2025 +ai-usage: ai-generated --- # dotnet tool exec @@ -18,7 +19,7 @@ dotnet tool exec [@] [--allow-roll-forward] [-a|--arch ] [--add-source ] [--configfile ] [--disable-parallel] [--framework ] [--ignore-failed-sources] [--interactive] - [--no-http-cache] [--prerelease] [--source ] + [--no-http-cache] [--prerelease] [--source ] [-y|--yes] [-v|--verbosity ] [--] [...] @@ -81,6 +82,10 @@ This command also exists in two other forms for easier use Allows prerelease packages to be selected when resolving the version to install. +- **`-y|--yes`** + + Accepts all confirmation prompts. + - [!INCLUDE [source](includes/cli-tool-source.md)] - [!INCLUDE [verbosity](includes/cli-verbosity-normal.md)] diff --git a/docs/core/tools/dotnet.md b/docs/core/tools/dotnet.md index a29e0ee8c2437..cec81008589ab 100644 --- a/docs/core/tools/dotnet.md +++ b/docs/core/tools/dotnet.md @@ -2,6 +2,7 @@ title: dotnet command description: Learn about the dotnet command (the generic driver for the .NET CLI) and its usage. ms.date: 10/28/2025 +ai-usage: ai-generated --- # dotnet command @@ -106,6 +107,8 @@ The following options are for `dotnet` with a command. For example, `dotnet buil Prints out documentation for a given command. For example, `dotnet build --help` displays help for the `build` command. + Starting with .NET 11, `dotnet nuget --help` displays the help output from the NuGet CLI. + - **`command options`** Each command defines options specific to that command. See specific command page for a list of available options. From 08d70891c09478f869ab8c4d8b907392a79b9b5b Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 15 Sep 2026 22:48:24 +0000 Subject: [PATCH 3/8] Address CLI docs review feedback Co-authored-by: meaghanlewis <10103121+meaghanlewis@users.noreply.github.com> --- docs/core/tools/dotnet-format.md | 4 ++-- docs/core/tools/dotnet-reference-add.md | 4 ++-- docs/core/tools/dotnet-tool-exec.md | 2 +- docs/core/tools/dotnet.md | 2 +- 4 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/core/tools/dotnet-format.md b/docs/core/tools/dotnet-format.md index db46278943373..037b986475850 100644 --- a/docs/core/tools/dotnet-format.md +++ b/docs/core/tools/dotnet-format.md @@ -2,7 +2,7 @@ title: dotnet format command description: The dotnet format command formats code to match EditorConfig settings for the current directory. ms.date: 09/29/2025 -ai-usage: ai-generated +ai-usage: ai-assisted --- # dotnet format @@ -60,7 +60,7 @@ None of the options below are required for the `dotnet format` command to succee - **`--framework `** - Specifies the target framework to format. You can't use this option with `--folder`. + Specifies the target framework to format. - **`--include `** diff --git a/docs/core/tools/dotnet-reference-add.md b/docs/core/tools/dotnet-reference-add.md index 25dc2391e3e6f..6e3c72e324dd3 100644 --- a/docs/core/tools/dotnet-reference-add.md +++ b/docs/core/tools/dotnet-reference-add.md @@ -2,7 +2,7 @@ title: dotnet reference add command description: The dotnet reference add command provides a convenient option to add project-to-project references. ms.date: 10/28/2025 -ai-usage: ai-generated +ai-usage: ai-assisted --- # dotnet reference add @@ -63,7 +63,7 @@ There's no CLI command to add a reference to an assembly that isn't in a project - **`--file `** - Specifies the file-based app to operate on. + Specifies the file-based app to operate on. - **`-f|--framework `** diff --git a/docs/core/tools/dotnet-tool-exec.md b/docs/core/tools/dotnet-tool-exec.md index 25850f648443d..a7dc2d0d44f07 100644 --- a/docs/core/tools/dotnet-tool-exec.md +++ b/docs/core/tools/dotnet-tool-exec.md @@ -2,7 +2,7 @@ title: dotnet tool exec command description: The dotnet tool exec command downloads and invokes a .NET tool in one step without permanent installation. ms.date: 09/06/2025 -ai-usage: ai-generated +ai-usage: ai-assisted --- # dotnet tool exec diff --git a/docs/core/tools/dotnet.md b/docs/core/tools/dotnet.md index cec81008589ab..506c4d337b09d 100644 --- a/docs/core/tools/dotnet.md +++ b/docs/core/tools/dotnet.md @@ -2,7 +2,7 @@ title: dotnet command description: Learn about the dotnet command (the generic driver for the .NET CLI) and its usage. ms.date: 10/28/2025 -ai-usage: ai-generated +ai-usage: ai-assisted --- # dotnet command From 003959e47d4607abbcb229e6b1d0890dbb63427c Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 15 Sep 2026 22:49:13 +0000 Subject: [PATCH 4/8] Clarify new CLI option guidance Co-authored-by: meaghanlewis <10103121+meaghanlewis@users.noreply.github.com> --- docs/core/tools/dotnet-format.md | 2 +- docs/core/tools/dotnet-reference-add.md | 2 +- docs/core/tools/dotnet-tool-exec.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/core/tools/dotnet-format.md b/docs/core/tools/dotnet-format.md index 037b986475850..da2d0a2ed7f4f 100644 --- a/docs/core/tools/dotnet-format.md +++ b/docs/core/tools/dotnet-format.md @@ -60,7 +60,7 @@ None of the options below are required for the `dotnet format` command to succee - **`--framework `** - Specifies the target framework to format. + Specifies the target framework moniker (TFM), such as `net11.0`, to format in a multi-targeted project. If you don't specify this option, `dotnet format` formats all target frameworks. Available starting with .NET 11. - **`--include `** diff --git a/docs/core/tools/dotnet-reference-add.md b/docs/core/tools/dotnet-reference-add.md index 6e3c72e324dd3..224147c48f856 100644 --- a/docs/core/tools/dotnet-reference-add.md +++ b/docs/core/tools/dotnet-reference-add.md @@ -63,7 +63,7 @@ There's no CLI command to add a reference to an assembly that isn't in a project - **`--file `** - Specifies the file-based app to operate on. + Specifies the file-based app to add project references to. For example, specify `app.cs` to add `#:project` directives to a file-based app. Available starting with .NET 11. - **`-f|--framework `** diff --git a/docs/core/tools/dotnet-tool-exec.md b/docs/core/tools/dotnet-tool-exec.md index a7dc2d0d44f07..697d2c68f3674 100644 --- a/docs/core/tools/dotnet-tool-exec.md +++ b/docs/core/tools/dotnet-tool-exec.md @@ -84,7 +84,7 @@ This command also exists in two other forms for easier use - **`-y|--yes`** - Accepts all confirmation prompts. + Accepts all confirmation prompts, including the prompt to download and run the tool package. Use this option only with packages and package sources that you trust. Available starting with .NET 11. - [!INCLUDE [source](includes/cli-tool-source.md)] From 9b203d43f1dfb5f0b1d0e8c9ad871d114ac64039 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 15 Sep 2026 22:49:41 +0000 Subject: [PATCH 5/8] Update CLI docs metadata dates Co-authored-by: meaghanlewis <10103121+meaghanlewis@users.noreply.github.com> --- docs/core/tools/dotnet-format.md | 2 +- docs/core/tools/dotnet-reference-add.md | 2 +- docs/core/tools/dotnet-tool-exec.md | 2 +- docs/core/tools/dotnet.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/core/tools/dotnet-format.md b/docs/core/tools/dotnet-format.md index da2d0a2ed7f4f..18807060783c0 100644 --- a/docs/core/tools/dotnet-format.md +++ b/docs/core/tools/dotnet-format.md @@ -1,7 +1,7 @@ --- title: dotnet format command description: The dotnet format command formats code to match EditorConfig settings for the current directory. -ms.date: 09/29/2025 +ms.date: 09/15/2026 ai-usage: ai-assisted --- # dotnet format diff --git a/docs/core/tools/dotnet-reference-add.md b/docs/core/tools/dotnet-reference-add.md index 224147c48f856..e3af7cb797a69 100644 --- a/docs/core/tools/dotnet-reference-add.md +++ b/docs/core/tools/dotnet-reference-add.md @@ -1,7 +1,7 @@ --- title: dotnet reference add command description: The dotnet reference add command provides a convenient option to add project-to-project references. -ms.date: 10/28/2025 +ms.date: 09/15/2026 ai-usage: ai-assisted --- # dotnet reference add diff --git a/docs/core/tools/dotnet-tool-exec.md b/docs/core/tools/dotnet-tool-exec.md index 697d2c68f3674..f8da5ef79cc97 100644 --- a/docs/core/tools/dotnet-tool-exec.md +++ b/docs/core/tools/dotnet-tool-exec.md @@ -1,7 +1,7 @@ --- title: dotnet tool exec command description: The dotnet tool exec command downloads and invokes a .NET tool in one step without permanent installation. -ms.date: 09/06/2025 +ms.date: 09/15/2026 ai-usage: ai-assisted --- # dotnet tool exec diff --git a/docs/core/tools/dotnet.md b/docs/core/tools/dotnet.md index 506c4d337b09d..9decf64efe9b3 100644 --- a/docs/core/tools/dotnet.md +++ b/docs/core/tools/dotnet.md @@ -1,7 +1,7 @@ --- title: dotnet command description: Learn about the dotnet command (the generic driver for the .NET CLI) and its usage. -ms.date: 10/28/2025 +ms.date: 09/15/2026 ai-usage: ai-assisted --- # dotnet command From 3579d1a9e14e62a2419cc3cc2b490c4af4f5c75b Mon Sep 17 00:00:00 2001 From: Meaghan Osagie Date: Wed, 16 Sep 2026 08:20:24 -0700 Subject: [PATCH 6/8] Update CLI documentation for dotnet new install and dotnet sln commands --- docs/core/tools/dotnet-new-install.md | 10 ++++-- docs/core/tools/dotnet-sln.md | 46 ++++++++++++++++++++------- 2 files changed, 41 insertions(+), 15 deletions(-) diff --git a/docs/core/tools/dotnet-new-install.md b/docs/core/tools/dotnet-new-install.md index ff11d744c9f02..43100f0e02071 100644 --- a/docs/core/tools/dotnet-new-install.md +++ b/docs/core/tools/dotnet-new-install.md @@ -2,7 +2,7 @@ title: dotnet new install ai-usage: ai-assisted description: The dotnet new install command installs a template package. -ms.date: 11/12/2025 +ms.date: 09/15/2026 --- # dotnet new install @@ -15,7 +15,7 @@ ms.date: 11/12/2025 ## Synopsis ```dotnetcli -dotnet new install [--interactive] [--add-source|--nuget-source ] [--force] +dotnet new install [--interactive] [--add-source|--nuget-source ] [--force] [--prerelease] [-d|--diagnostics] [--verbosity ] [-h|--help] ``` @@ -23,7 +23,7 @@ dotnet new install [--interactive] [--add-source|--nuget-source The `dotnet new install` command installs a template package from the `PATH` or `NUGET_ID` provided. If you want to install a specific version or prerelease version of a template package, specify the version in the format `@`. (The colon separator `::` was deprecated in favor of the `@` character in .NET 9.0.200 SDK.) By default, `dotnet new` passes \* for the version, which represents the latest stable package version. For more information, see the [Examples](#examples) section. -If a version of the template package was already installed when you run this command, the template package will be updated to the specified version. If no version is specified, the package is updated to the latest stable version. +If a version of the template package was already installed when you run this command, the template package will be updated to the specified version. If no version is specified, the package is updated to the latest stable version unless you specify the `--prerelease` option. Starting with .NET SDK 6.0.100, if the argument specifies the version, and that version of the NuGet package is already installed, it won't be reinstalled. If the argument is a `PATH` and it's already installed, it won't be reinstalled. @@ -75,6 +75,10 @@ Starting with .NET SDK 6.0.100, installed template packages are available in lat - [!INCLUDE [interactive](includes/cli-interactive.md)] +- **`--prerelease`** + + Selects the latest available version, including prerelease versions, when you don't specify a template package version. If you specify a package version, such as `Contoso.Templates@2.0.0-preview.3`, the command selects that exact version. Available since .NET SDK 11. + - [!INCLUDE [verbosity](includes/cli-verbosity.md)] ## Examples diff --git a/docs/core/tools/dotnet-sln.md b/docs/core/tools/dotnet-sln.md index afdd9b06dbd0c..c97a9080dad27 100644 --- a/docs/core/tools/dotnet-sln.md +++ b/docs/core/tools/dotnet-sln.md @@ -1,7 +1,8 @@ --- title: dotnet sln command -description: The dotnet-sln command provides a convenient option to add, remove, and list projects in a solution file. -ms.date: 10/28/2025 +ai-usage: ai-assisted +description: The dotnet-sln command provides a convenient option to add, remove, and list projects in a solution file or solution filter. +ms.date: 09/16/2026 --- # dotnet sln @@ -9,7 +10,7 @@ ms.date: 10/28/2025 ## Name -`dotnet sln` - Lists or modifies the projects in a .NET solution file, or migrates the file to an *.slnx* file. +`dotnet sln` - Lists or modifies the projects in a .NET solution file or solution filter, or migrates an *.sln* file to an *.slnx* file. ## Synopsis @@ -21,7 +22,7 @@ dotnet sln [command] -h|--help ## Description -The `dotnet sln` command provides a convenient way to list and modify projects in a solution file. +The `dotnet sln` command provides a convenient way to list and modify projects in a solution file or solution filter. ### Create a solution file @@ -48,13 +49,21 @@ dotnet new sln --output MySolution > [!NOTE] > In .NET 9 and earlier versions, `dotnet new sln` creates an *.sln* file instead of an *.slnx* file. +### Create a solution filter + +Starting with .NET 11, you can create a [solution filter](/visualstudio/msbuild/solution-filters) (*.slnf* file) with the `slnf` template: + +```dotnetcli +dotnet new slnf --name MyApp.slnf +``` + ## Arguments - **`SOLUTION_FILE`** - The solution file to use (either an *.sln* or *.slnx* file). + The solution file (*.sln* or *.slnx* file) or solution filter (*.slnf* file) to use. - If unspecified, the command searches the current directory for an *.sln* or *.slnx* file and, if it finds exactly one, uses that file. If multiple solution files are found, the user is prompted to specify a file explicitly. If none are found, the command fails. + If unspecified, the command searches the current directory for an *.sln*, *.slnx*, or *.slnf* file and, if it finds exactly one, uses that file. If multiple solution files or filters are found, the user is prompted to specify a file explicitly. If none are found, the command fails. ## Options @@ -108,13 +117,15 @@ dotnet sln add [-h|--help] - **`SOLUTION_FILE`** - The solution file to use (either an *.sln* or *.slnx* file). + The solution file (*.sln* or *.slnx* file) or solution filter (*.slnf* file) to use. + + If unspecified, the command searches the current directory for an *.sln*, *.slnx*, or *.slnf* file and, if it finds exactly one, uses that file. If multiple solution files or filters are found, the user is prompted to specify a file explicitly. If none are found, the command fails. - If unspecified, the command searches the current directory for an *.sln* or *.slnx* file and, if it finds exactly one, uses that file. If multiple solution files are found, the user is prompted to specify a file explicitly. If none are found, the command fails. + (Support for *.slnf* files was added in .NET 11.) - **`PROJECT_PATH`** - The path to the project or projects to add to the solution. Unix/Linux shell [globbing pattern](https://en.wikipedia.org/wiki/Glob_(programming)) expansions are processed correctly by the `dotnet sln` command. + The path to the project or projects to add to the solution or solution filter. Unix/Linux shell [globbing pattern](https://en.wikipedia.org/wiki/Glob_(programming)) expansions are processed correctly by the `dotnet sln` command. If `PROJECT_PATH` includes folders that contain the project folder, that portion of the path is used to create [solution folders](/visualstudio/ide/solutions-and-projects-in-visual-studio#solution-folder). For example, the following commands create a solution with `myapp` in solution folder `folder1/folder2`: @@ -153,13 +164,15 @@ dotnet sln [] remove [-h|--help] - **`SOLUTION_FILE`** - The solution file to use (either an *.sln* or *.slnx* file). + The solution file (*.sln* or *.slnx* file) or solution filter (*.slnf* file) to use. + + If unspecified, the command searches the current directory for an *.sln*, *.slnx*, or *.slnf* file and, if it finds exactly one, uses that file. If multiple solution files or filters are found, the user is prompted to specify a file explicitly. If none are found, the command fails. - If unspecified, the command searches the current directory for an *.sln* or *.slnx* file and, if it finds exactly one, uses that file. If multiple solution files are found, the user is prompted to specify a file explicitly. If none are found, the command fails. + (Support for *.slnf* files was added in .NET 11.) - **`PROJECT_PATH` or `PROJECT_NAME`** - The path to, or name of, the project or projects to remove from the solution. Unix/Linux shell [globbing pattern](https://en.wikipedia.org/wiki/Glob_(programming)) expansions are processed correctly by the `dotnet sln` command. + The path to, or name of, the project or projects to remove from the solution or solution filter. Unix/Linux shell [globbing pattern](https://en.wikipedia.org/wiki/Glob_(programming)) expansions are processed correctly by the `dotnet sln` command. If a project name is provided instead of a path, the project in the solution that matches the name, regardless of its path, is removed. If more than one matching project is found in the solution, the command errors out. Omit the project file extension in the name. (Support for removing projects by name was added in .NET 10.) @@ -200,6 +213,15 @@ dotnet sln [] migrate [-h|--help] dotnet sln todo.slnx list ``` +- Create a solution filter, add a project, list the projects, and remove the project: + + ```dotnetcli + dotnet new slnf --name MyApp.slnf + dotnet sln MyApp.slnf add src/Lib/Lib.csproj + dotnet sln MyApp.slnf list + dotnet sln MyApp.slnf remove src/Lib/Lib.csproj + ``` + - Add a C# project to a solution: ```dotnetcli From 63832d18c2bc093852a944b25796b2ca6950830a Mon Sep 17 00:00:00 2001 From: "Meaghan Osagie (Lewis)" Date: Wed, 16 Sep 2026 09:38:59 -0700 Subject: [PATCH 7/8] Revert all changes to dotnet.md in this PR (restore to main) --- docs/core/tools/dotnet.md | 15 ++++++--------- 1 file changed, 6 insertions(+), 9 deletions(-) diff --git a/docs/core/tools/dotnet.md b/docs/core/tools/dotnet.md index 9decf64efe9b3..7db740d08fa86 100644 --- a/docs/core/tools/dotnet.md +++ b/docs/core/tools/dotnet.md @@ -1,8 +1,7 @@ --- title: dotnet command description: Learn about the dotnet command (the generic driver for the .NET CLI) and its usage. -ms.date: 09/15/2026 -ai-usage: ai-assisted +ms.date: 10/28/2025 --- # dotnet command @@ -79,13 +78,13 @@ Prints out the version of the .NET SDK used by `dotnet` commands, which may be a Prints out a list of the installed .NET runtimes for the architecture of the invoked `dotnet`. An x86 version of `dotnet` lists only x86 runtimes, and an x64 version of `dotnet` lists only x64 runtimes. - .NET 10 and later versions support the `--arch` argument. If specified and not the same as the `dotnet` architecture, searches for a .NET installation of the specified architecture and prints out any runtimes installed there. Allowed values include arm64, x64, and x86. The dotnet/runtime repo has the full [list of valid architecture values](https://github.com/dotnet/runtime/blob/1713d65316467e3eaf23514b6642eba5869f1b70/src/native/corehost/hostmisc/utils.cpp#L194-L205). + .NET 10 and later versions support the `--arch` argument. If specified and not the same as the `dotnet` architecture, searches for a .NET installation of the specified architecture and prints out its list of installed runtimes. - **`--list-sdks [--arch ]`** Prints out a list of the installed .NET SDKs for the architecture of the invoked `dotnet`. An x86 version of `dotnet` lists only x86 SDKs, and an x64 version of `dotnet` lists only x64 SDKs. - .NET 10 and later versions support the `--arch` argument. If specified and not the same as the `dotnet` architecture, searches for a .NET installation of the specified architecture and prints out any SDKs installed there. Allowed values include arm64, x64, and x86. The dotnet/runtime repo has the full [list of valid architecture values](https://github.com/dotnet/runtime/blob/1713d65316467e3eaf23514b6642eba5869f1b70/src/native/corehost/hostmisc/utils.cpp#L194-L205). + .NET 10 and later versions support the `--arch` argument. If specified and not the same as the `dotnet` architecture, searches for a .NET installation of the specified architecture and prints out its list of installed SDKs. - **`-?|-h|--help`** @@ -107,8 +106,6 @@ The following options are for `dotnet` with a command. For example, `dotnet buil Prints out documentation for a given command. For example, `dotnet build --help` displays help for the `build` command. - Starting with .NET 11, `dotnet nuget --help` displays the help output from the NuGet CLI. - - **`command options`** Each command defines options specific to that command. See specific command page for a list of available options. @@ -125,7 +122,7 @@ The following options are available when `dotnet` runs an application. For examp - **`--additional-deps `** - Path to an additional *.deps.json* file. A *deps.json* file contains a list of dependencies, compilation dependencies, and version information used to address assembly conflicts. For more information, see [Runtime Configuration Files](https://github.com/dotnet/sdk/blob/main/documentation/specs/runtime-configuration-file.md) on GitHub. + Path to an additional *.deps.json* file. A *deps.json* file contains a list of dependencies, compilation dependencies, and version information used to address assembly conflicts. For more information, see [Runtime package store](../deploying/runtime-store.md) on GitHub. @@ -142,7 +139,7 @@ The following options are available when `dotnet` runs an application. For examp With the exception of `Disable`, all settings will use the highest available patch version. - Roll forward behavior can also be configured in a project file property, a runtime configuration file property, and an environment variable. For more information, see [Major-version runtime roll forward](../whats-new/dotnet-core-3-0.md#major-version-runtime-roll-forward). + Roll forward behavior can also be configured in a project file property, a runtime configuration file property, and an environment variable. For more information, see [Major-version runtime roll forward](../versions/selection.md#control-roll-forward-behavior). - **`--fx-version `** @@ -160,7 +157,7 @@ The following options are available only when `dotnet` runs an application by us - **`--runtimeconfig `** - Path to a *runtimeconfig.json* file. A *runtimeconfig.json* file contains runtime settings and is typically named *\.runtimeconfig.json*. For more information, see [.NET runtime configuration settings](../runtime-config/index.md#runtimeconfigjson). + Path to a *runtimeconfig.json* file. A *runtimeconfig.json* file contains runtime settings and is typically named *\.runtimeconfig.json*. For more information, see [.NET runtime configuration settings](../runtime-config/index.md). ## dotnet commands From 2577fd5f1956d19f16b211a7ce1dd2f826c7ef3a Mon Sep 17 00:00:00 2001 From: "Meaghan Osagie (Lewis)" Date: Wed, 16 Sep 2026 09:47:17 -0700 Subject: [PATCH 8/8] Revert changes to dotnet.md (lines 81, 87, 125, 142, 160) --- docs/core/tools/dotnet.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/core/tools/dotnet.md b/docs/core/tools/dotnet.md index 7db740d08fa86..a29e0ee8c2437 100644 --- a/docs/core/tools/dotnet.md +++ b/docs/core/tools/dotnet.md @@ -78,13 +78,13 @@ Prints out the version of the .NET SDK used by `dotnet` commands, which may be a Prints out a list of the installed .NET runtimes for the architecture of the invoked `dotnet`. An x86 version of `dotnet` lists only x86 runtimes, and an x64 version of `dotnet` lists only x64 runtimes. - .NET 10 and later versions support the `--arch` argument. If specified and not the same as the `dotnet` architecture, searches for a .NET installation of the specified architecture and prints out its list of installed runtimes. + .NET 10 and later versions support the `--arch` argument. If specified and not the same as the `dotnet` architecture, searches for a .NET installation of the specified architecture and prints out any runtimes installed there. Allowed values include arm64, x64, and x86. The dotnet/runtime repo has the full [list of valid architecture values](https://github.com/dotnet/runtime/blob/1713d65316467e3eaf23514b6642eba5869f1b70/src/native/corehost/hostmisc/utils.cpp#L194-L205). - **`--list-sdks [--arch ]`** Prints out a list of the installed .NET SDKs for the architecture of the invoked `dotnet`. An x86 version of `dotnet` lists only x86 SDKs, and an x64 version of `dotnet` lists only x64 SDKs. - .NET 10 and later versions support the `--arch` argument. If specified and not the same as the `dotnet` architecture, searches for a .NET installation of the specified architecture and prints out its list of installed SDKs. + .NET 10 and later versions support the `--arch` argument. If specified and not the same as the `dotnet` architecture, searches for a .NET installation of the specified architecture and prints out any SDKs installed there. Allowed values include arm64, x64, and x86. The dotnet/runtime repo has the full [list of valid architecture values](https://github.com/dotnet/runtime/blob/1713d65316467e3eaf23514b6642eba5869f1b70/src/native/corehost/hostmisc/utils.cpp#L194-L205). - **`-?|-h|--help`** @@ -122,7 +122,7 @@ The following options are available when `dotnet` runs an application. For examp - **`--additional-deps `** - Path to an additional *.deps.json* file. A *deps.json* file contains a list of dependencies, compilation dependencies, and version information used to address assembly conflicts. For more information, see [Runtime package store](../deploying/runtime-store.md) on GitHub. + Path to an additional *.deps.json* file. A *deps.json* file contains a list of dependencies, compilation dependencies, and version information used to address assembly conflicts. For more information, see [Runtime Configuration Files](https://github.com/dotnet/sdk/blob/main/documentation/specs/runtime-configuration-file.md) on GitHub. @@ -139,7 +139,7 @@ The following options are available when `dotnet` runs an application. For examp With the exception of `Disable`, all settings will use the highest available patch version. - Roll forward behavior can also be configured in a project file property, a runtime configuration file property, and an environment variable. For more information, see [Major-version runtime roll forward](../versions/selection.md#control-roll-forward-behavior). + Roll forward behavior can also be configured in a project file property, a runtime configuration file property, and an environment variable. For more information, see [Major-version runtime roll forward](../whats-new/dotnet-core-3-0.md#major-version-runtime-roll-forward). - **`--fx-version `** @@ -157,7 +157,7 @@ The following options are available only when `dotnet` runs an application by us - **`--runtimeconfig `** - Path to a *runtimeconfig.json* file. A *runtimeconfig.json* file contains runtime settings and is typically named *\.runtimeconfig.json*. For more information, see [.NET runtime configuration settings](../runtime-config/index.md). + Path to a *runtimeconfig.json* file. A *runtimeconfig.json* file contains runtime settings and is typically named *\.runtimeconfig.json*. For more information, see [.NET runtime configuration settings](../runtime-config/index.md#runtimeconfigjson). ## dotnet commands