summaryrefslogtreecommitdiffstats
path: root/Help/release
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2020-12-11 18:05:12 (GMT)
committerKitware Robot <kwrobot@kitware.com>2020-12-11 18:05:34 (GMT)
commit794aa36b1fe945c25822108dbf3bcaa4c89f26d7 (patch)
tree97d0622c5cd7ac0be8e137b7cd0ab52c494e0f79 /Help/release
parent0d9c43281fa4e39b18f63af3619fb89280bde722 (diff)
parentb7f0327dcd4032c6a118825adcfdc8dab6295e7f (diff)
downloadCMake-794aa36b1fe945c25822108dbf3bcaa4c89f26d7.zip
CMake-794aa36b1fe945c25822108dbf3bcaa4c89f26d7.tar.gz
CMake-794aa36b1fe945c25822108dbf3bcaa4c89f26d7.tar.bz2
Merge topic 'apple-silicon-host-arch'
b7f0327dcd Tests: Cover macOS host architecture selection on Apple Silicon hosts 5f882f6ce5 macOS: Offer control over host architecture on Apple Silicon hosts Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5589
Diffstat (limited to 'Help/release')
-rw-r--r--Help/release/3.19.rst24
1 files changed, 24 insertions, 0 deletions
diff --git a/Help/release/3.19.rst b/Help/release/3.19.rst
index 899e745..4f26058 100644
--- a/Help/release/3.19.rst
+++ b/Help/release/3.19.rst
@@ -53,6 +53,22 @@ Languages
* ``CUDA`` language support now works on QNX.
+Platforms
+---------
+
+* Apple Silicon is now supported (since CMake 3.19.2):
+
+ * The :variable:`CMAKE_HOST_SYSTEM_PROCESSOR` is selected using ``uname -m``.
+ Since this may vary based on CMake's own architecture and that of
+ the invoking process tree, the :variable:`CMAKE_APPLE_SILICON_PROCESSOR`
+ variable or :envvar:`CMAKE_APPLE_SILICON_PROCESSOR` environment
+ variable may be set to specify a host architecture explicitly.
+
+ * If :variable:`CMAKE_OSX_ARCHITECTURES` is not set, CMake adds explicit
+ flags to tell the compiler to build for the
+ :variable:`CMAKE_HOST_SYSTEM_PROCESSOR` so the toolchain does not
+ have to guess based on the process tree's architecture.
+
File-Based API
--------------
@@ -357,3 +373,11 @@ Changes made since CMake 3.19.0 include the following.
It requires macOS 10.10 or newer.
The package file naming pattern has been changed from
``cmake-$ver-Darwin-x86_64`` to ``cmake-$ver-macos-universal``.
+
+* Apple Silicon host architecture selection support was updated.
+ CMake 3.19.0 and 3.19.1 always chose ``arm64`` as the host architecture.
+ CMake 3.19.2 returns to using ``uname -m`` as CMake 3.18 and below did.
+ Since this may vary based on CMake's own architecture and that of
+ the invoking process tree, the :variable:`CMAKE_APPLE_SILICON_PROCESSOR`
+ variable or :envvar:`CMAKE_APPLE_SILICON_PROCESSOR` environment
+ variable may be set to specify a host architecture explicitly.