mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-05 13:20:47 -06:00
535734ee16
- Added intro code block showing how to include this module. - Reworded module introduction. - Used "command" instead of "function". - Reworded command arguments and descriptions. - Added the "See Also" section.
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 input variable argument ``<input-var>``.
|
|
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
|