summaryrefslogtreecommitdiffstats
path: root/Help/generator/Visual Studio 15 2017.rst
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2018-09-24 19:00:46 (GMT)
committerBrad King <brad.king@kitware.com>2018-09-25 10:52:35 (GMT)
commit15e211df803a7bcfeefc7b2aa91741f308fb609c (patch)
treed342b89799949c56e824b6af943a28f5b71c5063 /Help/generator/Visual Studio 15 2017.rst
parent03ffd442bd34e2a3478b125ef1055837926bcd0c (diff)
downloadCMake-15e211df803a7bcfeefc7b2aa91741f308fb609c.zip
CMake-15e211df803a7bcfeefc7b2aa91741f308fb609c.tar.gz
CMake-15e211df803a7bcfeefc7b2aa91741f308fb609c.tar.bz2
Help: Suggest using -A to specify platform for VS generators
We already suggest `-T` for the toolset. Create a dedicated section for platform selection and suggest `-A`. Provide examples.
Diffstat (limited to 'Help/generator/Visual Studio 15 2017.rst')
-rw-r--r--Help/generator/Visual Studio 15 2017.rst34
1 files changed, 22 insertions, 12 deletions
diff --git a/Help/generator/Visual Studio 15 2017.rst b/Help/generator/Visual Studio 15 2017.rst
index 809be4b..42a3bb6 100644
--- a/Help/generator/Visual Studio 15 2017.rst
+++ b/Help/generator/Visual Studio 15 2017.rst
@@ -3,18 +3,6 @@ Visual Studio 15 2017
Generates Visual Studio 15 (VS 2017) project files.
-The :variable:`CMAKE_GENERATOR_PLATFORM` variable may be set
-to specify a target platform name (architecture).
-
-For compatibility with CMake versions prior to 3.1, one may specify
-a target platform name optionally at the end of this generator name:
-
-``Visual Studio 15 2017 Win64``
- Specify target platform ``x64``.
-
-``Visual Studio 15 2017 ARM``
- Specify target platform ``ARM``.
-
Project Types
^^^^^^^^^^^^^
@@ -37,6 +25,28 @@ one of the instances, that instance will be used. Otherwise, if more
than one instance is installed we do not define which one is chosen
by default.
+Platform Selection
+^^^^^^^^^^^^^^^^^^
+
+The :variable:`CMAKE_GENERATOR_PLATFORM` variable may be set, perhaps
+via the :manual:`cmake(1)` ``-A`` option, to specify a target platform
+name (architecture). For example:
+
+* ``cmake -G "Visual Studio 15 2017" -A Win32``
+* ``cmake -G "Visual Studio 15 2017" -A x64``
+* ``cmake -G "Visual Studio 15 2017" -A ARM``
+* ``cmake -G "Visual Studio 15 2017" -A ARM64``
+
+For compatibility with CMake versions prior to 3.1, one may specify
+a target platform name optionally at the end of the generator name.
+This is supported only for:
+
+``Visual Studio 15 2017 Win64``
+ Specify target platform ``x64``.
+
+``Visual Studio 15 2017 ARM``
+ Specify target platform ``ARM``.
+
Toolset Selection
^^^^^^^^^^^^^^^^^