vcpkg/docs/commands/remove.md
Robert Schumacher 6bd8d772ee
[docs] Add docs for remove command (#25264)
* [docs] Add docs for remove command

* [docs] CR
2022-06-24 13:11:32 -07:00

1.4 KiB

vcpkg remove

The latest version of this documentation is available on GitHub.

Synopsis

vcpkg remove [options] <package>...
vcpkg remove --outdated [options]

Description

Remove port packages from Classic Mode.

remove removes listed packages and any packages that require them from the Classic Mode [installed directory][common-options.md#install-root]. See the install command documentation for detailed syntax of the <package> parameter.

This command is not currently supported in Manifest Mode.

Options

All vcpkg commands support a set of common options.

--recurse

Allow removing packages not specified on the command line.

By default, vcpkg refuses to execute a removal plan that would remove packages not listed on the command line.

--dry-run

Print the packages to be removed, but do not remove them.

--outdated

Remove all packages that do not match the available port versions.

For each installed package, vcpkg will compare the installed version string to the version string of the current recipe. If those versions differ, the package will be selected for removal. If --outdated is passed, no packages should be listed on the command line.