diff options
| author | Craig Scott <craig.scott@crascit.com> | 2023-12-17 20:37:58 (GMT) |
|---|---|---|
| committer | Kitware Robot <kwrobot@kitware.com> | 2023-12-17 20:38:06 (GMT) |
| commit | b7ad9bd8f33602b63347f6ad2052afff416a886c (patch) | |
| tree | 9513b19ca0c8638bf48e6b00a8af2010a828447d /Modules | |
| parent | a8dcc2c6c2d3ba3ff0d039cbb55e4a26db9180ed (diff) | |
| parent | 18c514a86d980e62bf7f86a69fc154a23f5669a2 (diff) | |
| download | CMake-b7ad9bd8f33602b63347f6ad2052afff416a886c.zip CMake-b7ad9bd8f33602b63347f6ad2052afff416a886c.tar.gz CMake-b7ad9bd8f33602b63347f6ad2052afff416a886c.tar.bz2 | |
Merge topic 'doc-fc-fully-disconnected'
18c514a86d Help: Add note not to use FETCHCONTENT_FULLY_DISCONNECTED on first run
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !9081
Diffstat (limited to 'Modules')
| -rw-r--r-- | Modules/FetchContent.cmake | 11 |
1 files changed, 11 insertions, 0 deletions
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 <dependency_providers>` and populate the + dependency from local content instead. + .. variable:: FETCHCONTENT_UPDATES_DISCONNECTED This is a less severe download/update control compared to |