summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorMin Hsu <min@myhsu.dev>2024-07-08 18:53:26 (GMT)
committerBrad King <brad.king@kitware.com>2024-07-23 14:19:22 (GMT)
commitc55239e2861151eb16c1fb90258b50c07952fb4f (patch)
treee4df7395fc4d222a07fce59b6eb34e4502fac33f /Help
parentd308437d6d01a9011e9f02856cb45a9df2dbca41 (diff)
downloadCMake-c55239e2861151eb16c1fb90258b50c07952fb4f.zip
CMake-c55239e2861151eb16c1fb90258b50c07952fb4f.tar.gz
CMake-c55239e2861151eb16c1fb90258b50c07952fb4f.tar.bz2
cmake: Add flag to list cache entries matching a regex
Add a `-LR[A][H] <regex>` flag with similar functionality to `-L[A][H]`, but instead of listing all cached variables, it show only specific variables that match the name regex.
Diffstat (limited to 'Help')
-rw-r--r--Help/manual/cmake.1.rst11
-rw-r--r--Help/release/dev/cmake-list-cached-variables.rst5
2 files changed, 16 insertions, 0 deletions
diff --git a/Help/manual/cmake.1.rst b/Help/manual/cmake.1.rst
index 48a9219..fa4d809 100644
--- a/Help/manual/cmake.1.rst
+++ b/Help/manual/cmake.1.rst
@@ -232,6 +232,17 @@ Options
will display also advanced variables. If ``H`` is specified, it will also
display help for each variable.
+.. option:: -LR[A][H] <regex>
+
+ .. versionadded:: 3.31
+
+ Show specific non-advanced cached variables
+
+ Show non-``INTERNAL`` nor :prop_cache:`ADVANCED` variables from the CMake
+ ``CACHE`` that match the given regex. If ``A`` is specified, then it
+ will also show advanced variables. If ``H`` is specified, it will also
+ display help for each variable.
+
.. option:: -N
View mode only.
diff --git a/Help/release/dev/cmake-list-cached-variables.rst b/Help/release/dev/cmake-list-cached-variables.rst
new file mode 100644
index 0000000..983925d
--- /dev/null
+++ b/Help/release/dev/cmake-list-cached-variables.rst
@@ -0,0 +1,5 @@
+cmake-list-cached-variables
+---------------------------
+
+* The :option:`cmake -LR[A][H]` option was added to list cache entries
+ whose names match a regular expression.