diff options
| author | Joachim Wuttke (o) <j.wuttke@fz-juelich.de> | 2020-02-12 17:53:07 (GMT) |
|---|---|---|
| committer | Joachim Wuttke (o) <j.wuttke@fz-juelich.de> | 2020-02-12 18:40:04 (GMT) |
| commit | 79e1d86d2c5662ff5fad50b9fd54e074e4d00d12 (patch) | |
| tree | 0d1e03152a452d8cfb4abb73e46467b89624325a | |
| parent | 0bfccaa41af7bb074f24fe73908e753fd34eb5f4 (diff) | |
| download | CMake-79e1d86d2c5662ff5fad50b9fd54e074e4d00d12.zip CMake-79e1d86d2c5662ff5fad50b9fd54e074e4d00d12.tar.gz CMake-79e1d86d2c5662ff5fad50b9fd54e074e4d00d12.tar.bz2 | |
Help: command install: absolute paths unsupported by CPack
Advise against absolute DESTINATIONs as they are not supported
by CPack installer generators.
| -rw-r--r-- | Help/command/install.rst | 13 |
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``, |