summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2020-02-14 13:39:41 (GMT)
committerKitware Robot <kwrobot@kitware.com>2020-02-14 13:39:49 (GMT)
commitadd917754f98575b17c71f3defec98a763cf7565 (patch)
treeabd15a5aa09b02505f6380435ac357cd9ae1288b
parent4bfe0b6f0dd15f5955d5cea325285907def2312f (diff)
parent79e1d86d2c5662ff5fad50b9fd54e074e4d00d12 (diff)
downloadCMake-add917754f98575b17c71f3defec98a763cf7565.zip
CMake-add917754f98575b17c71f3defec98a763cf7565.tar.gz
CMake-add917754f98575b17c71f3defec98a763cf7565.tar.bz2
Merge topic 'doc-install-dest'
79e1d86d2c Help: command install: absolute paths unsupported by CPack Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4355
-rw-r--r--Help/command/install.rst13
1 files changed, 10 insertions, 3 deletions
diff --git a/Help/command/install.rst b/Help/command/install.rst
index 5affc5b..a3c64a4 100644
--- a/Help/command/install.rst
+++ b/Help/command/install.rst
@@ -30,13 +30,20 @@ signatures that specify them. The common options are:
``DESTINATION``
Specify the directory on disk to which a file will be installed.
- If a full path (with a leading slash or drive letter) is given
- it is used directly. If a relative path is given it is interpreted
- relative to the value of the :variable:`CMAKE_INSTALL_PREFIX` variable.
+ Arguments can be relative or absolute paths.
+
+ If a relative path is given it is interpreted relative to the value
+ of the :variable:`CMAKE_INSTALL_PREFIX` variable.
The prefix can be relocated at install time using the ``DESTDIR``
mechanism explained in the :variable:`CMAKE_INSTALL_PREFIX` variable
documentation.
+ If an absolute path (with a leading slash or drive letter) is given
+ it is used verbatim.
+
+ As absolute paths are not supported by :manual:`cpack <cpack(1)>` installer
+ generators, it is preferable to use relative paths throughout.
+
``PERMISSIONS``
Specify permissions for installed files. Valid permissions are
``OWNER_READ``, ``OWNER_WRITE``, ``OWNER_EXECUTE``, ``GROUP_READ``,