mirror/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2026-01-11 08:20:18 -06:00
Code Issues Packages Projects Releases Wiki Activity

Help: Add note not to use FETCHCONTENT_FULLY_DISCONNECTED on first run

Browse Source 
Fixes: #25481
This commit is contained in:
Craig Scott
2023-12-16 20:36:26 +11:00
parent 6ba3bb0563
commit 18c514a86d
1 changed files with 11 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
Modules/FetchContent.cmake
View File

@@ -685,6 +685,17 @@ A number of cache variables can influence the behavior where details from a
any content details, turning this option ``ON`` can significantly speed up
the configure stage. It is ``OFF`` by default.
.. note::
The ``FETCHCONTENT_FULLY_DISCONNECTED`` variable is not an appropriate way
to prevent any network access on the first run in a build directory.
Doing so can break projects, lead to misleading error messages, and hide
subtle population failures. This variable is specifically intended to
only be turned on *after* the first time CMake has been run.
If you want to prevent network access even on the first run, use a
:ref:`dependency provider <dependency_providers>` and populate the
dependency from local content instead.
.. variable:: FETCHCONTENT_UPDATES_DISCONNECTED
This is a less severe download/update control compared to