* [doc] document vcpkg_fixup_pkgconfig merging behaviour * [doc] add source
1.8 KiB
vcpkg_fixup_pkgconfig
The latest version of this document lives in the vcpkg repo.
Fix common paths in *.pc files and make everything relative to $(prefix).
Additionally, on static triplets, private entries are merged with their non-private counterparts,
allowing pkg-config to be called without the --static
flag.
Note that vcpkg is designed to never have to call pkg-config with the --static
flag,
since a consumer cannot know if a dependent library has been built statically or not.
Usage
vcpkg_fixup_pkgconfig(
[RELEASE_FILES <PATHS>...]
[DEBUG_FILES <PATHS>...]
[SKIP_CHECK]
)
Parameters
RELEASE_FILES
Specifies a list of files to apply the fixes for release paths. Defaults to every *.pc file in the folder ${CURRENT_PACKAGES_DIR} without ${CURRENT_PACKAGES_DIR}/debug/
DEBUG_FILES
Specifies a list of files to apply the fixes for debug paths. Defaults to every *.pc file in the folder ${CURRENT_PACKAGES_DIR}/debug/
SKIP_CHECK
Skips the library checks in vcpkg_fixup_pkgconfig. Only use if the script itself has unhandled cases.
SYSTEM_PACKAGES (deprecated)
This argument has been deprecated and has no effect.
SYSTEM_LIBRARIES (deprecated)
This argument has been deprecated and has no effect.
IGNORE_FLAGS (deprecated)
This argument has been deprecated and has no effect.
Notes
Still work in progress. If there are more cases which can be handled here feel free to add them