Browse Source

Help: Add note not to use FETCHCONTENT_FULLY_DISCONNECTED on first run

Fixes: #25481
Craig Scott 1 năm trước cách đây
mục cha
commit
18c514a86d
1 tập tin đã thay đổi với 11 bổ sung0 xóa
  1. 11 0
      Modules/FetchContent.cmake

+ 11 - 0
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 <dependency_providers>` and populate the
+    dependency from local content instead.
+
 .. variable:: FETCHCONTENT_UPDATES_DISCONNECTED
 
   This is a less severe download/update control compared to