diff options
author | Brad King <brad.king@kitware.com> | 2018-09-24 19:00:46 (GMT) |
---|---|---|
committer | Brad King <brad.king@kitware.com> | 2018-09-25 10:52:35 (GMT) |
commit | 15e211df803a7bcfeefc7b2aa91741f308fb609c (patch) | |
tree | d342b89799949c56e824b6af943a28f5b71c5063 /Help/generator/Visual Studio 15 2017.rst | |
parent | 03ffd442bd34e2a3478b125ef1055837926bcd0c (diff) | |
download | CMake-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.rst | 34 |
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 ^^^^^^^^^^^^^^^^^ |