summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorPeter Waller <p@pwaller.net>2019-08-20 21:32:50 (GMT)
committerBrad King <brad.king@kitware.com>2019-08-27 14:51:40 (GMT)
commit4ca0526f8a78e7abbd08e9978d4110f836ccef9b (patch)
tree619d1ab993466c1250f2fca9c1ffcb1f4a40bd8e /Help
parent43fe736b2bf272647fb24b481bdc9a585c0666ac (diff)
downloadCMake-4ca0526f8a78e7abbd08e9978d4110f836ccef9b.zip
CMake-4ca0526f8a78e7abbd08e9978d4110f836ccef9b.tar.gz
CMake-4ca0526f8a78e7abbd08e9978d4110f836ccef9b.tar.bz2
cmake: Pass -S and -B into PreLoad.cmake and -C scripts
Before this, it was not possible to see what the source or build directories were set to on the command line. Fixes: #19619
Diffstat (limited to 'Help')
-rw-r--r--Help/manual/OPTIONS_BUILD.txt3
-rw-r--r--Help/release/dev/cmake-initial-cache-dirs.rst6
2 files changed, 9 insertions, 0 deletions
diff --git a/Help/manual/OPTIONS_BUILD.txt b/Help/manual/OPTIONS_BUILD.txt
index 810aaa9..0947e41 100644
--- a/Help/manual/OPTIONS_BUILD.txt
+++ b/Help/manual/OPTIONS_BUILD.txt
@@ -18,6 +18,9 @@
containing :command:`set` commands that use the ``CACHE`` option, not a
cache-format file.
+ References to :variable:`CMAKE_SOURCE_DIR` and :variable:`CMAKE_BINARY_DIR`
+ within the script evaluate to the top-level source and build tree.
+
``-D <var>:<type>=<value>, -D <var>=<value>``
Create or update a CMake ``CACHE`` entry.
diff --git a/Help/release/dev/cmake-initial-cache-dirs.rst b/Help/release/dev/cmake-initial-cache-dirs.rst
new file mode 100644
index 0000000..be91902
--- /dev/null
+++ b/Help/release/dev/cmake-initial-cache-dirs.rst
@@ -0,0 +1,6 @@
+cmake-initial-cache-dirs
+------------------------
+
+* The :manual:`cmake(1)` ``-C <initial-cache>`` option now evaluates the
+ initial cache script with :variable:`CMAKE_SOURCE_DIR` and
+ :variable:`CMAKE_BINARY_DIR` set to the top-level source and build trees.