diff options
| author | Brad King <brad.king@kitware.com> | 2024-05-20 23:04:31 (GMT) |
|---|---|---|
| committer | Kitware Robot <kwrobot@kitware.com> | 2024-05-20 23:04:42 (GMT) |
| commit | f9b85f331ee28cfd19dbb126ac9dc6c59965ace5 (patch) | |
| tree | f518a645d80fe046a5878a04907d564c58463cd6 | |
| parent | 506d1752de3f202525e18614d773efba94679e33 (diff) | |
| parent | eda17e76e2fc484525baf3c6ef4e68b37074e2dc (diff) | |
| download | CMake-f9b85f331ee28cfd19dbb126ac9dc6c59965ace5.zip CMake-f9b85f331ee28cfd19dbb126ac9dc6c59965ace5.tar.gz CMake-f9b85f331ee28cfd19dbb126ac9dc6c59965ace5.tar.bz2 | |
Merge topic 'cmp0097-fetchcontent'
eda17e76e2 Help: Document that CMP0097 is always NEW for FetchContent
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !9527
| -rw-r--r-- | Help/policy/CMP0097.rst | 15 |
1 files changed, 12 insertions, 3 deletions
diff --git a/Help/policy/CMP0097.rst b/Help/policy/CMP0097.rst index 66a7b96..d9141f5 100644 --- a/Help/policy/CMP0097.rst +++ b/Help/policy/CMP0097.rst @@ -4,9 +4,7 @@ CMP0097 .. versionadded:: 3.16 :command:`ExternalProject_Add` with ``GIT_SUBMODULES ""`` initializes no -submodules. The policy also applies to :command:`FetchContent_Declare`, -which uses the same download and update features as -:command:`ExternalProject_Add`. +submodules. The commands provide a ``GIT_SUBMODULES`` option which controls what submodules to initialize and update. Starting with CMake 3.16, explicitly setting @@ -25,4 +23,15 @@ an empty string to initialize and update no git submodules. .. |WARNS_OR_DOES_NOT_WARN| replace:: does *not* warn .. include:: STANDARD_ADVICE.txt +.. note:: + + This policy also applies to :command:`FetchContent_Declare`, + which uses the same download and update features as + :command:`ExternalProject_Add`. However, due to an implementation deficiency + present since the policy was first introduced, CMake 3.16 and later always + uses the ``NEW`` behavior for :command:`FetchContent_Declare`, regardless of + the policy setting. Formally, this forcing of ``NEW`` behavior for + :command:`FetchContent_Declare` will continue to apply in future CMake + releases. + .. include:: DEPRECATED.txt |