1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
|
CMP0192
-------
.. versionadded:: 4.1
:module:`GNUInstallDirs` uses absolute ``SYSCONFDIR``, ``LOCALSTATEDIR``,
and ``RUNSTATEDIR`` in special prefixes.
The :module:`GNUInstallDirs` module documents
:ref:`special cases <GNUInstallDirs special cases>`
for ``SYSCONFDIR``, ``LOCALSTATEDIR``, and ``RUNSTATEDIR``.
When :variable:`CMAKE_INSTALL_PREFIX` is a special prefix, e.g., ``/usr``,
the absolute paths for these directories may be outside the prefix, e.g.,
``/etc``, ``/var``, and ``/var/run``.
In CMake 4.0 and below, the default values for the ``CMAKE_INSTALL_<dir>``
variables, for ``<dir>`` equal to ``SYSCONFDIR``, ``LOCALSTATEDIR``, and
``RUNSTATEDIR``, always used relative paths (``etc``, ``var``, ``var/run``),
and the special cases were implemented only when computing absolute paths
for the ``CMAKE_INSTALL_FULL_<dir>`` variables.
CMake 4.1 and above prefer to default ``CMAKE_INSTALL_<dir>`` variables to
absolute paths, for ``<dir>`` equal to ``SYSCONFDIR``, ``LOCALSTATEDIR``,
and ``RUNSTATEDIR``, when :variable:`CMAKE_INSTALL_PREFIX` is a special
prefix. This policy provides compatibility for projects that have not
been updated to expect this behavior.
The ``OLD`` behavior for this policy is to default ``CMAKE_INSTALL_<dir>``
variables to relative paths. The ``NEW`` behavior for this policy is to
default ``CMAKE_INSTALL_<dir>`` variables to absolute paths, for ``<dir>``
equal to ``SYSCONFDIR``, ``LOCALSTATEDIR``, and ``RUNSTATEDIR``, when
:variable:`CMAKE_INSTALL_PREFIX` is a special prefix.
This policy takes effect at the first call of ``include(GNUInstallDirs)``.
Subsequent calls of ``include(GNUInstallDirs)`` reuse cached
``CMAKE_INSTALL_<dir>`` values from the first call.
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 4.1
.. |WARNS_OR_DOES_NOT_WARN| replace:: does *not* warn
.. include:: include/STANDARD_ADVICE.rst
.. include:: include/DEPRECATED.rst
|
