mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-05 21:31:08 -06:00
42 lines
1.9 KiB
ReStructuredText
42 lines
1.9 KiB
ReStructuredText
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
|