From 4b21290e204d02dd39f6ac404ba923d546f40925 Mon Sep 17 00:00:00 2001 From: Wilfried Goesgens Date: Tue, 21 Feb 2017 15:33:06 +0100 Subject: ExternalProject: Clarify documented role of `INSTALL_COMMAND` It is for the install step of the external project and does not affect installation of the calling project. --- Modules/ExternalProject.cmake | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/Modules/ExternalProject.cmake b/Modules/ExternalProject.cmake index 458c114..325fbc3 100644 --- a/Modules/ExternalProject.cmake +++ b/Modules/ExternalProject.cmake @@ -176,7 +176,11 @@ Create custom targets to build projects in external trees ``INSTALL_DIR `` Installation prefix ``INSTALL_COMMAND ...`` - Command to drive install after build + Command to drive installation of the external project after it has been + built. This only happens at the *build* time of the calling project. + In order to install files from the external project alongside the + locally-built files, a separate local :command:`install` call must be + added to pick the files up from one of the external project trees. Test step options are: -- cgit v0.12 From c95d017f9c221f309a4b74d8a033c1e99e784f90 Mon Sep 17 00:00:00 2001 From: Brad King Date: Tue, 21 Feb 2017 10:31:24 -0500 Subject: ExternalProject: Clarify documented role of `INSTALL_DIR` It does not actually configure the project to install to the given location. That must be done by passing the `` placeholder to the external project configuration step. --- Modules/ExternalProject.cmake | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/Modules/ExternalProject.cmake b/Modules/ExternalProject.cmake index 325fbc3..c3fd3c6 100644 --- a/Modules/ExternalProject.cmake +++ b/Modules/ExternalProject.cmake @@ -174,7 +174,10 @@ Create custom targets to build projects in external trees Install step options are: ``INSTALL_DIR `` - Installation prefix + Installation prefix to be placed in the ```` placeholder. + This does not actually configure the external project to install to + the given prefix. That must be done by passing appropriate arguments + to the external project configuration step, e.g. using ````. ``INSTALL_COMMAND ...`` Command to drive installation of the external project after it has been built. This only happens at the *build* time of the calling project. -- cgit v0.12