1Visual Studio 12 2013
2---------------------
3
4Generates Visual Studio 12 (VS 2013) project files.
5
6For compatibility with CMake versions prior to 3.0, one may specify this
7generator using the name "Visual Studio 12" without the year component.
8
9Project Types
10^^^^^^^^^^^^^
11
12Only Visual C++ and C# projects may be generated (and Fortran with
13Intel compiler integration).  Other types of projects (JavaScript,
14Powershell, Python, etc.) are not supported.
15
16Platform Selection
17^^^^^^^^^^^^^^^^^^
18
19The default target platform name (architecture) is ``Win32``.
20
21.. versionadded:: 3.1
22  The :variable:`CMAKE_GENERATOR_PLATFORM` variable may be set, perhaps
23  via the :manual:`cmake(1)` ``-A`` option, to specify a target platform
24  name (architecture).  For example:
25
26  * ``cmake -G "Visual Studio 12 2013" -A Win32``
27  * ``cmake -G "Visual Studio 12 2013" -A x64``
28  * ``cmake -G "Visual Studio 12 2013" -A ARM``
29
30For compatibility with CMake versions prior to 3.1, one may specify
31a target platform name optionally at the end of the generator name.
32This is supported only for:
33
34``Visual Studio 12 2013 Win64``
35  Specify target platform ``x64``.
36
37``Visual Studio 12 2013 ARM``
38  Specify target platform ``ARM``.
39
40Toolset Selection
41^^^^^^^^^^^^^^^^^
42
43The ``v120`` toolset that comes with Visual Studio 12 2013 is selected by
44default.  The :variable:`CMAKE_GENERATOR_TOOLSET` option may be set, perhaps
45via the :manual:`cmake(1)` ``-T`` option, to specify another toolset.
46
47.. |VS_TOOLSET_HOST_ARCH_DEFAULT| replace::
48   By default this generator uses the 32-bit variant even on a 64-bit host.
49
50.. include:: VS_TOOLSET_HOST_ARCH_LEGACY.txt
51