mirror of
https://github.com/Kitware/CMake.git
synced 2026-02-16 12:11:04 -06:00
ad3c2c0b03
Every policy's documentation has a paragraph on what version of CMake introduced it, how to set the policy, and whether CMake warns if the policy is not set. The wording of this paragraph has diverged across policies over time. Factor the paragraph out into a standard advice document included by every policy.
30 lines
1.3 KiB
ReStructuredText
30 lines
1.3 KiB
ReStructuredText
CMP0135
|
|
-------
|
|
|
|
.. versionadded:: 3.24
|
|
|
|
When using the ``URL`` download method with the :command:`ExternalProject_Add`
|
|
command, CMake 3.23 and below sets the timestamps of the extracted contents
|
|
to the same as the timestamps in the archive. When the ``URL`` changes, the
|
|
new archive is downloaded and extracted, but the timestamps of the extracted
|
|
contents might not be newer than the previous contents. Anything that depends
|
|
on the extracted contents might not be rebuilt, even though the contents may
|
|
change.
|
|
|
|
CMake 3.24 and above prefers to set the timestamps of all extracted contents
|
|
to the time of the extraction. This ensures that anything that depends on the
|
|
extracted contents will be rebuilt whenever the ``URL`` changes.
|
|
|
|
The ``DOWNLOAD_EXTRACT_TIMESTAMP`` option to the
|
|
:command:`ExternalProject_Add` command can be used to explicitly specify how
|
|
timestamps should be handled. When ``DOWNLOAD_EXTRACT_TIMESTAMP`` is not
|
|
given, this policy controls the default behavior. The ``OLD`` behavior for
|
|
this policy is to restore the timestamps from the archive. The ``NEW``
|
|
behavior sets the timestamps of extracted contents to the time of extraction.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.24
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|