From 18c514a86d980e62bf7f86a69fc154a23f5669a2 Mon Sep 17 00:00:00 2001 From: Craig Scott Date: Sat, 16 Dec 2023 20:36:26 +1100 Subject: Help: Add note not to use FETCHCONTENT_FULLY_DISCONNECTED on first run Fixes: #25481 --- Modules/FetchContent.cmake | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/Modules/FetchContent.cmake b/Modules/FetchContent.cmake index 1038585..d3a17b3 100644 --- a/Modules/FetchContent.cmake +++ b/Modules/FetchContent.cmake @@ -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 ` and populate the + dependency from local content instead. + .. variable:: FETCHCONTENT_UPDATES_DISCONNECTED This is a less severe download/update control compared to -- cgit v0.12