summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorRobert Maynard <robert.maynard@kitware.com>2020-01-29 14:43:06 (GMT)
committerBrad King <brad.king@kitware.com>2020-01-29 15:50:36 (GMT)
commit2158ef3e44ce4f29dc4776d6c5d35a90c2ee87e5 (patch)
tree1b18ffd2b5b549d584ac829a8d2a6c28ca3d35cd /Help
parent1f9321c68399c8cc37a2cb9c78ef45949412bd7b (diff)
downloadCMake-2158ef3e44ce4f29dc4776d6c5d35a90c2ee87e5.zip
CMake-2158ef3e44ce4f29dc4776d6c5d35a90c2ee87e5.tar.gz
CMake-2158ef3e44ce4f29dc4776d6c5d35a90c2ee87e5.tar.bz2
Help: Document which variable names CMake reserves.
Diffstat (limited to 'Help')
-rw-r--r--Help/manual/ID_RESERVE.txt7
-rw-r--r--Help/manual/cmake-language.7.rst2
-rw-r--r--Help/manual/cmake-variables.7.rst1
3 files changed, 10 insertions, 0 deletions
diff --git a/Help/manual/ID_RESERVE.txt b/Help/manual/ID_RESERVE.txt
new file mode 100644
index 0000000..be2b163
--- /dev/null
+++ b/Help/manual/ID_RESERVE.txt
@@ -0,0 +1,7 @@
+.. note::
+
+ CMake reserves identifiers that:
+
+ * begin with ``CMAKE_`` (upper-, lower-, or mixed-case), or
+ * begin with ``_CMAKE_`` (upper-, lower-, or mixed-case), or
+ * begin with ``_`` followed by the name of any :manual:`CMake Command <cmake-commands(7)>`.
diff --git a/Help/manual/cmake-language.7.rst b/Help/manual/cmake-language.7.rst
index 4ca8e3a..b7f0861 100644
--- a/Help/manual/cmake-language.7.rst
+++ b/Help/manual/cmake-language.7.rst
@@ -567,6 +567,8 @@ The :manual:`cmake-variables(7)` manual documents the many variables
that are provided by CMake or have meaning to CMake when set
by project code.
+.. include:: ID_RESERVE.txt
+
.. _`CMake Language Environment Variables`:
Environment Variables
diff --git a/Help/manual/cmake-variables.7.rst b/Help/manual/cmake-variables.7.rst
index 63deda5..1bcd9bd 100644
--- a/Help/manual/cmake-variables.7.rst
+++ b/Help/manual/cmake-variables.7.rst
@@ -14,6 +14,7 @@ For general information on variables, see the
:ref:`Variables <CMake Language Variables>`
section in the cmake-language manual.
+.. include:: ID_RESERVE.txt
Variables that Provide Information
==================================