Help/generator/Visual Studio 10 2010.rst

   1 Visual Studio 10 2010
   2 ---------------------
   3
   4 Deprecated.  Generates Visual Studio 10 (VS 2010) project files.
   5
   6 .. note::
   7   This generator is deprecated and will be removed in a future version
   8   of CMake.  It will still be possible to build with VS 10 2010 tools
   9   using the :generator:`Visual Studio 11 2012` (or above) generator
  10   with :variable:`CMAKE_GENERATOR_TOOLSET` set to ``v100``, or by
  11   using the :generator:`NMake Makefiles` generator.
  12
  13 For compatibility with CMake versions prior to 3.0, one may specify this
  14 generator using the name ``Visual Studio 10`` without the year component.
  15
  16 Project Types
  17 ^^^^^^^^^^^^^
  18
  19 Only Visual C++ and C# projects may be generated (and Fortran with
  20 Intel compiler integration).  Other types of projects (Database,
  21 Website, etc.) are not supported.
  22
  23 Platform Selection
  24 ^^^^^^^^^^^^^^^^^^
  25
  26 The default target platform name (architecture) is ``Win32``.
  27
  28 .. versionadded:: 3.1
  29   The :variable:`CMAKE_GENERATOR_PLATFORM` variable may be set, perhaps
  30   via the :manual:`cmake(1)` ``-A`` option, to specify a target platform
  31   name (architecture).  For example:
  32
  33   * ``cmake -G "Visual Studio 10 2010" -A Win32``
  34   * ``cmake -G "Visual Studio 10 2010" -A x64``
  35   * ``cmake -G "Visual Studio 10 2010" -A Itanium``
  36
  37 For compatibility with CMake versions prior to 3.1, one may specify
  38 a target platform name optionally at the end of the generator name.
  39 This is supported only for:
  40
  41 ``Visual Studio 10 2010 Win64``
  42   Specify target platform ``x64``.
  43
  44 ``Visual Studio 10 2010 IA64``
  45   Specify target platform ``Itanium``.
  46
  47 Toolset Selection
  48 ^^^^^^^^^^^^^^^^^
  49
  50 The ``v100`` toolset that comes with Visual Studio 10 2010 is selected by
  51 default.  The :variable:`CMAKE_GENERATOR_TOOLSET` option may be set, perhaps
  52 via the :manual:`cmake(1)` ``-T`` option, to specify another toolset.