| 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 |