diff --git a/docs/core/tools/dotnet-build-server.md b/docs/core/tools/dotnet-build-server.md index 120697835b333..c45c093227e20 100644 --- a/docs/core/tools/dotnet-build-server.md +++ b/docs/core/tools/dotnet-build-server.md @@ -29,7 +29,7 @@ dotnet build-server -h|--help ## Options -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] - **`--msbuild`** diff --git a/docs/core/tools/dotnet-build.md b/docs/core/tools/dotnet-build.md index 2afb2721845f3..08923b0ffe05c 100644 --- a/docs/core/tools/dotnet-build.md +++ b/docs/core/tools/dotnet-build.md @@ -77,13 +77,13 @@ Running `dotnet build` is equivalent to running `dotnet msbuild -restore`; howev ## Options -[!INCLUDE [arch](../../../includes/cli-arch.md)] +- [!INCLUDE [arch](../../../includes/cli-arch.md)] -[!INCLUDE [artifacts-path](../../../includes/cli-artifacts-path.md)] +- [!INCLUDE [artifacts-path](../../../includes/cli-artifacts-path.md)] -[!INCLUDE [configuration](../../../includes/cli-configuration.md)] +- [!INCLUDE [configuration](../../../includes/cli-configuration.md)] -[!INCLUDE [disable-build-servers](../../../includes/cli-disable-build-servers.md)] +- [!INCLUDE [disable-build-servers](../../../includes/cli-disable-build-servers.md)] - **`-f|--framework `** @@ -93,7 +93,7 @@ Running `dotnet build` is equivalent to running `dotnet msbuild -restore`; howev Forces all dependencies to be resolved even if the last restore was successful. Specifying this flag is the same as deleting the *project.assets.json* file. -[!INCLUDE [interactive](../../../includes/cli-interactive-3-0.md)] +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] - **`--no-dependencies`** @@ -111,7 +111,7 @@ Running `dotnet build` is equivalent to running `dotnet msbuild -restore`; howev Doesn't display the startup banner or the copyright message. -[!INCLUDE [no-self-contained](../../../includes/cli-no-self-contained.md)] +- [!INCLUDE [no-self-contained](../../../includes/cli-no-self-contained.md)] - **`-o|--output `** @@ -121,7 +121,7 @@ Running `dotnet build` is equivalent to running `dotnet msbuild -restore`; howev If you specify the `--output` option when running this command on a solution, the CLI will emit a warning (an error in 7.0.200) due to the unclear semantics of the output path. The `--output` option is disallowed because all outputs of all built projects would be copied into the specified directory, which isn't compatible with multi-targeted projects, as well as projects that have different versions of direct and transitive dependencies. For more information, see [Solution-level `--output` option no longer valid for build-related commands](../compatibility/sdk/7.0/solution-level-output-no-longer-valid.md). -[!INCLUDE [os](../../../includes/cli-os.md)] +- [!INCLUDE [os](../../../includes/cli-os.md)] - **`-p|--property:=`** @@ -136,23 +136,23 @@ Running `dotnet build` is equivalent to running `dotnet msbuild -restore`; howev Specifies the target runtime. For a list of Runtime Identifiers (RIDs), see the [RID catalog](../rid-catalog.md). If you use this option with .NET 6 SDK, use `--self-contained` or `--no-self-contained` also. If not specified, the default is to build for the current OS and architecture. -[!INCLUDE [self-contained](../../../includes/cli-self-contained.md)] +- [!INCLUDE [self-contained](../../../includes/cli-self-contained.md)] - **`--source `** The URI of the NuGet package source to use during the restore operation. -[!INCLUDE [tl](../../../includes/cli-tl.md)] +- [!INCLUDE [tl](../../../includes/cli-tl.md)] -[!INCLUDE [use-current-runtime](../../../includes/cli-use-current-runtime.md)] +- [!INCLUDE [use-current-runtime](../../../includes/cli-use-current-runtime.md)] -[!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] - **`--version-suffix `** Sets the value of the `$(VersionSuffix)` property to use when building the project. This only works if the `$(Version)` property isn't set. Then, `$(Version)` is set to the `$(VersionPrefix)` combined with the `$(VersionSuffix)`, separated by a dash. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-clean.md b/docs/core/tools/dotnet-clean.md index 752e8745c3bce..2ab0350b30f9a 100644 --- a/docs/core/tools/dotnet-clean.md +++ b/docs/core/tools/dotnet-clean.md @@ -34,17 +34,17 @@ The `dotnet clean` command cleans the output of the previous build. It's impleme ## Options -[!INCLUDE [artifacts-path](../../../includes/cli-artifacts-path.md)] +- [!INCLUDE [artifacts-path](../../../includes/cli-artifacts-path.md)] -[!INCLUDE [configuration](../../../includes/cli-configuration-clean.md)] +- [!INCLUDE [configuration](../../../includes/cli-configuration-clean.md)] - **`-f|--framework `** The [framework](../../standard/frameworks.md) that was specified at build time. The framework must be defined in the [project file](../project-sdk/overview.md). If you specified the framework at build time, you must specify the framework when cleaning. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] -[!INCLUDE [interactive](../../../includes/cli-interactive-3-0.md)] +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] - **`--nologo`** @@ -62,9 +62,9 @@ The `dotnet clean` command cleans the output of the previous build. It's impleme Cleans the output folder of the specified runtime. This is used when a [self-contained deployment](../deploying/index.md#self-contained-deployment) was created. -[!INCLUDE [tl](../../../includes/cli-tl.md)] +- [!INCLUDE [tl](../../../includes/cli-tl.md)] -[!INCLUDE [verbosity](../../../includes/cli-verbosity-normal.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity-normal.md)] ## Examples diff --git a/docs/core/tools/dotnet-format.md b/docs/core/tools/dotnet-format.md index 15229a303263c..0e7cb11677bb9 100644 --- a/docs/core/tools/dotnet-format.md +++ b/docs/core/tools/dotnet-format.md @@ -82,9 +82,9 @@ None of the options below are required for the `dotnet format` command to succee Displays version information. -[!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Subcommands diff --git a/docs/core/tools/dotnet-help.md b/docs/core/tools/dotnet-help.md index c7aafe2dff108..c4e5f103aa20d 100644 --- a/docs/core/tools/dotnet-help.md +++ b/docs/core/tools/dotnet-help.md @@ -29,7 +29,7 @@ The `dotnet help` command opens up the reference page for more detailed informat ## Options -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-new-details.md b/docs/core/tools/dotnet-new-details.md index a8ebef29ae490..db8b413ae61ba 100644 --- a/docs/core/tools/dotnet-new-details.md +++ b/docs/core/tools/dotnet-new-details.md @@ -36,15 +36,13 @@ If the package is installed locally or is found on the official NuGet website, i By default, `dotnet new details` uses the hierarchy of NuGet configuration files from the current directory to determine the NuGet source the package can be installed from. If `--nuget-source` is specified, the source is added to the list of sources to be checked. To check the configured sources for the current directory use [`dotnet nuget list source`](dotnet-nuget-list-source.md). For more information, see [Common NuGet Configurations](/nuget/consume-packages/configuring-nuget-behavior). -[!INCLUDE [interactive](../../../includes/cli-interactive.md)] +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] - **`-d|--diagnostics`** Enables diagnostic output. -- **`-h|--help`** - - Displays help for the search command. +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-new-install.md b/docs/core/tools/dotnet-new-install.md index b93b76838ae61..c2d3699e37d72 100644 --- a/docs/core/tools/dotnet-new-install.md +++ b/docs/core/tools/dotnet-new-install.md @@ -70,15 +70,11 @@ Starting with .NET SDK 6.0.100, installed template packages are available in lat Allows installing template packages from the specified sources even if they would override a template package from another source. Available since .NET SDK 7.0.100. -- **`-h|--help`** +- [!INCLUDE [help](../../../includes/cli-help.md)] - Prints out help for the install command. Available since .NET SDK 7.0.100. +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] -[!INCLUDE [interactive](../../../includes/cli-interactive-5-0.md)] - -- **`-v|--verbosity `** - - Sets the verbosity level of the command. Allowed values are `q[uiet]`, `m[inimal]`, `n[ormal]`, and `diag[nostic]`. Available since .NET SDK 7.0.100. +- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] ## Examples diff --git a/docs/core/tools/dotnet-new-list.md b/docs/core/tools/dotnet-new-list.md index 6a580bb05352d..ced73f9a88a3d 100644 --- a/docs/core/tools/dotnet-new-list.md +++ b/docs/core/tools/dotnet-new-list.md @@ -75,9 +75,7 @@ Starting with .NET SDK 7.0.100, the `list` command might not show all the templa Enables diagnostic output. Available since .NET SDK 7.0.100. -- **`-h|--help`** - - Prints out help for the list command. Available since .NET SDK 7.0.100. +- [!INCLUDE [help](../../../includes/cli-help.md)] - **`--ignore-constraints`** @@ -106,9 +104,7 @@ Starting with .NET SDK 7.0.100, the `list` command might not show all the templa Filters templates based on template type. Predefined values are `project`, `item`, and `solution`. -- **`-v|--verbosity `** - - Sets the verbosity level of the command. Allowed values are `q[uiet]`, `m[inimal]`, `n[ormal]`, and `diag[nostic]`. Available since .NET SDK 7.0.100. +- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] ## Examples diff --git a/docs/core/tools/dotnet-new-search.md b/docs/core/tools/dotnet-new-search.md index 7d6ad97a795de..af207f64ca65b 100644 --- a/docs/core/tools/dotnet-new-search.md +++ b/docs/core/tools/dotnet-new-search.md @@ -72,9 +72,7 @@ The `dotnet new search` command searches for templates supported by `dotnet new` Enables diagnostic output. Available since .NET SDK 7.0.100. -- **`-h|--help`** - - Prints out help for the search command. Available since .NET SDK 7.0.100. +- [!INCLUDE [help](../../../includes/cli-help.md)] - **`-lang|--language `** diff --git a/docs/core/tools/dotnet-new-uninstall.md b/docs/core/tools/dotnet-new-uninstall.md index eaab7e4d0812b..c526446a43164 100644 --- a/docs/core/tools/dotnet-new-uninstall.md +++ b/docs/core/tools/dotnet-new-uninstall.md @@ -51,13 +51,9 @@ The `dotnet new uninstall` command uninstalls a template package at the `PATH` o Enables diagnostic output. Available since .NET SDK 7.0.100. -- **`-h|--help`** +- [!INCLUDE [help](../../../includes/cli-help.md)] - Prints out help for the uninstall command. Available since .NET SDK 7.0.100. - -- **`-v|--verbosity `** - - Sets the verbosity level of the command. Allowed values are `q[uiet]`, `m[inimal]`, `n[ormal]`, and `diag[nostic]`. Available since .NET SDK 7.0.100. +- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] ## Examples diff --git a/docs/core/tools/dotnet-new-update.md b/docs/core/tools/dotnet-new-update.md index 2e330d8d27dd8..5da571f502000 100644 --- a/docs/core/tools/dotnet-new-update.md +++ b/docs/core/tools/dotnet-new-update.md @@ -47,7 +47,7 @@ The `dotnet new update` command with `--check-only` option checks for available ## Options -[!INCLUDE [interactive](../../../includes/cli-interactive-5-0.md)] +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] - **`--add-source|nuget-source `** @@ -62,13 +62,9 @@ The `dotnet new update` command with `--check-only` option checks for available Enables diagnostic output. Available since .NET SDK 7.0.100. -- **`-h|--help`** +- [!INCLUDE [help](../../../includes/cli-help.md)] - Prints out help for the update command. Available since .NET SDK 7.0.100. - -- **`-v|--verbosity `** - - Sets the verbosity level of the command. Allowed values are `q[uiet]`, `m[inimal]`, `n[ormal]`, and `diag[nostic]`. Available since .NET SDK 7.0.100. +- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] ## Examples diff --git a/docs/core/tools/dotnet-new.md b/docs/core/tools/dotnet-new.md index 13db4cf3934eb..84751d438480a 100644 --- a/docs/core/tools/dotnet-new.md +++ b/docs/core/tools/dotnet-new.md @@ -63,9 +63,7 @@ To activate tab completion for the .NET SDK, see [Enable tab completion](enable- Forces content to be generated even if it would change existing files. This is required when the template chosen would override existing files in the output directory. -- **`-?|-h|--help`** - - Prints out help for the command. It can be invoked for the `dotnet new` command itself or for any template. For example, `dotnet new mvc --help`. +- [!INCLUDE [help](../../../includes/cli-help.md)] - **`-lang|--language {C#|F#|VB}`** @@ -100,9 +98,7 @@ To activate tab completion for the .NET SDK, see [Enable tab completion](enable- Enables diagnostic output. Available since .NET SDK 7.0.100. -- **`-v|--verbosity `** - - Sets the verbosity level of the command. Allowed values are `q[uiet]`, `m[inimal]`, `n[ormal]`, and `diag[nostic]`. Available since .NET SDK 7.0.100. +- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] ## Template options diff --git a/docs/core/tools/dotnet-nuget-add-source.md b/docs/core/tools/dotnet-nuget-add-source.md index fa0911d9b7d2b..773ec66e50d79 100644 --- a/docs/core/tools/dotnet-nuget-add-source.md +++ b/docs/core/tools/dotnet-nuget-add-source.md @@ -39,7 +39,7 @@ The `dotnet nuget add source` command adds a new package source to your NuGet co ## Options -[!INCLUDE [configfile](../../../includes/cli-configfile.md)] +- [!INCLUDE [configfile](../../../includes/cli-configfile.md)] - **`--allow-insecure-connections`** diff --git a/docs/core/tools/dotnet-nuget-config-get.md b/docs/core/tools/dotnet-nuget-config-get.md index 5d2df3f0895b7..6f4a09f4865f9 100644 --- a/docs/core/tools/dotnet-nuget-config-get.md +++ b/docs/core/tools/dotnet-nuget-config-get.md @@ -44,7 +44,7 @@ The `dotnet nuget config get` Gets the NuGet configuration settings that will be Specifies the directory to start from when listing configuration files. If not specified, the current directory is used. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-nuget-config-paths.md b/docs/core/tools/dotnet-nuget-config-paths.md index f4c5c43aaea09..6977fbd18a0e4 100644 --- a/docs/core/tools/dotnet-nuget-config-paths.md +++ b/docs/core/tools/dotnet-nuget-config-paths.md @@ -30,7 +30,7 @@ The `dotnet nuget config paths` Lists the paths to all NuGet configuration files Specifies the directory to start from when listing configuration files. If not specified, the current directory is used. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-nuget-config-set.md b/docs/core/tools/dotnet-nuget-config-set.md index 6735c1d5777ed..f6ef6f0e60ac3 100644 --- a/docs/core/tools/dotnet-nuget-config-set.md +++ b/docs/core/tools/dotnet-nuget-config-set.md @@ -36,11 +36,9 @@ The `dotnet nuget config set` sets the values for NuGet configuration settings t ## Options -- **`--configfile `** +- [!INCLUDE [configfile](../../../includes/cli-configfile.md)] - The NuGet configuration file (*nuget.config*) to use. If specified, only the settings from this file will be used. If not specified, the hierarchy of configuration files from the current directory will be used. For more information, see [Common NuGet Configurations](/nuget/consume-packages/configuring-nuget-behavior). - -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-nuget-config-unset.md b/docs/core/tools/dotnet-nuget-config-unset.md index 487cb32462180..1c5c16791588e 100644 --- a/docs/core/tools/dotnet-nuget-config-unset.md +++ b/docs/core/tools/dotnet-nuget-config-unset.md @@ -32,11 +32,9 @@ The `dotnet nuget config unset` unsets the values for NuGet configuration settin ## Options -- **`--configfile `** +- [!INCLUDE [configfile](../../../includes/cli-configfile.md)] - The NuGet configuration file (*nuget.config*) to use. If specified, only the settings from this file will be used. If not specified, the hierarchy of configuration files from the current directory will be used. For more information, see [Common NuGet Configurations](/nuget/consume-packages/configuring-nuget-behavior). - -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-nuget-delete.md b/docs/core/tools/dotnet-nuget-delete.md index aa4810879f038..4058a07414890 100644 --- a/docs/core/tools/dotnet-nuget-delete.md +++ b/docs/core/tools/dotnet-nuget-delete.md @@ -42,9 +42,9 @@ The `dotnet nuget delete` command deletes or unlists a package from the server. Forces the application to run using an invariant, English-based culture. -[!INCLUDE [help](../../../includes/cli-help.md)] +* [!INCLUDE [help](../../../includes/cli-help.md)] -[!INCLUDE [interactive](../../../includes/cli-interactive-3-0.md)] +* [!INCLUDE [interactive](../../../includes/cli-interactive.md)] * **`-k|--api-key `** diff --git a/docs/core/tools/dotnet-nuget-disable-source.md b/docs/core/tools/dotnet-nuget-disable-source.md index 918e33abdcbdb..e8ef2e8384e68 100644 --- a/docs/core/tools/dotnet-nuget-disable-source.md +++ b/docs/core/tools/dotnet-nuget-disable-source.md @@ -31,7 +31,7 @@ The `dotnet nuget disable source` command disables an existing source in your Nu ## Options -[!INCLUDE [configfile](../../../includes/cli-configfile.md)] +- [!INCLUDE [configfile](../../../includes/cli-configfile.md)] ## Examples diff --git a/docs/core/tools/dotnet-nuget-enable-source.md b/docs/core/tools/dotnet-nuget-enable-source.md index f702bb803cd39..ae6bb4ac0a35b 100644 --- a/docs/core/tools/dotnet-nuget-enable-source.md +++ b/docs/core/tools/dotnet-nuget-enable-source.md @@ -31,7 +31,7 @@ The `dotnet nuget enable source` command enables an existing source in your NuGe ## Options -[!INCLUDE [configfile](../../../includes/cli-configfile.md)] +- [!INCLUDE [configfile](../../../includes/cli-configfile.md)] ## Examples diff --git a/docs/core/tools/dotnet-nuget-list-source.md b/docs/core/tools/dotnet-nuget-list-source.md index 7d2b8e90df265..2b31d815db8aa 100644 --- a/docs/core/tools/dotnet-nuget-list-source.md +++ b/docs/core/tools/dotnet-nuget-list-source.md @@ -25,7 +25,7 @@ The `dotnet nuget list source` command lists all existing sources from your NuGe ## Options -[!INCLUDE [configfile](../../../includes/cli-configfile.md)] +- [!INCLUDE [configfile](../../../includes/cli-configfile.md)] - **`--format [Detailed|Short]`** diff --git a/docs/core/tools/dotnet-nuget-locals.md b/docs/core/tools/dotnet-nuget-locals.md index af7421d426fdf..da68e7262629e 100644 --- a/docs/core/tools/dotnet-nuget-locals.md +++ b/docs/core/tools/dotnet-nuget-locals.md @@ -42,7 +42,7 @@ The `dotnet nuget locals` command clears or lists local NuGet resources in the h Forces the application to run using an invariant, English-based culture. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] - **`-c|--clear`** diff --git a/docs/core/tools/dotnet-nuget-push.md b/docs/core/tools/dotnet-nuget-push.md index e82eaaca60564..8a18595decfc2 100644 --- a/docs/core/tools/dotnet-nuget-push.md +++ b/docs/core/tools/dotnet-nuget-push.md @@ -62,9 +62,9 @@ Alternatively, use the NuGet CLI for the first package, then you can use `dotnet Forces the application to run using an invariant, English-based culture. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] -[!INCLUDE [interactive](../../../includes/cli-interactive-3-0.md)] +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] - **`-k|--api-key `** diff --git a/docs/core/tools/dotnet-nuget-remove-source.md b/docs/core/tools/dotnet-nuget-remove-source.md index 6cec56394d2ab..0d297f2c23c7a 100644 --- a/docs/core/tools/dotnet-nuget-remove-source.md +++ b/docs/core/tools/dotnet-nuget-remove-source.md @@ -31,7 +31,7 @@ The `dotnet nuget remove source` command removes an existing source from your Nu ## Options -[!INCLUDE [configfile](../../../includes/cli-configfile.md)] +- [!INCLUDE [configfile](../../../includes/cli-configfile.md)] ## Examples diff --git a/docs/core/tools/dotnet-nuget-sign.md b/docs/core/tools/dotnet-nuget-sign.md index b975e8cb02a02..e80dea25c124f 100644 --- a/docs/core/tools/dotnet-nuget-sign.md +++ b/docs/core/tools/dotnet-nuget-sign.md @@ -104,9 +104,9 @@ The `dotnet nuget sign` command signs all the packages matching the first argume URL to an RFC 3161 timestamping server. -[!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-nuget-trust.md b/docs/core/tools/dotnet-nuget-trust.md index 2a1a09f60f843..dbae8176fa221 100644 --- a/docs/core/tools/dotnet-nuget-trust.md +++ b/docs/core/tools/dotnet-nuget-trust.md @@ -29,7 +29,7 @@ The `dotnet nuget trust` command manages the trusted signers. By default, NuGet ## Options -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Commands @@ -47,11 +47,11 @@ dotnet nuget trust list [--configfile ] [-h|--help] [-v, --verbosity [--configfile ] [-h|--help] [-v, --verbosit #### Options: -[!INCLUDE [configfile](../../../includes/cli-configfile.md)] +- [!INCLUDE [configfile](../../../includes/cli-configfile.md)] -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] -[!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] ### `remove` @@ -95,11 +95,11 @@ dotnet nuget trust remove [--configfile ] [-h|--help] [-v, --verbos #### Options: -[!INCLUDE [configfile](../../../includes/cli-configfile.md)] +- [!INCLUDE [configfile](../../../includes/cli-configfile.md)] -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] -[!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] ### `author` @@ -127,11 +127,11 @@ dotnet nuget trust author [--allow-untrusted-root] [--configfil Specifies if the certificate for the trusted signer should be allowed to chain to an untrusted root. This is not recommended. -[!INCLUDE [configfile](../../../includes/cli-configfile.md)] +- [!INCLUDE [configfile](../../../includes/cli-configfile.md)] -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] -[!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] ### `repository` @@ -159,15 +159,15 @@ dotnet nuget trust repository [--allow-untrusted-root] [--confi Specifies if the certificate for the trusted signer should be allowed to chain to an untrusted root. This is not recommended. -[!INCLUDE [configfile](../../../includes/cli-configfile.md)] +- [!INCLUDE [configfile](../../../includes/cli-configfile.md)] -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] - **`--owners `** Semicolon-separated list of trusted owners to further restrict the trust of a repository. -[!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] ### `certificate` @@ -199,11 +199,11 @@ dotnet nuget trust certificate [--algorithm ] [- Specifies if the certificate for the trusted signer should be allowed to chain to an untrusted root. This is not recommended. -[!INCLUDE [configfile](../../../includes/cli-configfile.md)] +- [!INCLUDE [configfile](../../../includes/cli-configfile.md)] -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] -[!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] ### `source` @@ -223,9 +223,9 @@ dotnet nuget trust source [--configfile ] [-h|--help] [--owners
  • `** @@ -235,7 +235,7 @@ dotnet nuget trust source [--configfile ] [-h|--help] [--owners
  • `** diff --git a/docs/core/tools/dotnet-nuget-verify.md b/docs/core/tools/dotnet-nuget-verify.md index 77df9b7284eb6..779a3d03d0fe8 100644 --- a/docs/core/tools/dotnet-nuget-verify.md +++ b/docs/core/tools/dotnet-nuget-verify.md @@ -78,9 +78,9 @@ In .NET 10 and later versions, the command also outputs the package's content ha ❌ indicates details that are **not** displayed. ✔️ indicates details that are displayed. -[!INCLUDE [configfile](../../../includes/cli-configfile.md)] +- [!INCLUDE [configfile](../../../includes/cli-configfile.md)] -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-nuget-why.md b/docs/core/tools/dotnet-nuget-why.md index fff89d4a24957..5a2ae170c7f66 100644 --- a/docs/core/tools/dotnet-nuget-why.md +++ b/docs/core/tools/dotnet-nuget-why.md @@ -53,7 +53,7 @@ To use the command with projects that can't be restored with the .NET SDK, you c The target framework(s) for which dependency graphs are shown. You can pass multiple `--framework` options to see graphs for more than one framework. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-pack.md b/docs/core/tools/dotnet-pack.md index b1db4d6dbc5f4..15ff0e860e6e3 100644 --- a/docs/core/tools/dotnet-pack.md +++ b/docs/core/tools/dotnet-pack.md @@ -60,11 +60,11 @@ You can provide MSBuild properties to the `dotnet pack` command for the packing ## Options -[!INCLUDE [artifacts-path](../../../includes/cli-artifacts-path.md)] +- [!INCLUDE [artifacts-path](../../../includes/cli-artifacts-path.md)] -[!INCLUDE [configuration](../../../includes/cli-configuration-publish-pack.md)] +- [!INCLUDE [configuration](../../../includes/cli-configuration-publish-pack.md)] -[!INCLUDE [disable-build-servers](../../../includes/cli-disable-build-servers.md)] +- [!INCLUDE [disable-build-servers](../../../includes/cli-disable-build-servers.md)] - **`--force`** @@ -78,7 +78,7 @@ You can provide MSBuild properties to the `dotnet pack` command for the packing Includes the debug symbols NuGet packages in addition to the regular NuGet packages in the output directory. -[!INCLUDE [interactive](../../../includes/cli-interactive.md)] +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] - **`--no-build`** @@ -112,9 +112,9 @@ You can provide MSBuild properties to the `dotnet pack` command for the packing Sets the serviceable flag in the package. For more information, see [.NET Blog: .NET Framework 4.5.1 Supports Microsoft Security Updates for .NET NuGet Libraries](https://aka.ms/nupkgservicing). -[!INCLUDE [tl](../../../includes/cli-tl.md)] +- [!INCLUDE [tl](../../../includes/cli-tl.md)] -[!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] - **`--version-suffix `** @@ -132,7 +132,7 @@ You can provide MSBuild properties to the `dotnet pack` command for the packing If `Version` has a value and you pass `--version-suffix` to `dotnet pack`, the value specified for `--version-suffix` is ignored. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-package-add.md b/docs/core/tools/dotnet-package-add.md index 7807387630501..5b5dfac8801de 100644 --- a/docs/core/tools/dotnet-package-add.md +++ b/docs/core/tools/dotnet-package-add.md @@ -142,9 +142,9 @@ Scenario 4: `` does not exist in the project file, ``** @@ -68,11 +66,9 @@ By default, the command downloads only the packages you specify (no transitive d Specifies the NuGet package source to use. -* **`-v, --verbosity `** - - Set the verbosity level of the command. Allowed values are `q[uiet]`, `m[inimal]`, `n[ormal]`, `d[etailed]`, and `diag[nostic]`. +* [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] -[!INCLUDE [help](../../../includes/cli-help.md)] +* [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-package-list.md b/docs/core/tools/dotnet-package-list.md index bf048671e4331..6fa5190a77e8a 100644 --- a/docs/core/tools/dotnet-package-list.md +++ b/docs/core/tools/dotnet-package-list.md @@ -115,7 +115,7 @@ The project or solution file to operate on. If not specified, the command search Displays only the packages applicable for the specified [target framework](../../standard/frameworks.md). To specify multiple frameworks, repeat the option multiple times. For example: `--framework net6.0 --framework netstandard2.0`. The short form of the option (`-f`) is available starting in .NET 9 SDK. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] - **`--highest-minor`** @@ -133,7 +133,7 @@ The project or solution file to operate on. If not specified, the command search Lists transitive packages, in addition to the top-level packages. When specifying this option, you get a list of packages that the top-level packages depend on. -[!INCLUDE [interactive](../../../includes/cli-interactive-3-0.md)] +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] - **`--no-restore`** @@ -147,7 +147,7 @@ The project or solution file to operate on. If not specified, the command search The NuGet sources to use when searching for newer packages. Requires the `--outdated` or `--deprecated` option. -[!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] - **`--vulnerable`** diff --git a/docs/core/tools/dotnet-package-remove.md b/docs/core/tools/dotnet-package-remove.md index 3c3d77f2421bb..b0cef14e0fa9f 100644 --- a/docs/core/tools/dotnet-package-remove.md +++ b/docs/core/tools/dotnet-package-remove.md @@ -39,13 +39,13 @@ The package reference to remove. The file-based app to operate on. -[!INCLUDE [interactive](../../../includes/cli-interactive.md)] +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] - **`-p|--project `** The project file to operate on. If a solution file is specified, the command will update the package in all projects in the solution that reference it. If not specified, the command will search the current directory for a project file. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-package-search.md b/docs/core/tools/dotnet-package-search.md index f46c09bf6706e..29ea29c931ea1 100644 --- a/docs/core/tools/dotnet-package-search.md +++ b/docs/core/tools/dotnet-package-search.md @@ -34,11 +34,7 @@ The `dotnet package search` command searches for a NuGet package. ## Options -- **`--configfile`** - - The NuGet configuration file. If specified, only the settings from this file will be used. If not - specified, the hierarchy of configuration files from the current directory will be used. For more - information, see [Common NuGet configurations](/nuget/consume-packages/configuring-nuget-behavior). +- [!INCLUDE [configfile](../../../includes/cli-configfile.md)] - **`--exact-match`** @@ -49,9 +45,7 @@ The `dotnet package search` command searches for a NuGet package. The format options are `table` and `json`. The default is `table`. -- **`--interactive`** - - Allows the command to stop and wait for user input or action (for example to complete authentication). +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] - **`--prerelease`** @@ -69,11 +63,9 @@ The `dotnet package search` command searches for a NuGet package. The number of results to return. The default value is 20. -- **`--verbosity`** - - Display this amount of details in the output: `normal`, `minimal`, or `detailed`. The default is `normal`. +- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-package-update.md b/docs/core/tools/dotnet-package-update.md index 53007081f211d..08524393dcdcc 100644 --- a/docs/core/tools/dotnet-package-update.md +++ b/docs/core/tools/dotnet-package-update.md @@ -49,9 +49,7 @@ On Windows Command Prompt and PowerShell, you will need to set the environment v ## Options -- **`--interactive`** - - Allows the command to stop and wait for user input or action (for example to complete authentication). +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] - **`--project `** @@ -59,16 +57,14 @@ On Windows Command Prompt and PowerShell, you will need to set the environment v If a directory is provided, it searches for project and solution files in the directory. Defaults to the current working directory. -- **`--verbosity`** - - Display this amount of details in the output: `[n]ormal`, `[m]inimal`, `[q]uiet`, `[d]etailed`, or `[diag]nostic`. The default is `normal`. +- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] - **`--vulnerable`** If restore reports any packages as having known vulnerabilities, this command will upgrade those packages. Using this option will upgrade packages to the lowest version that is higher than the currently referenced version, that does not have any known vulnerabilities. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-publish.md b/docs/core/tools/dotnet-publish.md index 372dbd3bd6b7f..87566e6b4261a 100644 --- a/docs/core/tools/dotnet-publish.md +++ b/docs/core/tools/dotnet-publish.md @@ -119,13 +119,13 @@ For more information, see the following resources: ## Options -[!INCLUDE [arch](../../../includes/cli-arch.md)] +- [!INCLUDE [arch](../../../includes/cli-arch.md)] -[!INCLUDE [artifacts-path](../../../includes/cli-artifacts-path.md)] +- [!INCLUDE [artifacts-path](../../../includes/cli-artifacts-path.md)] -[!INCLUDE [configuration](../../../includes/cli-configuration-publish-pack.md)] +- [!INCLUDE [configuration](../../../includes/cli-configuration-publish-pack.md)] -[!INCLUDE [disable-build-servers](../../../includes/cli-disable-build-servers.md)] +- [!INCLUDE [disable-build-servers](../../../includes/cli-disable-build-servers.md)] - **`-f|--framework `** @@ -135,7 +135,7 @@ For more information, see the following resources: Forces all dependencies to be resolved even if the last restore was successful. Specifying this flag is the same as deleting the *project.assets.json* file. -[!INCLUDE [interactive](../../../includes/cli-interactive.md)] +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] - **`--manifest `** @@ -179,7 +179,9 @@ For more information, see the following resources: If you specify a relative path when publishing a solution, all output for all projects goes into the specified folder relative to the current working directory. To make publish output go to separate folders for each project, specify a relative path by using the msbuild `PublishDir` property instead of the `--output` option. For example, `dotnet publish -p:PublishDir=.\publish` sends publish output for each project to a `publish` folder under the folder that contains the project file. -[!INCLUDE [os](../../../includes/cli-os.md)] +- [!INCLUDE [os](../../../includes/cli-os.md)] + +- [!INCLUDE [self-contained](../../../includes/cli-self-contained.md)] - **`-p|--property:=`** @@ -190,9 +192,7 @@ For more information, see the following resources: --property:= --property:= ``` -[!INCLUDE [self-contained](../../../includes/cli-self-contained.md)] - -[!INCLUDE [no-self-contained](../../../includes/cli-no-self-contained.md)] +- [!INCLUDE [no-self-contained](../../../includes/cli-no-self-contained.md)] - **`--source `** @@ -202,17 +202,17 @@ For more information, see the following resources: Publishes the application for a given runtime. For a list of Runtime Identifiers (RIDs), see the [RID catalog](../rid-catalog.md). For more information, see [.NET application publishing overview](../deploying/index.md). If you use this option, use `--self-contained` or `--no-self-contained` also. -[!INCLUDE [tl](../../../includes/cli-tl.md)] +- [!INCLUDE [tl](../../../includes/cli-tl.md)] -[!INCLUDE [use-current-runtime](../../../includes/cli-use-current-runtime.md)] +- [!INCLUDE [use-current-runtime](../../../includes/cli-use-current-runtime.md)] -[!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] - **`--version-suffix `** Defines the version suffix to replace the asterisk (`*`) in the version field of the project file. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-reference-add.md b/docs/core/tools/dotnet-reference-add.md index 6cb0f2c5cd03c..f89a809d28b8c 100644 --- a/docs/core/tools/dotnet-reference-add.md +++ b/docs/core/tools/dotnet-reference-add.md @@ -64,9 +64,9 @@ There's no CLI command to add a reference to an assembly that isn't in a project Adds project references only when targeting a specific [framework](../../standard/frameworks.md) using the TFM format. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] -[!INCLUDE [interactive](../../../includes/cli-interactive-3-0.md)] +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] ## Examples diff --git a/docs/core/tools/dotnet-reference-list.md b/docs/core/tools/dotnet-reference-list.md index 6be95729f69aa..d20cf32296f40 100644 --- a/docs/core/tools/dotnet-reference-list.md +++ b/docs/core/tools/dotnet-reference-list.md @@ -34,7 +34,7 @@ The `dotnet reference list` command provides a convenient option to list project ## Options -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-reference-remove.md b/docs/core/tools/dotnet-reference-remove.md index 12380c42bc5c4..79620c78ec609 100644 --- a/docs/core/tools/dotnet-reference-remove.md +++ b/docs/core/tools/dotnet-reference-remove.md @@ -39,7 +39,7 @@ Project-to-project (P2P) references to remove. You can specify one or multiple p ## Options -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] - **`-f|--framework `** diff --git a/docs/core/tools/dotnet-restore.md b/docs/core/tools/dotnet-restore.md index 5058a7c8c656a..2071590e11197 100644 --- a/docs/core/tools/dotnet-restore.md +++ b/docs/core/tools/dotnet-restore.md @@ -91,11 +91,11 @@ There are three specific settings that `dotnet restore` ignores: ## Options -[!INCLUDE [arch](../../../includes/cli-arch.md)] +- [!INCLUDE [arch](../../../includes/cli-arch.md)] -[!INCLUDE [configfile](../../../includes/cli-configfile.md)] +- [!INCLUDE [configfile](../../../includes/cli-configfile.md)] -[!INCLUDE [disable-build-servers](../../../includes/cli-disable-build-servers.md)] +- [!INCLUDE [disable-build-servers](../../../includes/cli-disable-build-servers.md)] - **`--disable-parallel`** @@ -113,7 +113,7 @@ There are three specific settings that `dotnet restore` ignores: Only warn about failed sources if there are packages meeting the version requirement. -[!INCLUDE [interactive](../../../includes/cli-interactive.md)] +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] - **`--lock-file-path `** @@ -149,17 +149,17 @@ There are three specific settings that `dotnet restore` ignores: Specifies the URI of the NuGet package source to use during the restore operation. This setting overrides all of the sources specified in the *nuget.config* files. Multiple sources can be provided by specifying this option multiple times. -[!INCLUDE [use-current-runtime](../../../includes/cli-use-current-runtime.md)] +- [!INCLUDE [use-current-runtime](../../../includes/cli-use-current-runtime.md)] - **`--use-lock-file`** Enables project lock file to be generated and used with restore. -[!INCLUDE [tl](../../../includes/cli-tl.md)] +- [!INCLUDE [tl](../../../includes/cli-tl.md)] -[!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-run.md b/docs/core/tools/dotnet-run.md index 460aa3d35311b..2036b6a11a438 100644 --- a/docs/core/tools/dotnet-run.md +++ b/docs/core/tools/dotnet-run.md @@ -67,13 +67,13 @@ To run the application, the `dotnet run` command resolves the dependencies of th Delimits arguments to `dotnet run` from arguments for the application being run. All arguments after this delimiter are passed to the application run. -[!INCLUDE [arch](../../../includes/cli-arch.md)] +- [!INCLUDE [arch](../../../includes/cli-arch.md)] -[!INCLUDE [artifacts-path](../../../includes/cli-artifacts-path.md)] +- [!INCLUDE [artifacts-path](../../../includes/cli-artifacts-path.md)] -[!INCLUDE [configuration](../../../includes/cli-configuration.md)] +- [!INCLUDE [configuration](../../../includes/cli-configuration.md)] -[!INCLUDE [disable-build-servers](../../../includes/cli-disable-build-servers.md)] +- [!INCLUDE [disable-build-servers](../../../includes/cli-disable-build-servers.md)] - **`-e|--environment `** @@ -109,7 +109,7 @@ To run the application, the `dotnet run` command resolves the dependencies of th Forces all dependencies to be resolved even if the last restore was successful. Specifying this flag is the same as deleting the *project.assets.json* file. -[!INCLUDE [interactive](../../../includes/cli-interactive-3-0.md)] +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] - **`--launch-profile `** @@ -135,11 +135,9 @@ To run the application, the `dotnet run` command resolves the dependencies of th Doesn't execute an implicit restore when running the command. -- **`--no-self-contained`** +- [!INCLUDE [no-self-contained](../../../includes/cli-no-self-contained.md)] - Publish your application as a framework dependent application. A compatible .NET runtime must be installed on the target machine to run your application. - -[!INCLUDE [os](../../../includes/cli-os.md)] +- [!INCLUDE [os](../../../includes/cli-os.md)] - **`--project `** @@ -168,15 +166,13 @@ To run the application, the `dotnet run` command resolves the dependencies of th Specifies the target runtime to restore packages for. For a list of Runtime Identifiers (RIDs), see the [RID catalog](../rid-catalog.md). -- **`-sc|--self-contained`** - - Publishes the .NET runtime with your application so the runtime doesn't need to be installed on the target system. The default is `false`. However, when targeting .NET 7 or lower, the default is `true` if a runtime identifier is specified. +- [!INCLUDE [self-contained](../../../includes/cli-self-contained.md)] -[!INCLUDE [tl](../../../includes/cli-tl.md)] +- [!INCLUDE [tl](../../../includes/cli-tl.md)] -[!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Environment variables diff --git a/docs/core/tools/dotnet-sdk-check.md b/docs/core/tools/dotnet-sdk-check.md index 3b8eddb8b9ffb..0d78be5268b90 100644 --- a/docs/core/tools/dotnet-sdk-check.md +++ b/docs/core/tools/dotnet-sdk-check.md @@ -54,7 +54,7 @@ The latest versions of .NET can be installed from https://aka.ms/dotnet-core-dow ## Options -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-sln.md b/docs/core/tools/dotnet-sln.md index e0dee3e6c8caa..d2924f6f0293d 100644 --- a/docs/core/tools/dotnet-sln.md +++ b/docs/core/tools/dotnet-sln.md @@ -58,7 +58,7 @@ dotnet new sln --output MySolution ## Options -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Commands @@ -91,7 +91,7 @@ dotnet sln list [-h|--help] #### Options -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ### `add` @@ -128,7 +128,7 @@ dotnet sln add [-h|--help] #### Options -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] - **`--in-root`** @@ -165,7 +165,7 @@ dotnet sln [] remove [-h|--help] #### Options -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ### `migrate` @@ -190,7 +190,7 @@ dotnet sln [] migrate [-h|--help] #### Options -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-store.md b/docs/core/tools/dotnet-store.md index c792997fe5d7f..99dd38373e441 100644 --- a/docs/core/tools/dotnet-store.md +++ b/docs/core/tools/dotnet-store.md @@ -35,7 +35,7 @@ dotnet store -h|--help Specifies the [target framework](../../standard/frameworks.md). The target framework has to be specified in the project file. -[!INCLUDE [disable-build-servers](../../../includes/cli-disable-build-servers.md)] +- [!INCLUDE [disable-build-servers](../../../includes/cli-disable-build-servers.md)] - **`-m|--manifest `** @@ -67,13 +67,13 @@ dotnet store -h|--help Use current runtime as the target runtime. The default is `false`. -[!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] - **`-w|--working-dir `** The working directory used by the command. If not specified, it uses the *obj* subdirectory of the current directory. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-test.md b/docs/core/tools/dotnet-test.md index c1a5656259d00..7ca8c9ffe3e6e 100644 --- a/docs/core/tools/dotnet-test.md +++ b/docs/core/tools/dotnet-test.md @@ -133,9 +133,9 @@ Where `Microsoft.NET.Test.Sdk` is the test host, `xunit` is the test framework. Short form `-a` available in .NET SDK versions earlier than 7. -[!INCLUDE [arch-no-a](../../../includes/cli-arch-no-a.md)] +- [!INCLUDE [arch](../../../includes/cli-arch.md)] -[!INCLUDE [artifacts-path](../../../includes/cli-artifacts-path.md)] +- [!INCLUDE [artifacts-path](../../../includes/cli-artifacts-path.md)] - **`--blame`** @@ -180,7 +180,7 @@ Where `Microsoft.NET.Test.Sdk` is the test host, `xunit` is the test framework. When no unit is used (for example, 5400000), the value is assumed to be in milliseconds. When used together with data driven tests, the timeout behavior depends on the test adapter used. For xUnit, NUnit. and MSTest 2.2.4+, the timeout is renewed after every test case. For MSTest before version 2.2.4, the timeout is used for all test cases. This option is supported on Windows with `netcoreapp2.1` and later, on Linux with `netcoreapp3.1` and later, and on macOS with `net5.0` or later. Implies `--blame` and `--blame-hang`. -[!INCLUDE [configuration](../../../includes/cli-configuration.md)] +- [!INCLUDE [configuration](../../../includes/cli-configuration.md)] - **`--collect `** @@ -194,7 +194,7 @@ Where `Microsoft.NET.Test.Sdk` is the test host, `xunit` is the test framework. Enables diagnostic mode for the test platform and writes diagnostic messages to the specified file and to files next to it. The process that is logging the messages determines which files are created, such as `*.host_.txt` for test host log, and `*.datacollector_.txt` for data collector log. -[!INCLUDE [disable-build-servers](../../../includes/cli-disable-build-servers.md)] +- [!INCLUDE [disable-build-servers](../../../includes/cli-disable-build-servers.md)] - **`-e|--environment `** @@ -208,9 +208,9 @@ Where `Microsoft.NET.Test.Sdk` is the test host, `xunit` is the test framework. Filters tests in the current project using the given expression. Only tests that match the filter expression are run. For more information, see the [Filter option details](#filter-option-details) section. For more information and examples on how to use selective unit test filtering, see [Running selective unit tests](../testing/selective-unit-tests.md). -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] -[!INCLUDE [interactive](../../../includes/cli-interactive-3-0.md)] +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] - **`-l|--logger `** @@ -245,7 +245,7 @@ Where `Microsoft.NET.Test.Sdk` is the test host, `xunit` is the test framework. If you specify the `--output` option when running this command on a solution, the CLI will emit a warning (an error in 7.0.200) due to the unclear semantics of the output path. The `--output` option is disallowed because all outputs of all built projects would be copied into the specified directory, which isn't compatible with multi-targeted projects, as well as projects that have different versions of direct and transitive dependencies. For more information, see [Solution-level `--output` option no longer valid for build-related commands](../compatibility/sdk/7.0/solution-level-output-no-longer-valid.md). -[!INCLUDE [os](../../../includes/cli-os.md)] +- [!INCLUDE [os](../../../includes/cli-os.md)] - **`--results-directory `** @@ -270,9 +270,9 @@ Where `Microsoft.NET.Test.Sdk` is the test host, `xunit` is the test framework. List the discovered tests instead of running the tests. -[!INCLUDE [tl](../../../includes/cli-tl.md)] +- [!INCLUDE [tl](../../../includes/cli-tl.md)] -[!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] - **`args`** @@ -492,15 +492,15 @@ With Microsoft Testing Platform, `dotnet test` operates faster than with VSTest. Specifies the maximum number of test modules that can run in parallel. -[!INCLUDE [arch-no-a](../../../includes/cli-arch-no-a.md)] +- [!INCLUDE [arch](../../../includes/cli-arch.md)] -[!INCLUDE [configuration](../../../includes/cli-configuration.md)] +- [!INCLUDE [configuration](../../../includes/cli-configuration.md)] - **`-f|--framework `** The [target framework moniker (TFM)](../../standard/frameworks.md) of the target framework to run tests for. The target framework must also be specified in the project file. -[!INCLUDE [os](../../../includes/cli-os.md)] +- [!INCLUDE [os](../../../includes/cli-os.md)] - **`-r|--runtime `** @@ -511,9 +511,7 @@ With Microsoft Testing Platform, `dotnet test` operates faster than with VSTest. > [!NOTE] > Running tests for a solution with a global `RuntimeIdentifier` property (explicitly or via `--arch`, `--runtime`, or `--os`) is not supported. Set `RuntimeIdentifier` on an individual project level instead. -- **`-v|--verbosity `** - - Sets the MSBuild verbosity level. Allowed values are `q[uiet]`, `m[inimal]`, `n[ormal]`, `d[etailed]`, and `diag[nostic]`. For more information, see . +- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] - **`--no-build`** @@ -554,9 +552,7 @@ With Microsoft Testing Platform, `dotnet test` operates faster than with VSTest. The short form `-p` can be used for `--property`. The same applies for `/property:property=value` and its short form is `/p`. More informatiom about the available arguments can be found in [the dotnet msbuild documentation](dotnet-msbuild.md). -- **`-?|-h|--help`** - - Prints out a description of how to use the command. Some options are static while others, namely platform and extension options, are dynamic. These dynamic options might differ from one test application to another, as they are based on the registered extensions in the test project. +- [!INCLUDE [help](../../../includes/cli-help.md)] - **`args`** diff --git a/docs/core/tools/dotnet-tool-exec.md b/docs/core/tools/dotnet-tool-exec.md index 62abdd17e52e0..afc1a4e36eeda 100644 --- a/docs/core/tools/dotnet-tool-exec.md +++ b/docs/core/tools/dotnet-tool-exec.md @@ -63,21 +63,15 @@ This command also exists in two other forms for easier use Adds an additional NuGet package source to use during installation. Feeds are accessed in parallel, not in a fallback cascade sequence. If the same package and version is available in multiple feeds, the fastest feed wins. For more information, see [What happens when a NuGet package is installed](/nuget/concepts/package-installation-process#what-happens-when-a-nuget-package-is-installed). You can control this through the use of NuGet package source mapping. For more information, see [Package Source Mapping](/nuget/consume-packages/package-source-mapping). -- **`--configfile `** +- [!INCLUDE [configfile](../../../includes/cli-configfile.md)] - The NuGet configuration file (*nuget.config*) to use. If specified, only the settings from this file are used. If not specified, the hierarchy of configuration files from the current directory are used. For more information, see [Common NuGet Configurations](/nuget/consume-packages/configuring-nuget-behavior). - -- **`--disable-parallel`** - - Disables querying the configured NuGet feeds in parallel. +- [!INCLUDE [disable-parallel](../../../includes/cli-disable-parallel.md)] - **`--ignore-failed-sources`** Treats package source failures as warnings. -- **`--interactive`** - - Allows the command to stop and wait for user input or action, for example, to complete authentication. This option defaults to `true` when the command detects that it's being run directly by a user. +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] - **`--no-http-cache`** @@ -87,11 +81,9 @@ This command also exists in two other forms for easier use Allows prerelease packages to be selected when resolving the version to install. -- **`-v|--verbosity `** - - Sets the verbosity level of the command. Allowed values are `q[uiet]`, `m[inimal]`, `n[ormal]`, `d[etailed]`, and `diag[nostic]`. The default is `normal`. +- [!INCLUDE [verbosity](../../../includes/cli-verbosity-normal.md)] -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-tool-install.md b/docs/core/tools/dotnet-tool-install.md index 40e284c518ef4..f3cce105f2d41 100644 --- a/docs/core/tools/dotnet-tool-install.md +++ b/docs/core/tools/dotnet-tool-install.md @@ -98,19 +98,17 @@ For more information, see [Install a local tool](global-tools.md#install-a-local ## Options -[!INCLUDE [allow-downgrade](../../../includes/cli-allow-downgrade.md)] +- [!INCLUDE [allow-downgrade](../../../includes/cli-allow-downgrade.md)] - **`--allow-roll-forward`** Available starting with .NET 9.0 SDK. Allow tool to use a newer version of the .NET runtime if the runtime it targets isn't installed. -- **`-a|--arch `** +- [!INCLUDE [arch](../../../includes/cli-arch.md)] - Specifies the target architecture. This is a shorthand syntax for setting the [Runtime Identifier (RID)](../../../docs/core/rid-catalog.md), where the provided value is combined with the default RID. For example, on a `win-x64` machine, specifying `--arch x86` sets the RID to `win-x86`. +- [!INCLUDE [add-source](../../../includes/cli-add-source.md)] -[!INCLUDE [add-source](../../../includes/cli-add-source.md)] - -[!INCLUDE [configfile](../../../includes/cli-configfile.md)] +- [!INCLUDE [configfile](../../../includes/cli-configfile.md)] - **`--create-manifest-if-needed`** @@ -133,9 +131,7 @@ For more information, see [Install a local tool](global-tools.md#install-a-local > [!WARNING] > Don't run tool commands from the **Downloads** folder or any shared location. The CLI walks up the directory tree to find a tool manifest, which might cause it to use a manifest you don't expect. Always run tool commands from a trusted, project-specific directory. -- **`--disable-parallel`** - - Prevent restoring multiple projects in parallel. +- [!INCLUDE [disable-parallel](../../../includes/cli-disable-parallel.md)] - **`--framework `** @@ -149,13 +145,13 @@ For more information, see [Install a local tool](global-tools.md#install-a-local Specifies the source for NuGet packages. This source replaces all NuGet package sources. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] - **`--ignore-failed-sources`** Treat package source failures as warnings. -[!INCLUDE [interactive](../../../includes/cli-interactive.md)] +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] - **`--local`** @@ -177,7 +173,7 @@ For more information, see [Install a local tool](global-tools.md#install-a-local Specifies the location to install the Global Tool. PATH can be absolute or relative. If PATH doesn't exist, the command tries to create it. Omitting both `--global` and `--tool-path` specifies a local tool installation. -[!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] - **`--version `** diff --git a/docs/core/tools/dotnet-tool-list.md b/docs/core/tools/dotnet-tool-list.md index 5fd52c0630c65..61fe044d6c695 100644 --- a/docs/core/tools/dotnet-tool-list.md +++ b/docs/core/tools/dotnet-tool-list.md @@ -48,7 +48,7 @@ The `dotnet tool list` command provides a way for you to list .NET global, tool- Lists user-wide global tools. Can't be combined with the `--tool-path` option. Omitting both `--global` and `--tool-path` lists local tools. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] - **`--local`** diff --git a/docs/core/tools/dotnet-tool-restore.md b/docs/core/tools/dotnet-tool-restore.md index 8021de36442d9..fa6836b9d8cfa 100644 --- a/docs/core/tools/dotnet-tool-restore.md +++ b/docs/core/tools/dotnet-tool-restore.md @@ -31,17 +31,15 @@ For information about where local tools are stored, see [dotnet tool install](do ## Options -[!INCLUDE [configfile](../../../includes/cli-configfile.md)] +- [!INCLUDE [configfile](../../../includes/cli-configfile.md)] -[!INCLUDE [add-source](../../../includes/cli-add-source.md)] +- [!INCLUDE [add-source](../../../includes/cli-add-source.md)] - **`--tool-manifest `** Path to the manifest file. -- **`--disable-parallel`** - - Prevent restoring multiple projects in parallel. +- [!INCLUDE [disable-parallel](../../../includes/cli-disable-parallel.md)] - **`--ignore-failed-sources`** @@ -51,11 +49,11 @@ For information about where local tools are stored, see [dotnet tool install](do Do not cache packages and http requests. -[!INCLUDE [interactive](../../../includes/cli-interactive.md)] +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] -[!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] ## Example diff --git a/docs/core/tools/dotnet-tool-run.md b/docs/core/tools/dotnet-tool-run.md index e95b2b9a0881b..fd740860e3822 100644 --- a/docs/core/tools/dotnet-tool-run.md +++ b/docs/core/tools/dotnet-tool-run.md @@ -35,7 +35,7 @@ The `dotnet tool run` command searches tool manifest files that are in scope for Available starting with .NET 9.0 SDK. Allow tool to use a newer version of the .NET runtime if the runtime it targets isn't installed. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Example diff --git a/docs/core/tools/dotnet-tool-search.md b/docs/core/tools/dotnet-tool-search.md index 07caa6c6486af..b71274542fb19 100644 --- a/docs/core/tools/dotnet-tool-search.md +++ b/docs/core/tools/dotnet-tool-search.md @@ -44,7 +44,7 @@ The command uses the [NuGet Search API](/nuget/api/search-query-service-resource Specifies the number of query results to show. Used for pagination. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-tool-uninstall.md b/docs/core/tools/dotnet-tool-uninstall.md index 62c9555630aae..79c6cf1e2d9ec 100644 --- a/docs/core/tools/dotnet-tool-uninstall.md +++ b/docs/core/tools/dotnet-tool-uninstall.md @@ -43,7 +43,7 @@ The `dotnet tool uninstall` command provides a way for you to uninstall .NET too Specifies that the tool to be removed is from a user-wide installation. Can't be combined with the `--tool-path` option. Omitting both `--global` and `--tool-path` specifies that the tool to be removed is a local tool. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] - **`--tool-path `** diff --git a/docs/core/tools/dotnet-tool-update.md b/docs/core/tools/dotnet-tool-update.md index 210ea716faf01..b1ea58e0f3dd8 100644 --- a/docs/core/tools/dotnet-tool-update.md +++ b/docs/core/tools/dotnet-tool-update.md @@ -62,19 +62,17 @@ The `dotnet tool update` command provides a way for you to update .NET tools on ## Options -[!INCLUDE [add-source](../../../includes/cli-add-source.md)] +- [!INCLUDE [add-source](../../../includes/cli-add-source.md)] - **`--all`** Update all tools. -[!INCLUDE [allow-downgrade](../../../includes/cli-allow-downgrade.md)] +- [!INCLUDE [allow-downgrade](../../../includes/cli-allow-downgrade.md)] -[!INCLUDE [configfile](../../../includes/cli-configfile.md)] +- [!INCLUDE [configfile](../../../includes/cli-configfile.md)] -- **`--disable-parallel`** - - Prevent restoring multiple projects in parallel. +- [!INCLUDE [disable-parallel](../../../includes/cli-disable-parallel.md)] - **`--framework `** @@ -84,13 +82,13 @@ The `dotnet tool update` command provides a way for you to update .NET tools on Specifies that the update is for a user-wide tool. Can't be combined with the `--tool-path` option. Omitting both `--global` and `--tool-path` specifies that the tool to be updated is a local tool. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] - **`--ignore-failed-sources`** Treat package source failures as warnings. -[!INCLUDE [interactive](../../../includes/cli-interactive.md)] +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] - **`--local`** @@ -112,7 +110,7 @@ The `dotnet tool update` command provides a way for you to update .NET tools on Specifies the location where the global tool is installed. PATH can be absolute or relative. Can't be combined with the `--global` option. Omitting both `--global` and `--tool-path` specifies that the tool to be updated is a local tool. -[!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] - **`--version `** diff --git a/docs/core/tools/dotnet-watch.md b/docs/core/tools/dotnet-watch.md index 7837de32ec8ca..341907240728f 100644 --- a/docs/core/tools/dotnet-watch.md +++ b/docs/core/tools/dotnet-watch.md @@ -63,15 +63,15 @@ As an alternative to disabling response compression, manually add the browser re ## Options -[!INCLUDE [artifacts-path](../../../includes/cli-artifacts-path.md)] +- [!INCLUDE [artifacts-path](../../../includes/cli-artifacts-path.md)] -[!INCLUDE [disable-build-servers](../../../includes/cli-disable-build-servers.md)] +- [!INCLUDE [disable-build-servers](../../../includes/cli-disable-build-servers.md)] - **`--list`** Lists all discovered files without starting the watcher. -[!INCLUDE [no-self-contained](../../../includes/cli-no-self-contained.md)] +- [!INCLUDE [no-self-contained](../../../includes/cli-no-self-contained.md)] - **`--no-hot-reload`** @@ -85,7 +85,7 @@ As an alternative to disabling response compression, manually add the browser re Specifies the path of the project file to run (folder only or including the project file name). If not specified, it defaults to the current directory. -[!INCLUDE [self-contained](../../../includes/cli-self-contained.md)] +- [!INCLUDE [self-contained](../../../includes/cli-self-contained.md)] - **`-q|--quiet`** @@ -103,7 +103,7 @@ As an alternative to disabling response compression, manually add the browser re The [double-dash option ('--')](../../standard/commandline/syntax.md#the----token) can be used to delimit `dotnet watch` options from arguments that will be passed to the child process. Its use is optional. When the double-dash option isn't used, `dotnet watch` considers the first unrecognized argument to be the beginning of arguments that it should pass into the child `dotnet` process. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Environment variables diff --git a/docs/core/tools/dotnet-workload-clean.md b/docs/core/tools/dotnet-workload-clean.md index ced1eddec136e..0d0a11868d861 100644 --- a/docs/core/tools/dotnet-workload-clean.md +++ b/docs/core/tools/dotnet-workload-clean.md @@ -31,7 +31,7 @@ For more information about the `dotnet workload` commands, see the [dotnet workl Removes and uninstalls all workload components from all SDK versions. Defaults to `false`. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-workload-config.md b/docs/core/tools/dotnet-workload-config.md index b18bb9c935dff..ba9f7a3f065fb 100644 --- a/docs/core/tools/dotnet-workload-config.md +++ b/docs/core/tools/dotnet-workload-config.md @@ -26,7 +26,7 @@ For more information about the `dotnet workload config` command, see [.NET SDK w ## Options - [!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] - **`--update-mode [|]`** diff --git a/docs/core/tools/dotnet-workload-history.md b/docs/core/tools/dotnet-workload-history.md index 1b2bea7e79091..d531d9b5b9335 100644 --- a/docs/core/tools/dotnet-workload-history.md +++ b/docs/core/tools/dotnet-workload-history.md @@ -31,7 +31,7 @@ For more information about the `dotnet workload` commands, see the [dotnet workl Removes and uninstalls all workload components from all SDK versions. Defaults to `false`. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-workload-install.md b/docs/core/tools/dotnet-workload-install.md index 9d7c94f7995eb..ad0f9dc33fbc1 100644 --- a/docs/core/tools/dotnet-workload-install.md +++ b/docs/core/tools/dotnet-workload-install.md @@ -74,29 +74,29 @@ The `dotnet workload update` command also downloads advertising manifests. The d ## Options -[!INCLUDE [config-file](../../../includes/cli-configfile.md)] +- [!INCLUDE [config-file](../../../includes/cli-configfile.md)] -[!INCLUDE [disable-parallel](../../../includes/cli-disable-parallel.md)] +- [!INCLUDE [disable-parallel](../../../includes/cli-disable-parallel.md)] -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] -[!INCLUDE [ignore-failed-sources](../../../includes/cli-ignore-failed-sources.md)] +- [!INCLUDE [ignore-failed-sources](../../../includes/cli-ignore-failed-sources.md)] -[!INCLUDE [include-previews](../../../includes/cli-include-previews.md)] +- [!INCLUDE [include-previews](../../../includes/cli-include-previews.md)] -[!INCLUDE [interactive](../../../includes/cli-interactive.md)] +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] -[!INCLUDE [no-cache](../../../includes/cli-no-cache.md)] +- [!INCLUDE [no-cache](../../../includes/cli-no-cache.md)] -[!INCLUDE [skip-manifest-update](../../../includes/cli-skip-manifest-update.md)] +- [!INCLUDE [skip-manifest-update](../../../includes/cli-skip-manifest-update.md)] -[!INCLUDE [source](../../../includes/cli-source.md)] +- [!INCLUDE [source](../../../includes/cli-source.md)] -[!INCLUDE [temp-dir](../../../includes/cli-temp-dir.md)] +- [!INCLUDE [temp-dir](../../../includes/cli-temp-dir.md)] -[!INCLUDE [verbosity](../../../includes/cli-verbosity-packages.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity-packages.md)] -[!INCLUDE [workload-version](../../../includes/cli-workload-version.md)] +- [!INCLUDE [workload-version](../../../includes/cli-workload-version.md)] ## Examples diff --git a/docs/core/tools/dotnet-workload-list.md b/docs/core/tools/dotnet-workload-list.md index 785b35f3a928c..fe2c0e35c7ee4 100644 --- a/docs/core/tools/dotnet-workload-list.md +++ b/docs/core/tools/dotnet-workload-list.md @@ -27,9 +27,9 @@ For more information about the `dotnet workload` commands, see the [dotnet workl ## Options -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] -[!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] ## Examples diff --git a/docs/core/tools/dotnet-workload-repair.md b/docs/core/tools/dotnet-workload-repair.md index bcad2034da23b..206d167e42cce 100644 --- a/docs/core/tools/dotnet-workload-repair.md +++ b/docs/core/tools/dotnet-workload-repair.md @@ -31,25 +31,25 @@ For more information about the `dotnet workload` commands, see the [dotnet workl ## Options -[!INCLUDE [config-file](../../../includes/cli-configfile.md)] +- [!INCLUDE [config-file](../../../includes/cli-configfile.md)] -[!INCLUDE [disable-parallel](../../../includes/cli-disable-parallel.md)] +- [!INCLUDE [disable-parallel](../../../includes/cli-disable-parallel.md)] -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] -[!INCLUDE [ignore-failed-sources](../../../includes/cli-ignore-failed-sources.md)] +- [!INCLUDE [ignore-failed-sources](../../../includes/cli-ignore-failed-sources.md)] -[!INCLUDE [include-previews](../../../includes/cli-include-previews.md)] +- [!INCLUDE [include-previews](../../../includes/cli-include-previews.md)] -[!INCLUDE [interactive](../../../includes/cli-interactive.md)] +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] -[!INCLUDE [no-cache](../../../includes/cli-no-cache.md)] +- [!INCLUDE [no-cache](../../../includes/cli-no-cache.md)] -[!INCLUDE [source](../../../includes/cli-source.md)] +- [!INCLUDE [source](../../../includes/cli-source.md)] -[!INCLUDE [temp-dir](../../../includes/cli-temp-dir.md)] +- [!INCLUDE [temp-dir](../../../includes/cli-temp-dir.md)] -[!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] ## Examples diff --git a/docs/core/tools/dotnet-workload-restore.md b/docs/core/tools/dotnet-workload-restore.md index d14b826a3a73f..80332c64d7efc 100644 --- a/docs/core/tools/dotnet-workload-restore.md +++ b/docs/core/tools/dotnet-workload-restore.md @@ -37,29 +37,29 @@ For more information about the `dotnet workload` commands, see the [dotnet workl ## Options -[!INCLUDE [config-file](../../../includes/cli-configfile.md)] +- [!INCLUDE [config-file](../../../includes/cli-configfile.md)] -[!INCLUDE [disable-parallel](../../../includes/cli-disable-parallel.md)] +- [!INCLUDE [disable-parallel](../../../includes/cli-disable-parallel.md)] -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] -[!INCLUDE [ignore-failed-sources](../../../includes/cli-ignore-failed-sources.md)] +- [!INCLUDE [ignore-failed-sources](../../../includes/cli-ignore-failed-sources.md)] -[!INCLUDE [include-previews](../../../includes/cli-include-previews.md)] +- [!INCLUDE [include-previews](../../../includes/cli-include-previews.md)] -[!INCLUDE [interactive](../../../includes/cli-interactive.md)] +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] -[!INCLUDE [no-cache](../../../includes/cli-no-cache.md)] +- [!INCLUDE [no-cache](../../../includes/cli-no-cache.md)] -[!INCLUDE [skip-manifest-update](../../../includes/cli-skip-manifest-update.md)] +- [!INCLUDE [skip-manifest-update](../../../includes/cli-skip-manifest-update.md)] -[!INCLUDE [source](../../../includes/cli-source.md)] +- [!INCLUDE [source](../../../includes/cli-source.md)] -[!INCLUDE [temp-dir](../../../includes/cli-temp-dir.md)] +- [!INCLUDE [temp-dir](../../../includes/cli-temp-dir.md)] -[!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] -[!INCLUDE [version](../../../includes/cli-version.md)] +- [!INCLUDE [version](../../../includes/cli-version.md)] ## Example diff --git a/docs/core/tools/dotnet-workload-search.md b/docs/core/tools/dotnet-workload-search.md index 5e89a5617524a..ecdd6ee8e4380 100644 --- a/docs/core/tools/dotnet-workload-search.md +++ b/docs/core/tools/dotnet-workload-search.md @@ -33,11 +33,11 @@ For more information about the `dotnet workload` commands, see the [dotnet workl ## Options -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] -[!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity-minimal.md)] -[!INCLUDE [workload-version](../../../includes/cli-workload-version.md)] +- [!INCLUDE [workload-version](../../../includes/cli-workload-version.md)] ## Examples diff --git a/docs/core/tools/dotnet-workload-uninstall.md b/docs/core/tools/dotnet-workload-uninstall.md index 478ec8266c9f5..82208a0ffc008 100644 --- a/docs/core/tools/dotnet-workload-uninstall.md +++ b/docs/core/tools/dotnet-workload-uninstall.md @@ -33,7 +33,7 @@ For more information about the `dotnet workload` commands, see the [dotnet workl ## Options -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] ## Examples diff --git a/docs/core/tools/dotnet-workload-update.md b/docs/core/tools/dotnet-workload-update.md index 3f35341a30726..609a9b358b71f 100644 --- a/docs/core/tools/dotnet-workload-update.md +++ b/docs/core/tools/dotnet-workload-update.md @@ -39,31 +39,31 @@ For more information about the `dotnet workload` commands, see the [dotnet workl Downloads [advertising manifests](dotnet-workload-install.md#advertising-manifests) but doesn't update any workloads. -[!INCLUDE [config-file](../../../includes/cli-configfile.md)] +- [!INCLUDE [config-file](../../../includes/cli-configfile.md)] -[!INCLUDE [disable-parallel](../../../includes/cli-disable-parallel.md)] +- [!INCLUDE [disable-parallel](../../../includes/cli-disable-parallel.md)] - **`--from-previous-sdk`** Include workloads installed with previous SDK versions in the update. -[!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](../../../includes/cli-help.md)] -[!INCLUDE [ignore-failed-sources](../../../includes/cli-ignore-failed-sources.md)] +- [!INCLUDE [ignore-failed-sources](../../../includes/cli-ignore-failed-sources.md)] -[!INCLUDE [include-previews](../../../includes/cli-include-previews.md)] +- [!INCLUDE [include-previews](../../../includes/cli-include-previews.md)] -[!INCLUDE [interactive](../../../includes/cli-interactive.md)] +- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] -[!INCLUDE [no-cache](../../../includes/cli-no-cache.md)] +- [!INCLUDE [no-cache](../../../includes/cli-no-cache.md)] -[!INCLUDE [source](../../../includes/cli-source.md)] +- [!INCLUDE [source](../../../includes/cli-source.md)] -[!INCLUDE [temp-dir](../../../includes/cli-temp-dir.md)] +- [!INCLUDE [temp-dir](../../../includes/cli-temp-dir.md)] -[!INCLUDE [verbosity](../../../includes/cli-verbosity-packages.md)] +- [!INCLUDE [verbosity](../../../includes/cli-verbosity-packages.md)] -[!INCLUDE [version](../../../includes/cli-version.md)] +- [!INCLUDE [version](../../../includes/cli-version.md)] ## Examples diff --git a/includes/cli-add-source.md b/includes/cli-add-source.md index 86fddfdd65560..bb9cd90c70322 100644 --- a/includes/cli-add-source.md +++ b/includes/cli-add-source.md @@ -2,6 +2,6 @@ ms.date: 08/04/2021 ms.topic: include --- -- **`--add-source `** +**`--add-source `** - Adds an additional NuGet package source to use during installation. Feeds are accessed in parallel, not sequentially in some order of precedence. If the same package and version is in multiple feeds, the fastest feed wins. For more information, see [What happens when a NuGet package is installed?](/nuget/concepts/package-installation-process). +Adds an additional NuGet package source to use during installation. Feeds are accessed in parallel, not sequentially in some order of precedence. If the same package and version is in multiple feeds, the fastest feed wins. For more information, see [What happens when a NuGet package is installed?](/nuget/concepts/package-installation-process). diff --git a/includes/cli-allow-downgrade.md b/includes/cli-allow-downgrade.md index 527376e866245..04a26b1cddb55 100644 --- a/includes/cli-allow-downgrade.md +++ b/includes/cli-allow-downgrade.md @@ -2,6 +2,6 @@ ms.date: 03/15/2024 ms.topic: include --- -- **`--allow-downgrade`** +**`--allow-downgrade`** - Allow package downgrade when installing or updating a .NET tool package. Suppresses the warning, "The requested version x.x.x is lower than existing version x.x.x." +Allow package downgrade when installing or updating a .NET tool package. Suppresses the warning, "The requested version x.x.x is lower than existing version x.x.x." diff --git a/includes/cli-arch-no-a.md b/includes/cli-arch-no-a.md deleted file mode 100644 index 784fa28e1fc95..0000000000000 --- a/includes/cli-arch-no-a.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -ms.date: 08/12/2021 -ms.topic: include ---- -- **`--arch `** - - Specifies the target architecture. This is a shorthand syntax for setting the [Runtime Identifier (RID)](../docs/core/rid-catalog.md), where the provided value is combined with the default RID. For example, on a `win-x64` machine, specifying `--arch x86` sets the RID to `win-x86`. If you use this option, don't use the `-r|--runtime` option. Available since .NET 6 Preview 7. diff --git a/includes/cli-arch.md b/includes/cli-arch.md index 5fbd636774510..20d90f525527b 100644 --- a/includes/cli-arch.md +++ b/includes/cli-arch.md @@ -2,6 +2,6 @@ ms.date: 08/12/2021 ms.topic: include --- -- **`-a|--arch `** +**`-a|--arch `** - Specifies the target architecture. This is a shorthand syntax for setting the [Runtime Identifier (RID)](../docs/core/rid-catalog.md), where the provided value is combined with the default RID. For example, on a `win-x64` machine, specifying `--arch x86` sets the RID to `win-x86`. If you use this option, don't use the `-r|--runtime` option. Available since .NET 6 Preview 7. +Specifies the target architecture. This is a shorthand syntax for setting the [Runtime Identifier (RID)](../docs/core/rid-catalog.md), where the provided value is combined with the default RID. For example, on a `win-x64` machine, specifying `--arch x86` sets the RID to `win-x86`. If you use this option, don't use the `-r|--runtime` option. Available since .NET 6 Preview 7. diff --git a/includes/cli-artifacts-path.md b/includes/cli-artifacts-path.md index 510199d186977..8899982f6d7e6 100644 --- a/includes/cli-artifacts-path.md +++ b/includes/cli-artifacts-path.md @@ -2,6 +2,6 @@ ms.date: 04/26/2024 ms.topic: include --- -- **`--artifacts-path `** +**`--artifacts-path `** - All build output files from the executed command will go in subfolders under the specified path, separated by project. For more information see [Artifacts Output Layout](../docs/core/sdk/artifacts-output.md). Available since .NET 8 SDK. +All build output files from the executed command will go in subfolders under the specified path, separated by project. For more information see [Artifacts Output Layout](../docs/core/sdk/artifacts-output.md). Available since .NET 8 SDK. diff --git a/includes/cli-configfile.md b/includes/cli-configfile.md index 86b94b2d09d69..5e71595ee29d8 100644 --- a/includes/cli-configfile.md +++ b/includes/cli-configfile.md @@ -2,6 +2,6 @@ ms.date: 08/04/2021 ms.topic: include --- -- **`--configfile `** +**`--configfile `** - The NuGet configuration file (*nuget.config*) to use. If specified, only the settings from this file will be used. If not specified, the hierarchy of configuration files from the current directory will be used. For more information, see [Common NuGet Configurations](/nuget/consume-packages/configuring-nuget-behavior). +The NuGet configuration file (*nuget.config*) to use. If specified, only the settings from this file will be used. If not specified, the hierarchy of configuration files from the current directory will be used. For more information, see [Common NuGet Configurations](/nuget/consume-packages/configuring-nuget-behavior). diff --git a/includes/cli-configuration-clean.md b/includes/cli-configuration-clean.md index 8a1de3bf2e757..ebe7809f7543a 100644 --- a/includes/cli-configuration-clean.md +++ b/includes/cli-configuration-clean.md @@ -2,6 +2,6 @@ ms.date: 08/04/2021 ms.topic: include --- -- **`-c|--configuration `** +**`-c|--configuration `** - Defines the build configuration. The default for most projects is `Debug`, but you can override the build configuration settings in your project. This option is only required when cleaning if you specified it during build time. +Defines the build configuration. The default for most projects is `Debug`, but you can override the build configuration settings in your project. This option is only required when cleaning if you specified it during build time. diff --git a/includes/cli-configuration-publish-pack.md b/includes/cli-configuration-publish-pack.md index 27ab9d97df767..39c169ac1d441 100644 --- a/includes/cli-configuration-publish-pack.md +++ b/includes/cli-configuration-publish-pack.md @@ -2,6 +2,6 @@ ms.date: 04/04/2024 ms.topic: include --- -- **`-c|--configuration `** +**`-c|--configuration `** - Defines the build configuration. If you're developing with the .NET 8 SDK or a later version, the command uses the `Release` configuration by default for projects whose TargetFramework is set to `net8.0` or a later version. The default build configuration is `Debug` for earlier versions of the SDK and for earlier target frameworks. You can override the default in project settings or by using this option. For more information, see ['dotnet publish' uses Release configuration](~/docs/core/compatibility/sdk/8.0/dotnet-publish-config.md) and ['dotnet pack' uses Release configuration](~/docs/core/compatibility/sdk/8.0/dotnet-pack-config.md). +Defines the build configuration. If you're developing with the .NET 8 SDK or a later version, the command uses the `Release` configuration by default for projects whose TargetFramework is set to `net8.0` or a later version. The default build configuration is `Debug` for earlier versions of the SDK and for earlier target frameworks. You can override the default in project settings or by using this option. For more information, see ['dotnet publish' uses Release configuration](~/docs/core/compatibility/sdk/8.0/dotnet-publish-config.md) and ['dotnet pack' uses Release configuration](~/docs/core/compatibility/sdk/8.0/dotnet-pack-config.md). diff --git a/includes/cli-configuration.md b/includes/cli-configuration.md index b6fb9f60d3e99..a8cdc35d9bee1 100644 --- a/includes/cli-configuration.md +++ b/includes/cli-configuration.md @@ -2,6 +2,6 @@ ms.date: 08/04/2021 ms.topic: include --- -- **`-c|--configuration `** +**`-c|--configuration `** - Defines the build configuration. The default for most projects is `Debug`, but you can override the build configuration settings in your project. +Defines the build configuration. The default for most projects is `Debug`, but you can override the build configuration settings in your project. diff --git a/includes/cli-disable-build-servers.md b/includes/cli-disable-build-servers.md index cfd168f9e8cb7..bb4fd68a3c0bd 100644 --- a/includes/cli-disable-build-servers.md +++ b/includes/cli-disable-build-servers.md @@ -2,6 +2,6 @@ ms.date: 07/20/2023 ms.topic: include --- -- **`--disable-build-servers`** +**`--disable-build-servers`** - Forces the command to ignore any persistent build servers. This option provides a consistent way to disable all use of build caching, which forces a build from scratch. A build that doesn't rely on caches is useful when the caches might be corrupted or incorrect for some reason. Available since .NET 7 SDK. +Forces the command to ignore any persistent build servers. This option provides a consistent way to disable all use of build caching, which forces a build from scratch. A build that doesn't rely on caches is useful when the caches might be corrupted or incorrect for some reason. Available since .NET 7 SDK. diff --git a/includes/cli-disable-parallel.md b/includes/cli-disable-parallel.md index e3c3b4b2805bd..7fe730437e068 100644 --- a/includes/cli-disable-parallel.md +++ b/includes/cli-disable-parallel.md @@ -2,6 +2,6 @@ ms.date: 08/12/2021 ms.topic: include --- -- **`--disable-parallel`** +**`--disable-parallel`** - Prevents restoring multiple projects in parallel. +Prevents restoring multiple projects in parallel. diff --git a/includes/cli-help.md b/includes/cli-help.md index a6df485ed0528..243a9a9221ed4 100644 --- a/includes/cli-help.md +++ b/includes/cli-help.md @@ -2,6 +2,6 @@ ms.date: 08/04/2021 ms.topic: include --- -- **`-?|-h|--help`** +**`-?|-h|--help`** - Prints out a description of how to use the command. +Prints out a description of how to use the command. diff --git a/includes/cli-ignore-failed-sources.md b/includes/cli-ignore-failed-sources.md index 8fa0525d7070e..8a0bb87d941bb 100644 --- a/includes/cli-ignore-failed-sources.md +++ b/includes/cli-ignore-failed-sources.md @@ -2,6 +2,6 @@ ms.date: 08/12/2021 ms.topic: include --- -- **`--ignore-failed-sources`** +**`--ignore-failed-sources`** - Treats package source failures as warnings. +Treats package source failures as warnings. diff --git a/includes/cli-include-previews.md b/includes/cli-include-previews.md index e52bb2b4ab951..815d2cf7bf915 100644 --- a/includes/cli-include-previews.md +++ b/includes/cli-include-previews.md @@ -2,6 +2,6 @@ ms.date: 08/12/2021 ms.topic: include --- -- **`--include-previews`** +**`--include-previews`** - Allows prerelease workload manifests. +Allows prerelease workload manifests. diff --git a/includes/cli-interactive-3-0.md b/includes/cli-interactive-3-0.md deleted file mode 100644 index 6a33b83f9eb33..0000000000000 --- a/includes/cli-interactive-3-0.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -ms.date: 08/04/2021 -ms.topic: include ---- -- **`--interactive`** - - Allows the command to stop and wait for user input or action. For example, to complete authentication. Available since .NET Core 3.0 SDK. diff --git a/includes/cli-interactive-5-0.md b/includes/cli-interactive-5-0.md deleted file mode 100644 index a2189e7d91624..0000000000000 --- a/includes/cli-interactive-5-0.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -ms.date: 08/04/2021 -ms.topic: include ---- -- **`--interactive`** - - Allows the command to stop and wait for user input or action. For example, to complete authentication. Available since .NET 5.0 SDK. diff --git a/includes/cli-interactive.md b/includes/cli-interactive.md index ae9ca355b0903..4d1451fd70c8c 100644 --- a/includes/cli-interactive.md +++ b/includes/cli-interactive.md @@ -2,6 +2,6 @@ ms.date: 08/04/2021 ms.topic: include --- -- **`--interactive`** +**`--interactive`** - Allows the command to stop and wait for user input or action. For example, to complete authentication. +Allows the command to stop and wait for user input or action. For example, to complete authentication. diff --git a/includes/cli-no-cache.md b/includes/cli-no-cache.md index be697af28f6a9..6d77bb59cd464 100644 --- a/includes/cli-no-cache.md +++ b/includes/cli-no-cache.md @@ -2,6 +2,6 @@ ms.date: 08/04/2021 ms.topic: include --- -- **`--no-cache`** +**`--no-cache`** - Prevents caching of packages and http requests. +Prevents caching of packages and http requests. diff --git a/includes/cli-no-self-contained.md b/includes/cli-no-self-contained.md index 2444880f5d7b3..4d9b3ffdc79e5 100644 --- a/includes/cli-no-self-contained.md +++ b/includes/cli-no-self-contained.md @@ -2,7 +2,6 @@ ms.date: 10/01/2025 ms.topic: include --- +**`--no-self-contained`** -- **`--no-self-contained`** - - Equivalent to `--self-contained false`. +Equivalent to `--self-contained false`. diff --git a/includes/cli-os.md b/includes/cli-os.md index 17855ac9ad742..364db606cbc6d 100644 --- a/includes/cli-os.md +++ b/includes/cli-os.md @@ -2,6 +2,6 @@ ms.date: 08/12/2021 ms.topic: include --- -- **`--os `** +**`--os `** - Specifies the target operating system (OS). This is a shorthand syntax for setting the [Runtime Identifier (RID)](../docs/core/rid-catalog.md), where the provided value is combined with the default RID. For example, on a `win-x64` machine, specifying `--os linux` sets the RID to `linux-x64`. If you use this option, don't use the `-r|--runtime` option. Available since .NET 6. +Specifies the target operating system (OS). This is a shorthand syntax for setting the [Runtime Identifier (RID)](../docs/core/rid-catalog.md), where the provided value is combined with the default RID. For example, on a `win-x64` machine, specifying `--os linux` sets the RID to `linux-x64`. If you use this option, don't use the `-r|--runtime` option. Available since .NET 6. diff --git a/includes/cli-self-contained.md b/includes/cli-self-contained.md index 7cf7803ab42d6..8e612392e1f2e 100644 --- a/includes/cli-self-contained.md +++ b/includes/cli-self-contained.md @@ -2,7 +2,6 @@ ms.date: 10/01/2025 ms.topic: include --- +**`--sc|--self-contained`** -- **`--sc|--self-contained`** - - Publish the .NET runtime with your application so the runtime doesn't need to be installed on the target machine. The default is `true`. +Publish the .NET runtime with your application so the runtime doesn't need to be installed on the target machine. The default is `true`. diff --git a/includes/cli-skip-manifest-update.md b/includes/cli-skip-manifest-update.md index 35b589638c428..4748e64e1daae 100644 --- a/includes/cli-skip-manifest-update.md +++ b/includes/cli-skip-manifest-update.md @@ -2,6 +2,6 @@ ms.date: 08/12/2021 ms.topic: include --- -- **`--skip-manifest-update`** +**`--skip-manifest-update`** - Skip updating the workload manifests. The workload manifests define what assets and versions need to be installed for each workload. +Skip updating the workload manifests. The workload manifests define what assets and versions need to be installed for each workload. diff --git a/includes/cli-source.md b/includes/cli-source.md index a05e15cce6083..e00fbe89f2cf3 100644 --- a/includes/cli-source.md +++ b/includes/cli-source.md @@ -2,6 +2,6 @@ ms.date: 08/12/2021 ms.topic: include --- -- **`-s|--source `** +**`-s|--source `** - Specifies the URI of the NuGet package source to use. This setting overrides all of the sources specified in the *nuget.config* files. Multiple sources can be provided by specifying this option multiple times. +Specifies the URI of the NuGet package source to use. This setting overrides all of the sources specified in the *nuget.config* files. Multiple sources can be provided by specifying this option multiple times. diff --git a/includes/cli-temp-dir.md b/includes/cli-temp-dir.md index 1f77b7a9ebfe4..a05ba5eee33bc 100644 --- a/includes/cli-temp-dir.md +++ b/includes/cli-temp-dir.md @@ -2,6 +2,6 @@ ms.date: 08/12/2021 ms.topic: include --- -- **`--temp-dir `** +**`--temp-dir `** - Specify the temporary directory used to download and extract NuGet packages (must be secure). +Specify the temporary directory used to download and extract NuGet packages (must be secure). diff --git a/includes/cli-tl.md b/includes/cli-tl.md index 616a01b0efb60..f0d97a00dc446 100644 --- a/includes/cli-tl.md +++ b/includes/cli-tl.md @@ -2,16 +2,16 @@ ms.date: 11/27/2023 ms.topic: include --- -- **`--tl:[auto|on|off]`** +**`--tl:[auto|on|off]`** - Specifies whether *Terminal Logger* should be used for the build output. The default is `auto`, which first verifies the environment before enabling terminal logging. The environment check verifies that the terminal is capable of using modern output features and isn't using a redirected standard output before enabling the new logger. `on` skips the environment check and enables terminal logging. `off` skips the environment check and uses the default console logger. +Specifies whether *Terminal Logger* should be used for the build output. The default is `auto`, which first verifies the environment before enabling terminal logging. The environment check verifies that the terminal is capable of using modern output features and isn't using a redirected standard output before enabling the new logger. `on` skips the environment check and enables terminal logging. `off` skips the environment check and uses the default console logger. - Terminal Logger shows you the restore phase followed by the build phase. During each phase, the currently building projects appear at the bottom of the terminal. Each project that's building outputs both the MSBuild target currently being built and the amount of time spent on that target. You can search this information to learn more about the build. When a project is finished building, a single "build completed" section is written that captures: +Terminal Logger shows you the restore phase followed by the build phase. During each phase, the currently building projects appear at the bottom of the terminal. Each project that's building outputs both the MSBuild target currently being built and the amount of time spent on that target. You can search this information to learn more about the build. When a project is finished building, a single "build completed" section is written that captures: - - The name of the built project. - - The target framework (if multi-targeted). - - The status of that build. - - The primary output of that build (which is hyperlinked). - - Any diagnostics generated for that project. +- The name of the built project. +- The target framework (if multi-targeted). +- The status of that build. +- The primary output of that build (which is hyperlinked). +- Any diagnostics generated for that project. - This option is available starting in .NET 8. +This option is available starting in .NET 8. diff --git a/includes/cli-use-current-runtime.md b/includes/cli-use-current-runtime.md index 3f101fa42abe8..8b9e6337b8395 100644 --- a/includes/cli-use-current-runtime.md +++ b/includes/cli-use-current-runtime.md @@ -2,7 +2,6 @@ ms.date: 10/01/2025 ms.topic: include --- +**`--ucr|--use-current-runtime`** -- **`--ucr|--use-current-runtime`** - - Use the current runtime as the target runtime. +Use the current runtime as the target runtime. diff --git a/includes/cli-verbosity-minimal.md b/includes/cli-verbosity-minimal.md index 0eb2e8715f954..0c5f8f8fa7a34 100644 --- a/includes/cli-verbosity-minimal.md +++ b/includes/cli-verbosity-minimal.md @@ -2,6 +2,6 @@ ms.date: 08/04/2021 ms.topic: include --- -- **`-v|--verbosity `** +**`-v|--verbosity `** - Sets the verbosity level of the command. Allowed values are `q[uiet]`, `m[inimal]`, `n[ormal]`, `d[etailed]`, and `diag[nostic]`. The default is `minimal`. For more information, see . +Sets the verbosity level of the command. Allowed values are `q[uiet]`, `m[inimal]`, `n[ormal]`, `d[etailed]`, and `diag[nostic]`. The default is `minimal`. For more information, see . diff --git a/includes/cli-verbosity-normal.md b/includes/cli-verbosity-normal.md index c84062b53ff01..f324e3f8bbba4 100644 --- a/includes/cli-verbosity-normal.md +++ b/includes/cli-verbosity-normal.md @@ -2,6 +2,6 @@ ms.date: 08/04/2021 ms.topic: include --- -- **`-v|--verbosity `** +**`-v|--verbosity `** - Sets the verbosity level of the command. Allowed values are `q[uiet]`, `m[inimal]`, `n[ormal]`, `d[etailed]`, and `diag[nostic]`. The default is `normal`. For more information, see . +Sets the verbosity level of the command. Allowed values are `q[uiet]`, `m[inimal]`, `n[ormal]`, `d[etailed]`, and `diag[nostic]`. The default is `normal`. For more information, see . diff --git a/includes/cli-verbosity-packages.md b/includes/cli-verbosity-packages.md index ed47aec11ee64..431037b200ebc 100644 --- a/includes/cli-verbosity-packages.md +++ b/includes/cli-verbosity-packages.md @@ -2,6 +2,6 @@ ms.date: 08/04/2021 ms.topic: include --- -- **`-v|--verbosity `** +**`-v|--verbosity `** - Sets the verbosity level of the command. Allowed values are `q[uiet]`, `m[inimal]`, `n[ormal]`, `d[etailed]`, and `diag[nostic]`. The default is `minimal`. If you specify `detailed` or `diagnostic` verbosity, the command displays information about the Nuget packages that it downloads. +Sets the verbosity level of the command. Allowed values are `q[uiet]`, `m[inimal]`, `n[ormal]`, `d[etailed]`, and `diag[nostic]`. The default is `minimal`. If you specify `detailed` or `diagnostic` verbosity, the command displays information about the Nuget packages that it downloads. diff --git a/includes/cli-verbosity.md b/includes/cli-verbosity.md index 74879688f3bfb..4bbcc52f0df8e 100644 --- a/includes/cli-verbosity.md +++ b/includes/cli-verbosity.md @@ -2,6 +2,6 @@ ms.date: 08/04/2021 ms.topic: include --- -- **`-v|--verbosity `** +**`-v|--verbosity `** - Sets the verbosity level of the command. Allowed values are `q[uiet]`, `m[inimal]`, `n[ormal]`, `d[etailed]`, and `diag[nostic]`. For more information, see . +Sets the verbosity level of the command. Allowed values are `q[uiet]`, `m[inimal]`, `n[ormal]`, `d[etailed]`, and `diag[nostic]`. For more information, see . diff --git a/includes/cli-version.md b/includes/cli-version.md index f942869ab1c1f..01ca1b74fe2f4 100644 --- a/includes/cli-version.md +++ b/includes/cli-version.md @@ -2,6 +2,6 @@ ms.date: 08/12/2024 ms.topic: include --- -- **`--version`** +**`--version`** - The workload set version to install or update to. If you specify the workload-set version in global.json, you can't use the `--version` option to specify the workload-set version. To make it possible to use the `--version` option in that case, run the command outside of the path containing the global.json file. Available since 8.0.400 SDK. For more information, see [.NET SDK workload sets](../docs/core/tools/dotnet-workload-sets.md). +The workload set version to install or update to. If you specify the workload-set version in global.json, you can't use the `--version` option to specify the workload-set version. To make it possible to use the `--version` option in that case, run the command outside of the path containing the global.json file. Available since 8.0.400 SDK. For more information, see [.NET SDK workload sets](../docs/core/tools/dotnet-workload-sets.md). diff --git a/includes/cli-workload-version.md b/includes/cli-workload-version.md index 50d80935c14b4..dc3882b3fa7c8 100644 --- a/includes/cli-workload-version.md +++ b/includes/cli-workload-version.md @@ -2,6 +2,6 @@ ms.date: 11/12/2025 ms.topic: include --- -- **`version `** +**`version `** - A workload version to display, or one or more workloads and their versions joined by the `@` character. Support for the `@` character is available since 9.0.200 SDK. +A workload version to display, or one or more workloads and their versions joined by the `@` character. Support for the `@` character is available since 9.0.200 SDK.