Files
cmake/Tests/RunCMake/CacheVarHelpFallback/DefineUnknownVarUninitialized.cmake
T
Daksh Mamodiya 7fdf315ba3 cmake: Populate help string from documentation table for -D entries
When a built-in cache variable is set via `-D <var>=<value>` with no
help text supplied, populate `HELPSTRING` from the built-in
documentation table (sourced from `Help/variable/*.rst` and the
per-language pattern manuals).  Project-defined and unknown variables
continue to receive the legacy "No help, variable specified on the
command line." sentinel.

The cache entry's type and value are left untouched: type stays
`UNINITIALIZED` for bare `-D` and an explicit `-D <var>:TYPE=<value>`
is honored as before.  The `cmCacheManager::LoadCache` path is not
modified, so reload of existing caches is a fixed point.

Fixes: #27830
2026-05-28 09:25:41 -04:00

5 lines
279 B
CMake

# Defines a project-specific cache variable on the command line with no
# ``:TYPE=`` annotation. The documentation table cannot match this
# name, so the entry must remain ``:UNINITIALIZED=`` and receive the
# generic sentinel help string preserved for backwards compatibility.