diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/maintainers/cmake_fixup_cmake_targets.md | 25 |
1 files changed, 25 insertions, 0 deletions
diff --git a/docs/maintainers/cmake_fixup_cmake_targets.md b/docs/maintainers/cmake_fixup_cmake_targets.md new file mode 100644 index 000000000..9bbaddbba --- /dev/null +++ b/docs/maintainers/cmake_fixup_cmake_targets.md @@ -0,0 +1,25 @@ +# vcpkg_fixup_cmake_targets
+
+Transforms all /debug/share/\<port\>/\*targets-debug.cmake files and move them to /share/\<port\>.
+Removes all /debug/share/\<port\>/\*targets.cmake and /debug/share/\<port\>/\*config.cmake.
+
+Transforms all references matching /bin/\*.exe tools/\<port\>/\*.exe on Windows.
+Transforms all references matching /bin/\* to /tools/\<port\>/\* on other platforms.
+
+Fixups ${_IMPORT_PREFIX} in auto generated targets to be one folder deeper.
+Replaces ${CURRENT_INSTALLED_DIR} with ${_IMPORT_PREFIX} in config files and targets.
+
+
+## Usage
+```cmake
+vcpkg_fixup_cmake_targets(CONFIG_PATH <config_path>)
+```
+
+## Parameters:
+### CONFIG_PATH
+*.cmake files subdirectory (e.g. "lib/cmake/${PORT}" or "cmake/${PORT}).
+### TARGET_PATH
+Optional location to place fixup'd files. Unecessary if target is "share/${PORT}".
+
+## Source
+[scripts/cmake/cmake_fixup_cmake_targets.cmake](https://github.com/microsoft/vcpkg/blob/master/scripts/cmake/vcpkg_fixup_cmake_targets.cmake)
|