vcpkg/docs/maintainers/vcpkg_host_path_list.md
nicole mazzuca f0281bf749
[scripts-audit] vcpkg_fixup_pkgconfig (#19658)
* [scripts-audit] vcpkg_fixup_pkgconfig

* Neumann-A CR, fix docs

* vcpkg_fixup_pkgconfig bugs

* fix group

* moar fixing

* be more clever around pkg_config_path

* add `vcpkg_host_path_list` so that we can unit test

* move stuff around a bit

* fix bug in vcpkg_host_path_list.cmake

* ras0219 CRs
2021-09-27 13:27:44 -07:00

1.1 KiB

vcpkg_host_path_list

The latest version of this document lives in the vcpkg repo.

Modify a host path list variable (PATH, INCLUDE, LIBPATH, etc.)

vcpkg_host_path_list(PREPEND <list-var> [<path>...])
vcpkg_host_path_list(APPEND <list-var> [<path>...])

<list-var> may be either a regular variable name, or ENV{variable-name}, in which case vcpkg_host_path_list will modify the environment.

vcpkg_host_path_list adds all of the paths passed to it to <list-var>; PREPEND puts them before the existing list, so that they are searched first; APPEND places them after the existing list, so they would be searched after the paths which are already in the variable.

For both APPEND and PREPEND, the paths are added (and thus searched) in the order received.

If no paths are passed, then nothing will be done.

Source

scripts/cmake/vcpkg_host_path_list.cmake