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