mirror of
https://github.com/Kitware/CMake.git
synced 2026-04-24 07:08:38 -05:00
Cristian Le
cc6dbd194c
As a consequence, `GNUInstallDirs_get_absolute_install_dir` does not alter the `var` argument (the relative path argument). Closes: #26834 Signed-off-by: Cristian Le <git@lecris.dev>
32 lines
1.4 KiB
ReStructuredText
32 lines
1.4 KiB
ReStructuredText
CMP0193
|
|
-------
|
|
|
|
.. versionadded:: 4.1
|
|
|
|
:module:`GNUInstallDirs` caches ``CMAKE_INSTALL_*`` with leading ``usr/`` for
|
|
install prefix ``/``.
|
|
|
|
When :variable:`CMAKE_INSTALL_PREFIX` is ``/``, the ``CMAKE_INSTALL_<dir>``
|
|
variables, for ``<dir>`` equal to ``BINDIR``, ``SBINDIR``, ``LIBEXECDIR``,
|
|
``SHAREDSTATEDIR``, ``INCLUDEDIR``, ``OLDINCLUDEDIR``, ``DATAROOTDIR``, and
|
|
``LIBDIR``, are prepended with a leading ``usr/`` as documented among the
|
|
:ref:`special cases <GNUInstallDirs special cases>`.
|
|
In CMake 4.0 and below, these ``CMAKE_INSTALL_<dir>`` variables were cached
|
|
without their leading ``usr/``, and it was prepended in normal variables that
|
|
shadow their cache entries.
|
|
CMake 4.1 and above prefer to cache ``CMAKE_INSTALL_<dir>`` with their leading
|
|
``usr/``. Consequently, the :command:`GNUInstallDirs_get_absolute_install_dir`
|
|
command no longer alters the relative ``var`` input variable. This policy
|
|
provides compatibility for projects that have not been updated to expect
|
|
the new behavior.
|
|
|
|
The ``OLD`` behavior for this policy is to cache ``CMAKE_INSTALL_<dir>``
|
|
variables without the leading ``usr/``. The ``NEW`` behavior for this
|
|
policy is to cache ``CMAKE_INSTALL_<dir>`` variables with the leading ``usr/``.
|
|
|
|
.. |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
|