* [document] Fix the automatically generated document URL * [docs] Format all documents
1.2 KiB
z_vcpkg_apply_patches
The latest version of this document lives in the vcpkg repo.
Only for internal use in vcpkg helpers. Behavior and arguments will change without notice.
Apply a set of patches to a source tree.
z_vcpkg_apply_patches(
SOURCE_PATH <path-to-source>
[QUIET]
PATCHES <patch>...
)
The <path-to-source>
should be set to ${SOURCE_PATH}
by convention,
and is the path to apply the patches in.
z_vcpkg_apply_patches
will take the list of <patch>
es,
which are by default relative to the port directory,
and apply them in order using git apply
.
Generally, these <patch>
es take the form of some.patch
to select patches in the port directory.
One may also download patches and use ${VCPKG_DOWNLOADS}/path/to/some.patch
.
If QUIET
is not passed, it is a fatal error for a patch to fail to apply;
otherwise, if QUIET
is passed, no message is printed.
This should only be used for edge cases, such as patches that are known to fail even on a clean source tree.