Files
cmake/Tests/RunCMake/CacheVarHelpFallback/PatternCxxClangTidy.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

10 lines
572 B
CMake

# Defines a placeholder-shaped built-in cache variable on the command
# line with no ``:TYPE=`` annotation. No exact-match entry exists for
# ``CMAKE_CXX_CLANG_TIDY`` in ``cmCacheDocumentationTable``;
# ``cmake::ProcessCacheArg`` therefore consults the pattern table
# (``cmCachePatternTable``), matches the ``CMAKE_<LANG>_CLANG_TIDY``
# pattern, and installs the pattern's Summary as the entry's HELPSTRING.
# Type and value are preserved verbatim. The project listfile itself
# does not ``set(...)`` the variable; the cache entry materializes
# solely through ``-D``.