mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-28 18:09:31 -06:00
6a1fac1450
The file generated by install(EXPORT) computes _IMPORT_PREFIX in a way that assumes a normalized path. If the DESTINATION contains any ../ components, the computed _IMPORT_PREFIX would be wrong. Force the DESTINATION path to be normalized, subject to the new CMP0176 policy. Also normalize all other DESTINATION paths for consistency, except for INCLUDES DESTINATION, which is not strictly a destination but rather a search path to add. Fixes: #26252
39 lines
1.8 KiB
ReStructuredText
39 lines
1.8 KiB
ReStructuredText
CMP0177
|
|
-------
|
|
|
|
.. versionadded:: 3.31
|
|
|
|
:command:`install` ``DESTINATION`` paths are normalized.
|
|
|
|
The :command:`install` command has a number of different forms, and most of
|
|
them take a ``DESTINATION`` keyword, some in more than one place.
|
|
CMake 3.30 and earlier used the value given after the ``DESTINATION`` keyword
|
|
as provided with no transformations. The :command:`install(EXPORT)` form
|
|
assumes the path contains no ``..`` or ``.`` path components when computing
|
|
a path relative to the ``DESTINATION``, and if the project provided a path
|
|
that violated that assumption, the computed path would be incorrect.
|
|
|
|
CMake 3.31 normalizes all ``DESTINATION`` values given in any form of the
|
|
:command:`install` command, except for the ``INCLUDES DESTINATION`` of the
|
|
:command:`install(TARGETS)` form. The normalization performed is the same
|
|
as for the :command:`cmake_path` command (see :ref:`Normalization`).
|
|
|
|
The ``OLD`` behavior of this policy performs no translation on the
|
|
``DESTINATION`` values of any :command:`install` command. They are used
|
|
exactly as provided. If a destination path contains ``..`` or ``.`` path
|
|
components, :command:`install(EXPORT)` will use the same wrong paths as
|
|
CMake 3.30 and earlier.
|
|
|
|
The ``NEW`` behavior will normalize all ``DESTINATION`` values except for
|
|
``INCLUDES DESTINATION``. If a destination path contains a generator
|
|
expression, it will be wrapped in a ``$<PATH:CMAKE_PATH,NORMALIZE,...>``
|
|
generator expression.
|
|
|
|
This policy was introduced in CMake version 3.31.
|
|
It may be set by :command:`cmake_policy` or :command:`cmake_minimum_required`.
|
|
If it is not set, CMake will warn if it detects a path that would be different
|
|
if normalized, and uses ``OLD`` behavior. If a destination path contains a
|
|
generator expression, no such warning will be issued regardless of the value.
|
|
|
|
.. include:: DEPRECATED.txt
|