diff --git a/docs/core/tools/dotnet-build-server.md b/docs/core/tools/dotnet-build-server.md index c45c093227e20..b8a39edaf46e1 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 25c37a8e6ad31..6d35a9bb5a48e 100644 --- a/docs/core/tools/dotnet-build.md +++ b/docs/core/tools/dotnet-build.md @@ -44,7 +44,7 @@ For executable projects targeting .NET Core 3.0 and later, library dependencies Building requires the *project.assets.json* file, which lists the dependencies of your application. The file is created when [`dotnet restore`](dotnet-restore.md) is executed. Without the assets file in place, the tooling can't resolve reference assemblies, which results in errors. -[!INCLUDE[dotnet restore note + options](~/includes/dotnet-restore-note-options.md)] +[!INCLUDE[dotnet restore note + options](includes/dotnet-restore-note-options.md)] ### Executable or library output @@ -69,17 +69,17 @@ In addition to its options, the `dotnet build` command accepts MSBuild options, Running `dotnet build` is equivalent to running `dotnet msbuild -restore`; however, the default verbosity of the output is different. -[!INCLUDE [cli-advertising-manifests](../../../includes/cli-advertising-manifests.md)] +[!INCLUDE [cli-advertising-manifests](includes/cli-advertising-manifests.md)] ## Arguments -[!INCLUDE [arguments-project-solution-file](../../../includes/cli-arguments-project-solution-file.md)] +[!INCLUDE [arguments-project-solution-file](includes/cli-arguments-project-solution-file.md)] ## 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)] - **`-bl|--binaryLogger:`** @@ -94,9 +94,9 @@ Running `dotnet build` is equivalent to running `dotnet msbuild -restore`; howev dotnet build -bl:build-log.binlog ``` -- [!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 `** @@ -106,7 +106,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.md)] +- [!INCLUDE [interactive](includes/cli-interactive.md)] - **`--no-dependencies`** @@ -124,7 +124,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 `** @@ -134,7 +134,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:=`** @@ -149,23 +149,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 2ab0350b30f9a..9dfdd42a1c940 100644 --- a/docs/core/tools/dotnet-clean.md +++ b/docs/core/tools/dotnet-clean.md @@ -30,21 +30,21 @@ The `dotnet clean` command cleans the output of the previous build. It's impleme ## Arguments -[!INCLUDE [arguments-project-solution-file](../../../includes/cli-arguments-project-solution-file.md)] +[!INCLUDE [arguments-project-solution-file](includes/cli-arguments-project-solution-file.md)] ## 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.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 3ad502e958e21..2d504ebb8bbf6 100644 --- a/docs/core/tools/dotnet-format.md +++ b/docs/core/tools/dotnet-format.md @@ -85,9 +85,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 c4e5f103aa20d..95fa32eecb052 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 db8b413ae61ba..864e32cdbdfd9 100644 --- a/docs/core/tools/dotnet-new-details.md +++ b/docs/core/tools/dotnet-new-details.md @@ -36,13 +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. -- [!INCLUDE [help](../../../includes/cli-help.md)] +- [!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 c2d3699e37d72..8937bb1e1250a 100644 --- a/docs/core/tools/dotnet-new-install.md +++ b/docs/core/tools/dotnet-new-install.md @@ -32,7 +32,7 @@ For example, if you install the template package using `dotnet new --install` in Starting with .NET SDK 6.0.100, installed template packages are available in later .NET SDK versions installed on your machine. A template package installed in .NET SDK 6.0.100 will also be available in .NET SDK 6.0.101, .NET SDK 6.0.200, and so on. However, these template packages won't be available in .NET SDK versions prior to .NET SDK 6.0.100. To use a template package installed in .NET SDK 6.0.100 or later in earlier .NET SDK versions, you need to install it using `dotnet new install` in that .NET SDK version. > [!NOTE] -> [!INCLUDE [new syntax](../../../includes/dotnet-new-7-0-syntax.md)] +> [!INCLUDE [new syntax](includes/dotnet-new-7-0-syntax.md)] > > Examples of old syntax: > @@ -70,11 +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. -- [!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](includes/cli-help.md)] -- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] +- [!INCLUDE [interactive](includes/cli-interactive.md)] -- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] +- [!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 ced73f9a88a3d..37fd65754dabb 100644 --- a/docs/core/tools/dotnet-new-list.md +++ b/docs/core/tools/dotnet-new-list.md @@ -27,7 +27,7 @@ The `dotnet new list` command lists available templates to use with `dotnet new` Starting with .NET SDK 7.0.100, the `list` command might not show all the templates installed on the machine. It takes the result of template constraints into account, and the templates that can't be used won't be shown. To force show all the templates, use the `--ignore-constraints` option. > [!NOTE] -> [!INCLUDE [new syntax](../../../includes/dotnet-new-7-0-syntax.md)] +> [!INCLUDE [new syntax](includes/dotnet-new-7-0-syntax.md)] > > Examples of the old syntax: > @@ -75,7 +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. -- [!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](includes/cli-help.md)] - **`--ignore-constraints`** @@ -104,7 +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`. -- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] +- [!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 af207f64ca65b..e274fa888ee2f 100644 --- a/docs/core/tools/dotnet-new-search.md +++ b/docs/core/tools/dotnet-new-search.md @@ -27,7 +27,7 @@ dotnet new search [] [--author ] [-lang|--language is specified, searches for templates containing the specified name. > [!NOTE] -> [!INCLUDE [new syntax](../../../includes/dotnet-new-7-0-syntax.md)] +> [!INCLUDE [new syntax](includes/dotnet-new-7-0-syntax.md)] > > Examples of the old syntax: > @@ -72,7 +72,7 @@ The `dotnet new search` command searches for templates supported by `dotnet new` Enables diagnostic output. Available since .NET SDK 7.0.100. -- [!INCLUDE [help](../../../includes/cli-help.md)] +- [!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 c526446a43164..d998fad003eb8 100644 --- a/docs/core/tools/dotnet-new-uninstall.md +++ b/docs/core/tools/dotnet-new-uninstall.md @@ -23,7 +23,7 @@ dotnet new uninstall The `dotnet new uninstall` command uninstalls a template package at the `PATH` or `NUGET_ID` provided. When the `` value isn't specified, all currently installed template packages and their associated templates are displayed. When specifying `NUGET_ID`, don't include the version number. > [!NOTE] -> [!INCLUDE [new syntax](../../../includes/dotnet-new-7-0-syntax.md)] +> [!INCLUDE [new syntax](includes/dotnet-new-7-0-syntax.md)] > > Examples of the old syntax: > @@ -51,9 +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. -- [!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](includes/cli-help.md)] -- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] +- [!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 5da571f502000..e2ddfe9c31cfd 100644 --- a/docs/core/tools/dotnet-new-update.md +++ b/docs/core/tools/dotnet-new-update.md @@ -27,7 +27,7 @@ The `dotnet new update` command updates installed template packages. The `dotnet new update` command with `--check-only` option checks for available updates for installed template packages without applying them. > [!NOTE] -> [!INCLUDE [new syntax](../../../includes/dotnet-new-7-0-syntax.md)] +> [!INCLUDE [new syntax](includes/dotnet-new-7-0-syntax.md)] > > Examples of the old syntax: > @@ -47,7 +47,7 @@ The `dotnet new update` command with `--check-only` option checks for available ## Options -- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] +- [!INCLUDE [interactive](includes/cli-interactive.md)] - **`--add-source|nuget-source `** @@ -62,9 +62,9 @@ The `dotnet new update` command with `--check-only` option checks for available Enables diagnostic output. Available since .NET SDK 7.0.100. -- [!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](includes/cli-help.md)] -- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] +- [!INCLUDE [verbosity](includes/cli-verbosity.md)] ## Examples diff --git a/docs/core/tools/dotnet-new.md b/docs/core/tools/dotnet-new.md index 84751d438480a..8110995d6feda 100644 --- a/docs/core/tools/dotnet-new.md +++ b/docs/core/tools/dotnet-new.md @@ -30,7 +30,7 @@ The `dotnet new` command creates a .NET project or other artifacts based on a te The command calls the [template engine](https://github.com/dotnet/templating) to create the artifacts on disk based on the specified template and options. > [!NOTE] -> [!INCLUDE [new syntax](../../../includes/dotnet-new-7-0-syntax.md)] +> [!INCLUDE [new syntax](includes/dotnet-new-7-0-syntax.md)] ### Tab completion @@ -63,7 +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. -- [!INCLUDE [help](../../../includes/cli-help.md)] +- [!INCLUDE [help](includes/cli-help.md)] - **`-lang|--language {C#|F#|VB}`** @@ -98,7 +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. -- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] +- [!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 773ec66e50d79..f3e10724e91d7 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 6f4a09f4865f9..5cb0957714063 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 6977fbd18a0e4..7f1bf5a4b3fc5 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 f6ef6f0e60ac3..f77e21b66db9d 100644 --- a/docs/core/tools/dotnet-nuget-config-set.md +++ b/docs/core/tools/dotnet-nuget-config-set.md @@ -36,9 +36,9 @@ The `dotnet nuget config set` sets the values for NuGet configuration settings t ## 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)] ## Examples diff --git a/docs/core/tools/dotnet-nuget-config-unset.md b/docs/core/tools/dotnet-nuget-config-unset.md index 1c5c16791588e..f19853648128c 100644 --- a/docs/core/tools/dotnet-nuget-config-unset.md +++ b/docs/core/tools/dotnet-nuget-config-unset.md @@ -32,9 +32,9 @@ The `dotnet nuget config unset` unsets the values for NuGet configuration settin ## 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)] ## Examples diff --git a/docs/core/tools/dotnet-nuget-delete.md b/docs/core/tools/dotnet-nuget-delete.md index 4058a07414890..ad145be4913c3 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.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 e8ef2e8384e68..d921c7a9c3956 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 ae6bb4ac0a35b..36d7b7a1d921b 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 2b31d815db8aa..7abe55d20e9b8 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 da68e7262629e..57a1227f56bda 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 8a18595decfc2..430ba28235051 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.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 0d297f2c23c7a..161544974d91d 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 0c21dd7c39cbc..22b9fefcca9d4 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 dbae8176fa221..9aff2df7e0131 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 779a3d03d0fe8..a851c854e36d2 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 5a2ae170c7f66..c2c1a5797b3cf 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 15ff0e860e6e3..8e5560e40f34d 100644 --- a/docs/core/tools/dotnet-pack.md +++ b/docs/core/tools/dotnet-pack.md @@ -48,9 +48,9 @@ You can provide MSBuild properties to the `dotnet pack` command for the packing ### Implicit restore -[!INCLUDE[dotnet restore note + options](~/includes/dotnet-restore-note-options.md)] +[!INCLUDE[dotnet restore note + options](includes/dotnet-restore-note-options.md)] -[!INCLUDE [cli-advertising-manifests](../../../includes/cli-advertising-manifests.md)] +[!INCLUDE [cli-advertising-manifests](includes/cli-advertising-manifests.md)] ## Arguments @@ -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 5b5dfac8801de..dc0b5a6288ab7 100644 --- a/docs/core/tools/dotnet-package-add.md +++ b/docs/core/tools/dotnet-package-add.md @@ -124,7 +124,7 @@ Scenario 4: `` does not exist in the project file, `` does not exist in the project file, ``** @@ -66,9 +66,9 @@ By default, the command downloads only the packages you specify (no transitive d Specifies the NuGet package source to use. -* [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] +* [!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 6fa5190a77e8a..d5523be6fc21a 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.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 b0cef14e0fa9f..3d5c82f8b1dfc 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 29ea29c931ea1..afb7d95cf0bf8 100644 --- a/docs/core/tools/dotnet-package-search.md +++ b/docs/core/tools/dotnet-package-search.md @@ -34,7 +34,7 @@ The `dotnet package search` command searches for a NuGet package. ## Options -- [!INCLUDE [configfile](../../../includes/cli-configfile.md)] +- [!INCLUDE [configfile](includes/cli-configfile.md)] - **`--exact-match`** @@ -45,7 +45,7 @@ The `dotnet package search` command searches for a NuGet package. The format options are `table` and `json`. The default is `table`. -- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] +- [!INCLUDE [interactive](includes/cli-interactive.md)] - **`--prerelease`** @@ -63,9 +63,9 @@ The `dotnet package search` command searches for a NuGet package. The number of results to return. The default value is 20. -- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] +- [!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 08524393dcdcc..b011c37e2a454 100644 --- a/docs/core/tools/dotnet-package-update.md +++ b/docs/core/tools/dotnet-package-update.md @@ -49,7 +49,7 @@ On Windows Command Prompt and PowerShell, you will need to set the environment v ## Options -- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] +- [!INCLUDE [interactive](includes/cli-interactive.md)] - **`--project `** @@ -57,14 +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. -- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] +- [!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-project-convert.md b/docs/core/tools/dotnet-project-convert.md index 65ce1d147e93d..05185c278661f 100644 --- a/docs/core/tools/dotnet-project-convert.md +++ b/docs/core/tools/dotnet-project-convert.md @@ -56,13 +56,13 @@ The command performs the following operations: Forces conversion even if there are malformed directives. By default, the command fails if it encounters directives that cannot be properly parsed or converted. -- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] +- [!INCLUDE [interactive](includes/cli-interactive.md)] - **`-o|--output `** Specifies the output directory for the converted project. If not specified, a directory is created with the same name as the input file (without extension) in the current directory. -- [!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 87566e6b4261a..f3527cf95946c 100644 --- a/docs/core/tools/dotnet-publish.md +++ b/docs/core/tools/dotnet-publish.md @@ -43,7 +43,7 @@ The `dotnet publish` command's output is ready for deployment to a hosting syste ### Implicit restore -[!INCLUDE[dotnet restore note](../../../includes/dotnet-restore-note.md)] +[!INCLUDE[dotnet restore note](~/includes/dotnet-restore-note.md)] ### MSBuild @@ -111,21 +111,21 @@ For more information, see the following resources: - [Visual Studio publish profiles (.pubxml) for ASP.NET Core app deployment](/aspnet/core/host-and-deploy/visual-studio-publish-profiles) - [dotnet msbuild](dotnet-msbuild.md) -[!INCLUDE [cli-advertising-manifests](../../../includes/cli-advertising-manifests.md)] +[!INCLUDE [cli-advertising-manifests](includes/cli-advertising-manifests.md)] ## Arguments -[!INCLUDE [arguments-project-solution-file](../../../includes/cli-arguments-project-solution-file.md)] +[!INCLUDE [arguments-project-solution-file](includes/cli-arguments-project-solution-file.md)] ## 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,9 +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)] +- [!INCLUDE [self-contained](includes/cli-self-contained.md)] - **`-p|--property:=`** @@ -192,7 +192,7 @@ For more information, see the following resources: --property:= --property:= ``` -- [!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 f89a809d28b8c..298b7c49a9d0f 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.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 d20cf32296f40..b04341cac1884 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 79620c78ec609..37763cdf83ca6 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 346828175447d..00f8f063207f5 100644 --- a/docs/core/tools/dotnet-restore.md +++ b/docs/core/tools/dotnet-restore.md @@ -83,19 +83,19 @@ There are three specific settings that `dotnet restore` ignores: Support for cross-platform package signature verification was added in the .NET 5.0.100 SDK. -[!INCLUDE [cli-advertising-manifests](../../../includes/cli-advertising-manifests.md)] +[!INCLUDE [cli-advertising-manifests](includes/cli-advertising-manifests.md)] ## Arguments -[!INCLUDE [arguments-project-solution-file](../../../includes/cli-arguments-project-solution-file.md)] +[!INCLUDE [arguments-project-solution-file](includes/cli-arguments-project-solution-file.md)] ## 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 2036b6a11a438..63d1b238003d7 100644 --- a/docs/core/tools/dotnet-run.md +++ b/docs/core/tools/dotnet-run.md @@ -49,9 +49,9 @@ To run the application, the `dotnet run` command resolves the dependencies of th ### Implicit restore -[!INCLUDE[dotnet restore note + options](~/includes/dotnet-restore-note-options.md)] +[!INCLUDE[dotnet restore note + options](includes/dotnet-restore-note-options.md)] -[!INCLUDE [cli-advertising-manifests](../../../includes/cli-advertising-manifests.md)] +[!INCLUDE [cli-advertising-manifests](includes/cli-advertising-manifests.md)] ## Arguments @@ -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.md)] +- [!INCLUDE [interactive](includes/cli-interactive.md)] - **`--launch-profile `** @@ -135,9 +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. -- [!INCLUDE [no-self-contained](../../../includes/cli-no-self-contained.md)] +- [!INCLUDE [no-self-contained](includes/cli-no-self-contained.md)] -- [!INCLUDE [os](../../../includes/cli-os.md)] +- [!INCLUDE [os](includes/cli-os.md)] - **`--project `** @@ -166,13 +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). -- [!INCLUDE [self-contained](../../../includes/cli-self-contained.md)] +- [!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 0d78be5268b90..08808ed622e35 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 d2924f6f0293d..afdd9b06dbd0c 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 99dd38373e441..74a988725b682 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 afc075defa5e5..b3b4c1c307123 100644 --- a/docs/core/tools/dotnet-test.md +++ b/docs/core/tools/dotnet-test.md @@ -102,7 +102,7 @@ Where `Microsoft.NET.Test.Sdk` is the test host, `xunit` is the test framework. [!INCLUDE[dotnet restore note](~/includes/dotnet-restore-note.md)] -[!INCLUDE [cli-advertising-manifests](../../../includes/cli-advertising-manifests.md)] +[!INCLUDE [cli-advertising-manifests](includes/cli-advertising-manifests.md)] #### Arguments @@ -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](../../../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)] - **`--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.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. The default is . -- [!INCLUDE [arch](../../../includes/cli-arch.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,7 +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. -- [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)] +- [!INCLUDE [verbosity](includes/cli-verbosity.md)] - **`--no-build`** @@ -552,7 +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). -- [!INCLUDE [help](../../../includes/cli-help.md)] +- [!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 67de71401474a..173958aa876d6 100644 --- a/docs/core/tools/dotnet-tool-exec.md +++ b/docs/core/tools/dotnet-tool-exec.md @@ -63,15 +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). -- [!INCLUDE [configfile](../../../includes/cli-configfile.md)] +- [!INCLUDE [configfile](includes/cli-configfile.md)] -- [!INCLUDE [disable-parallel](../../../includes/cli-disable-parallel.md)] +- [!INCLUDE [disable-parallel](includes/cli-disable-parallel.md)] - **`--ignore-failed-sources`** Treats package source failures as warnings. -- [!INCLUDE [interactive](../../../includes/cli-interactive.md)] +- [!INCLUDE [interactive](includes/cli-interactive.md)] - **`--no-http-cache`** @@ -81,11 +81,11 @@ This command also exists in two other forms for easier use Allows prerelease packages to be selected when resolving the version to install. -- [!INCLUDE [source](../../../includes/cli-tool-source.md)] +- [!INCLUDE [source](includes/cli-tool-source.md)] -- [!INCLUDE [verbosity](../../../includes/cli-verbosity-normal.md)] +- [!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 9995f1ee9d111..a71943fccb553 100644 --- a/docs/core/tools/dotnet-tool-install.md +++ b/docs/core/tools/dotnet-tool-install.md @@ -98,17 +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. -- [!INCLUDE [arch](../../../includes/cli-arch.md)] +- [!INCLUDE [arch](includes/cli-arch.md)] -- [!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`** @@ -131,7 +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. -- [!INCLUDE [disable-parallel](../../../includes/cli-disable-parallel.md)] +- [!INCLUDE [disable-parallel](includes/cli-disable-parallel.md)] - **`--framework `** @@ -141,15 +141,15 @@ For more information, see [Install a local tool](global-tools.md#install-a-local Specifies that the installation is user wide. Can't be combined with the `--tool-path` option. Omitting both `--global` and `--tool-path` specifies a local tool installation. -- [!INCLUDE [source](../../../includes/cli-tool-source.md)] +- [!INCLUDE [source](includes/cli-tool-source.md)] -- [!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`** @@ -171,7 +171,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 61fe044d6c695..73467b820f69b 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 fa6836b9d8cfa..a7164cb91ec9f 100644 --- a/docs/core/tools/dotnet-tool-restore.md +++ b/docs/core/tools/dotnet-tool-restore.md @@ -31,15 +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. -- [!INCLUDE [disable-parallel](../../../includes/cli-disable-parallel.md)] +- [!INCLUDE [disable-parallel](includes/cli-disable-parallel.md)] - **`--ignore-failed-sources`** @@ -49,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 fd740860e3822..4a65ce4047af8 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 b71274542fb19..1598eccc5e0be 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 79c6cf1e2d9ec..83f8a09ce67be 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 3c92ef3f08ad7..1cac6c6927443 100644 --- a/docs/core/tools/dotnet-tool-update.md +++ b/docs/core/tools/dotnet-tool-update.md @@ -62,17 +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)] -- [!INCLUDE [disable-parallel](../../../includes/cli-disable-parallel.md)] +- [!INCLUDE [disable-parallel](includes/cli-disable-parallel.md)] - **`--framework `** @@ -82,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`** @@ -102,7 +102,7 @@ The `dotnet tool update` command provides a way for you to update .NET tools on Include prerelease versions. -- [!INCLUDE [source](../../../includes/cli-tool-source.md)] +- [!INCLUDE [source](includes/cli-tool-source.md)] - **`--tool-manifest `** @@ -112,7 +112,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 351ba4f8f8b1e..012d5224571d2 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 0d0a11868d861..7d26019cb90b9 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 ba9f7a3f065fb..069fea8acab07 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 d531d9b5b9335..22ad9d85dc81a 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 ad0f9dc33fbc1..6d37254fa5c11 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 fe2c0e35c7ee4..2784768185495 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 206d167e42cce..1415891dfa4bb 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 80332c64d7efc..e973a7638b870 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 ecdd6ee8e4380..860ca18b86efb 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 82208a0ffc008..d0edf718eeb6c 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 609a9b358b71f..8356cd4d93ab6 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/docs/core/tools/elevated-access.md b/docs/core/tools/elevated-access.md index 758088359ccbf..28116fb674a76 100644 --- a/docs/core/tools/elevated-access.md +++ b/docs/core/tools/elevated-access.md @@ -68,11 +68,11 @@ dotnet tool uninstall PACKAGEID --tool-path "%ProgramFiles%\dotnet-tools" # [Linux](#tab/linux) -[!INCLUDE [elevated-access-unix](../../../includes/elevated-access-unix.md)] +[!INCLUDE [elevated-access-unix](includes/elevated-access-unix.md)] # [macOS](#tab/macos) -[!INCLUDE [elevated-access-unix](../../../includes/elevated-access-unix.md)] +[!INCLUDE [elevated-access-unix](includes/elevated-access-unix.md)] --- diff --git a/docs/core/tools/global-tools-how-to-use.md b/docs/core/tools/global-tools-how-to-use.md index 09f190d516734..f1f45fc4cbf00 100644 --- a/docs/core/tools/global-tools-how-to-use.md +++ b/docs/core/tools/global-tools-how-to-use.md @@ -49,7 +49,7 @@ If you prefer permanent installation for frequent use: Tool 'microsoft.botsay' (version '1.0.0') was successfully installed. ``` - [!INCLUDE[](~/includes/dotnet-tool-install-arch-options.md)] + [!INCLUDE[](includes/dotnet-tool-install-arch-options.md)] 1. Invoke the tool: diff --git a/docs/core/tools/global-tools.md b/docs/core/tools/global-tools.md index 1000627d9b92b..e390c82616767 100644 --- a/docs/core/tools/global-tools.md +++ b/docs/core/tools/global-tools.md @@ -62,7 +62,7 @@ You can invoke the tool using the following command: dotnetsay Tool 'dotnetsay' (version '2.1.4') was successfully installed. ``` -[!INCLUDE[](~/includes/dotnet-tool-install-arch-options.md)] +[!INCLUDE[](includes/dotnet-tool-install-arch-options.md)] The default location for a tool's binaries depends on the operating system: diff --git a/includes/cli-add-source.md b/docs/core/tools/includes/cli-add-source.md similarity index 100% rename from includes/cli-add-source.md rename to docs/core/tools/includes/cli-add-source.md diff --git a/includes/cli-advertising-manifests.md b/docs/core/tools/includes/cli-advertising-manifests.md similarity index 83% rename from includes/cli-advertising-manifests.md rename to docs/core/tools/includes/cli-advertising-manifests.md index a229b7e6ab870..9c8c465f02edf 100644 --- a/includes/cli-advertising-manifests.md +++ b/docs/core/tools/includes/cli-advertising-manifests.md @@ -4,4 +4,4 @@ ms.topic: include --- ### Workload manifest downloads -When you run this command, it initiates an asynchronous background download of advertising manifests for workloads. If the download is still running when this command finishes, the download is stopped. For more information, see [Advertising manifests](../docs/core/tools/dotnet-workload-install.md#advertising-manifests). +When you run this command, it initiates an asynchronous background download of advertising manifests for workloads. If the download is still running when this command finishes, the download is stopped. For more information, see [Advertising manifests](../dotnet-workload-install.md#advertising-manifests). diff --git a/includes/cli-allow-downgrade.md b/docs/core/tools/includes/cli-allow-downgrade.md similarity index 100% rename from includes/cli-allow-downgrade.md rename to docs/core/tools/includes/cli-allow-downgrade.md diff --git a/docs/core/tools/includes/cli-arch.md b/docs/core/tools/includes/cli-arch.md new file mode 100644 index 0000000000000..53602225a32e3 --- /dev/null +++ b/docs/core/tools/includes/cli-arch.md @@ -0,0 +1,7 @@ +--- +ms.date: 08/12/2021 +ms.topic: include +--- +**`-a|--arch `** + +Specifies the target architecture. This is a shorthand syntax for setting the [Runtime Identifier (RID)](../../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-arguments-project-solution-file.md b/docs/core/tools/includes/cli-arguments-project-solution-file.md similarity index 100% rename from includes/cli-arguments-project-solution-file.md rename to docs/core/tools/includes/cli-arguments-project-solution-file.md diff --git a/includes/cli-artifacts-path.md b/docs/core/tools/includes/cli-artifacts-path.md similarity index 66% rename from includes/cli-artifacts-path.md rename to docs/core/tools/includes/cli-artifacts-path.md index 8899982f6d7e6..3464c78ba7f47 100644 --- a/includes/cli-artifacts-path.md +++ b/docs/core/tools/includes/cli-artifacts-path.md @@ -4,4 +4,4 @@ ms.topic: include --- **`--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](../../sdk/artifacts-output.md). Available since .NET 8 SDK. diff --git a/includes/cli-configfile.md b/docs/core/tools/includes/cli-configfile.md similarity index 100% rename from includes/cli-configfile.md rename to docs/core/tools/includes/cli-configfile.md diff --git a/includes/cli-configuration-clean.md b/docs/core/tools/includes/cli-configuration-clean.md similarity index 100% rename from includes/cli-configuration-clean.md rename to docs/core/tools/includes/cli-configuration-clean.md diff --git a/includes/cli-configuration-publish-pack.md b/docs/core/tools/includes/cli-configuration-publish-pack.md similarity index 100% rename from includes/cli-configuration-publish-pack.md rename to docs/core/tools/includes/cli-configuration-publish-pack.md diff --git a/includes/cli-configuration.md b/docs/core/tools/includes/cli-configuration.md similarity index 100% rename from includes/cli-configuration.md rename to docs/core/tools/includes/cli-configuration.md diff --git a/includes/cli-disable-build-servers.md b/docs/core/tools/includes/cli-disable-build-servers.md similarity index 100% rename from includes/cli-disable-build-servers.md rename to docs/core/tools/includes/cli-disable-build-servers.md diff --git a/includes/cli-disable-parallel.md b/docs/core/tools/includes/cli-disable-parallel.md similarity index 100% rename from includes/cli-disable-parallel.md rename to docs/core/tools/includes/cli-disable-parallel.md diff --git a/includes/cli-help.md b/docs/core/tools/includes/cli-help.md similarity index 100% rename from includes/cli-help.md rename to docs/core/tools/includes/cli-help.md diff --git a/includes/cli-ignore-failed-sources.md b/docs/core/tools/includes/cli-ignore-failed-sources.md similarity index 100% rename from includes/cli-ignore-failed-sources.md rename to docs/core/tools/includes/cli-ignore-failed-sources.md diff --git a/includes/cli-include-previews.md b/docs/core/tools/includes/cli-include-previews.md similarity index 100% rename from includes/cli-include-previews.md rename to docs/core/tools/includes/cli-include-previews.md diff --git a/includes/cli-interactive.md b/docs/core/tools/includes/cli-interactive.md similarity index 100% rename from includes/cli-interactive.md rename to docs/core/tools/includes/cli-interactive.md diff --git a/includes/cli-no-cache.md b/docs/core/tools/includes/cli-no-cache.md similarity index 100% rename from includes/cli-no-cache.md rename to docs/core/tools/includes/cli-no-cache.md diff --git a/includes/cli-no-self-contained.md b/docs/core/tools/includes/cli-no-self-contained.md similarity index 100% rename from includes/cli-no-self-contained.md rename to docs/core/tools/includes/cli-no-self-contained.md diff --git a/docs/core/tools/includes/cli-os.md b/docs/core/tools/includes/cli-os.md new file mode 100644 index 0000000000000..7166a3a7809c0 --- /dev/null +++ b/docs/core/tools/includes/cli-os.md @@ -0,0 +1,7 @@ +--- +ms.date: 08/12/2021 +ms.topic: include +--- +**`--os `** + +Specifies the target operating system (OS). This is a shorthand syntax for setting the [Runtime Identifier (RID)](../../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/docs/core/tools/includes/cli-self-contained.md similarity index 100% rename from includes/cli-self-contained.md rename to docs/core/tools/includes/cli-self-contained.md diff --git a/includes/cli-skip-manifest-update.md b/docs/core/tools/includes/cli-skip-manifest-update.md similarity index 100% rename from includes/cli-skip-manifest-update.md rename to docs/core/tools/includes/cli-skip-manifest-update.md diff --git a/includes/cli-source.md b/docs/core/tools/includes/cli-source.md similarity index 100% rename from includes/cli-source.md rename to docs/core/tools/includes/cli-source.md diff --git a/includes/cli-temp-dir.md b/docs/core/tools/includes/cli-temp-dir.md similarity index 100% rename from includes/cli-temp-dir.md rename to docs/core/tools/includes/cli-temp-dir.md diff --git a/includes/cli-tl.md b/docs/core/tools/includes/cli-tl.md similarity index 100% rename from includes/cli-tl.md rename to docs/core/tools/includes/cli-tl.md diff --git a/includes/cli-tool-source.md b/docs/core/tools/includes/cli-tool-source.md similarity index 100% rename from includes/cli-tool-source.md rename to docs/core/tools/includes/cli-tool-source.md diff --git a/includes/cli-use-current-runtime.md b/docs/core/tools/includes/cli-use-current-runtime.md similarity index 100% rename from includes/cli-use-current-runtime.md rename to docs/core/tools/includes/cli-use-current-runtime.md diff --git a/includes/cli-verbosity-minimal.md b/docs/core/tools/includes/cli-verbosity-minimal.md similarity index 100% rename from includes/cli-verbosity-minimal.md rename to docs/core/tools/includes/cli-verbosity-minimal.md diff --git a/includes/cli-verbosity-normal.md b/docs/core/tools/includes/cli-verbosity-normal.md similarity index 100% rename from includes/cli-verbosity-normal.md rename to docs/core/tools/includes/cli-verbosity-normal.md diff --git a/includes/cli-verbosity-packages.md b/docs/core/tools/includes/cli-verbosity-packages.md similarity index 100% rename from includes/cli-verbosity-packages.md rename to docs/core/tools/includes/cli-verbosity-packages.md diff --git a/includes/cli-verbosity.md b/docs/core/tools/includes/cli-verbosity.md similarity index 100% rename from includes/cli-verbosity.md rename to docs/core/tools/includes/cli-verbosity.md diff --git a/includes/cli-version.md b/docs/core/tools/includes/cli-version.md similarity index 89% rename from includes/cli-version.md rename to docs/core/tools/includes/cli-version.md index 01ca1b74fe2f4..1e33b45d914ce 100644 --- a/includes/cli-version.md +++ b/docs/core/tools/includes/cli-version.md @@ -4,4 +4,4 @@ ms.topic: include --- **`--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](../dotnet-workload-sets.md). diff --git a/includes/cli-workload-version.md b/docs/core/tools/includes/cli-workload-version.md similarity index 100% rename from includes/cli-workload-version.md rename to docs/core/tools/includes/cli-workload-version.md diff --git a/includes/dotnet-new-7-0-syntax.md b/docs/core/tools/includes/dotnet-new-7-0-syntax.md similarity index 94% rename from includes/dotnet-new-7-0-syntax.md rename to docs/core/tools/includes/dotnet-new-7-0-syntax.md index a05f9b65f7c78..63d1fabef92e1 100644 --- a/includes/dotnet-new-7-0-syntax.md +++ b/docs/core/tools/includes/dotnet-new-7-0-syntax.md @@ -15,4 +15,4 @@ Other options that were available before are still available to use with their r Separate help for each subcommand is available via the `-h` or `--help` option: `dotnet new --help` lists all supported options for the subcommand. Additionally, tab completion is now available for `dotnet new`. It supports completion for installed template names and for the options a selected template provides. -To activate tab completion for the .NET SDK, see [Enable tab completion](../docs/core/tools/enable-tab-autocomplete.md). +To activate tab completion for the .NET SDK, see [Enable tab completion](../enable-tab-autocomplete.md). diff --git a/includes/dotnet-restore-note-options.md b/docs/core/tools/includes/dotnet-restore-note-options.md similarity index 58% rename from includes/dotnet-restore-note-options.md rename to docs/core/tools/includes/dotnet-restore-note-options.md index 3e3c2f1c101a2..992daf4d6b33f 100644 --- a/includes/dotnet-restore-note-options.md +++ b/docs/core/tools/includes/dotnet-restore-note-options.md @@ -1,7 +1,7 @@ -You don't have to run [`dotnet restore`](~/docs/core/tools/dotnet-restore.md) because it's run implicitly by all commands that require a restore to occur, such as `dotnet new`, `dotnet build`, `dotnet run`, `dotnet test`, `dotnet publish`, and `dotnet pack`. To disable implicit restore, use the `--no-restore` option. +You don't have to run [`dotnet restore`](../dotnet-restore.md) because it's run implicitly by all commands that require a restore to occur, such as `dotnet new`, `dotnet build`, `dotnet run`, `dotnet test`, `dotnet publish`, and `dotnet pack`. To disable implicit restore, use the `--no-restore` option. The `dotnet restore` command is still useful in certain scenarios where explicitly restoring makes sense, such as [continuous integration builds in Azure DevOps Services](/azure/devops/build-release/apps/aspnet/build-aspnet-core) or in build systems that need to explicitly control when the restore occurs. -For information about how to manage NuGet feeds, see the [`dotnet restore` documentation](../docs/core/tools/dotnet-restore.md). +For information about how to manage NuGet feeds, see the [`dotnet restore` documentation](../dotnet-restore.md). This command supports the `dotnet restore` options when passed in the long form (for example, `--source`). Short form options, such as `-s`, are not supported. diff --git a/includes/dotnet-tool-install-arch-options.md b/docs/core/tools/includes/dotnet-tool-install-arch-options.md similarity index 79% rename from includes/dotnet-tool-install-arch-options.md rename to docs/core/tools/includes/dotnet-tool-install-arch-options.md index 281b51d599518..c8baacda10ea2 100644 --- a/includes/dotnet-tool-install-arch-options.md +++ b/docs/core/tools/includes/dotnet-tool-install-arch-options.md @@ -1,2 +1,2 @@ > [!NOTE] -> By default the architecture of the .NET binaries to install represents the currently running OS architecture. To specify a different OS architecture, see [dotnet tool install, --arch option](../docs/core/tools/dotnet-tool-install.md#options). +> By default the architecture of the .NET binaries to install represents the currently running OS architecture. To specify a different OS architecture, see [dotnet tool install, --arch option](../dotnet-tool-install.md#options). diff --git a/includes/elevated-access-unix.md b/docs/core/tools/includes/elevated-access-unix.md similarity index 100% rename from includes/elevated-access-unix.md rename to docs/core/tools/includes/elevated-access-unix.md diff --git a/includes/cli-arch.md b/includes/cli-arch.md deleted file mode 100644 index 20d90f525527b..0000000000000 --- a/includes/cli-arch.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -ms.date: 08/12/2021 -ms.topic: include ---- -**`-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. diff --git a/includes/cli-os.md b/includes/cli-os.md deleted file mode 100644 index 364db606cbc6d..0000000000000 --- a/includes/cli-os.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -ms.date: 08/12/2021 -ms.topic: include ---- -**`--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.