mirror of
https://github.com/Detanup01/gbe_fork.git
synced 2025-01-10 09:43:57 +08:00
31 lines
1.2 KiB
ReStructuredText
31 lines
1.2 KiB
ReStructuredText
|
CMP0170
|
||
|
|
-------
|
||
|
|
|
||
|
|
.. versionadded:: 3.30
|
||
|
|
|
||
|
|
When ``FETCHCONTENT_FULLY_DISCONNECTED`` is set to true,
|
||
|
|
:command:`FetchContent_MakeAvailable` and :command:`FetchContent_Populate`
|
||
|
|
enforce the constraint that their source directory must already be populated.
|
||
|
|
The requirement has always been documented, but it was not checked or enforced
|
||
|
|
with CMake 3.29 or older. This sometimes led to hard-to-trace errors when a
|
||
|
|
project expected a dependency to have been populated, but its population was
|
||
|
|
silently skipped.
|
||
|
|
|
||
|
|
CMake 3.30 and above prefers to check and enforce the constraint.
|
||
|
|
This policy provides compatibility for situations where the user cannot easily
|
||
|
|
prevent ``FETCHCONTENT_FULLY_DISCONNECTED`` from being inappropriately set
|
||
|
|
to true.
|
||
|
|
|
||
|
|
The ``OLD`` behavior of this policy allows ``FETCHCONTENT_FULLY_DISCONNECTED``
|
||
|
|
to be set to true even if a dependency's source directory has not been
|
||
|
|
populated.
|
||
|
|
The ``NEW`` behavior halts with a fatal error if
|
||
|
|
``FETCHCONTENT_FULLY_DISCONNECTED`` is set to true and a dependency population
|
||
|
|
would be skipped, but that dependency's source directory doesn't exist.
|
||
|
|
|
||
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.30
|
||
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
||
|
|
.. include:: STANDARD_ADVICE.txt
|
||
|
|
|
||
|
|
.. include:: DEPRECATED.txt
|