The option `--allow-roll-forward` is not documented for `dotnet tool install`

[gasparnagy]

Type of issue

Missing information

Description

The dotnet tool install command seems to have now a --allow-roll-forward option (.NET 9.0.102), but I could not find it in the related documentation page.

The help page of the command contains it already:

Description:
  Install global or local tool. Local tools are added to manifest and restored.

Usage:
  dotnet tool install <packageId> [options]

Arguments:
  <PACKAGE_ID>  The NuGet Package Id of the tool to install.

Options:
  -g, --global                 Install the tool for the current user.
  --local                      Install the tool and add to the local tool manifest (default).
  --tool-path <PATH>           The directory where the tool will be installed. The directory will be created if it does not exist.
  --version <VERSION>          The version of the tool package to install.
  --configfile <FILE>          The NuGet configuration file to use.
  --tool-manifest <PATH>       Path to the manifest file.
  --add-source <ADDSOURCE>     Add an additional NuGet package source to use during installation.
  --source <SOURCE>            Replace all NuGet package sources to use during installation with these.
  --framework <FRAMEWORK>      The target framework to install the tool for.
  --prerelease                 Include pre-release packages.
  --disable-parallel           Prevent restoring multiple projects in parallel.
  --ignore-failed-sources      Treat package source failures as warnings.
  --no-http-cache              Do not cache packages and http requests.
  --interactive                Allows the command to stop and wait for user input or action (for example to complete authentication).
  -v, --verbosity <LEVEL>      Set the MSBuild verbosity level. Allowed values are q[uiet], m[inimal], n[ormal], d[etailed], and diag[nostic].
  -a, --arch <arch>            The target architecture.
  --create-manifest-if-needed  Create a tool manifest if one isn't found during tool installation. For information on how manifests are located, see https://aka.ms/dotnet/tools/create-manifest-if-needed
  --allow-downgrade            Allow package downgrade when installing a .NET tool package.
  --allow-roll-forward         Allow a .NET tool to roll forward to newer versions of the .NET runtime if the runtime it targets isn't installed.
  -?, -h, --help               Show command line help.

Page URL

https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-tool-install

Content source URL

https://github.com/dotnet/docs/blob/main/docs/core/tools/dotnet-tool-install.md

Document Version Independent Id

80822879-4c2e-1c28-ae04-1adb5e7e8a99

Article author

@tdykstra

Metadata

• ID: 7df78c19-0c6f-fe28-213c-b51dd73398ef
• Service: dotnet-fundamentals

Related Issues