summaryrefslogtreecommitdiffstats
path: root/Help/variable/CMAKE_SYSTEM_NAME.rst
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2015-10-02 13:58:15 (GMT)
committerCMake Topic Stage <kwrobot@kitware.com>2015-10-02 13:58:15 (GMT)
commit8f545d950166f49bebf92d270d373e7cb98060b8 (patch)
tree901c71ecef390a63bdc1e73d7e2060dcbc4c73b2 /Help/variable/CMAKE_SYSTEM_NAME.rst
parent02bc311138ad8ac0c3653e836a02d54245ae4b12 (diff)
parentb31ac171a4acdc8d8eb1d08c5b5f61ec90a9dbaa (diff)
downloadCMake-8f545d950166f49bebf92d270d373e7cb98060b8.zip
CMake-8f545d950166f49bebf92d270d373e7cb98060b8.tar.gz
CMake-8f545d950166f49bebf92d270d373e7cb98060b8.tar.bz2
Merge topic 'explicit-system-version'
b31ac171 Allow CMAKE_SYSTEM_VERSION to be set without CMAKE_SYSTEM_NAME 70688609 Help: Improve CMAKE_SYSTEM_{NAME,VERSION} variable documentation
Diffstat (limited to 'Help/variable/CMAKE_SYSTEM_NAME.rst')
-rw-r--r--Help/variable/CMAKE_SYSTEM_NAME.rst20
1 files changed, 16 insertions, 4 deletions
diff --git a/Help/variable/CMAKE_SYSTEM_NAME.rst b/Help/variable/CMAKE_SYSTEM_NAME.rst
index 0466da4..c3a42e5 100644
--- a/Help/variable/CMAKE_SYSTEM_NAME.rst
+++ b/Help/variable/CMAKE_SYSTEM_NAME.rst
@@ -1,8 +1,20 @@
CMAKE_SYSTEM_NAME
-----------------
-Name of the operating system CMake is building for.
+The name of the operating system for which CMake is to build.
+See the :variable:`CMAKE_SYSTEM_VERSION` variable for the OS version.
-This is the name of the operating system on which CMake is targeting. This
-variable is the same as :variable:`CMAKE_HOST_SYSTEM_NAME` if you build for the
-host system instead of the target system when cross compiling.
+System Name for Host Builds
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+``CMAKE_SYSTEM_NAME`` is by default set to the same value as the
+:variable:`CMAKE_HOST_SYSTEM_NAME` variable so that the build
+targets the host system.
+
+System Name for Cross Compiling
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+``CMAKE_SYSTEM_NAME`` may be set explicitly when first configuring a new build
+tree in order to enable :ref:`cross compiling <Cross Compiling Toolchain>`.
+In this case the :variable:`CMAKE_SYSTEM_VERSION` variable must also be
+set explicitly.