From c95d017f9c221f309a4b74d8a033c1e99e784f90 Mon Sep 17 00:00:00 2001
From: Brad King <brad.king@kitware.com>
Date: Tue, 21 Feb 2017 10:31:24 -0500
Subject: [PATCH] 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 `<INSTALL_DIR>` 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 325fbc398a..c3fd3c65bf 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 <dir>``
-    Installation prefix
+    Installation prefix to be placed in the ``<INSTALL_DIR>`` 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_DIR>``.
   ``INSTALL_COMMAND <cmd>...``
     Command to drive installation of the external project after it has been
     built.  This only happens at the *build* time of the calling project.
-- 
GitLab