Add a dedicated subsection header for its documentation.

Fixes: #16264.

Move the details about support for generator toolset specification
to the `CMAKE_GENERATOR_TOOLSET` variable documentation.  This is
a more suitable place because it is shared by all means to set this
variable, not just the `cmake -T` option.

Move the details about support for generator platform specification
to the `CMAKE_GENERATOR_PLATFORM` variable documentation.  This is
a more suitable place because it is shared by all means to set this
variable, not just the `cmake -A` option.

Issue: #15441

If `CMAKE_GENERATOR_TOOLSET` does not have a `cuda=...` field then
find available CUDA toolsets and choose the highest version.

The NVIDIA CUDA Toolkit provides MSBuild toolset files for integration
with Visual Studio.  Multiple versions may be installed so we need a way
to tell our VS generators which CUDA toolset to use.  Extend the
`CMAKE_GENERATOR_TOOLSET` specification to provide a `cuda=...` field
specifying the version number.

Wojciech Mamrak authored Mar 08, 2017 and Brad King committed Mar 08, 2017

The value we documented was left from a preview that still used `v140`
tools.  Update it to match the `v141` tools distributed with the final
release.

Steven Newbury authored Feb 27, 2017 and Brad King committed Mar 07, 2017

Detect x32-abi through CMakeCompilerABI infrastruture and use this
information at runtime to determine the correct library paths with
`FIND_LIBRARY_USE_LIBX32_PATHS`.

Fixes: #15994

Teach Sphinx and our own install rules to skip a `Help/dev` directory.
This will give us a place to put developer-only documentation that
should not be included in the user-facing documentation.  Add a
placeholder README.

Christian Schmidbauer authored Feb 25, 2017 and Brad King committed Mar 01, 2017

Add a new `CMAKE_FIND_LIBRARY_CUSTOM_LIB_SUFFIX` variable to allow use
of a custom suffix on `lib` directory names.  This is a more general
option than that added by commit v3.7.0-rc1~504^2 (Teach find_library
and find_package to search lib32 paths, 2016-06-10).  It allows the find
path to be more deterministic on custom setups.

See discussion in #10287 and #15994.

Fixes: #16661

Sebastian Holtermann authored Feb 19, 2017 and Brad King committed Feb 21, 2017

Closes #15254

Tim Hutt authored Feb 14, 2017 and Brad King committed Feb 17, 2017

This allows you to copy custom files (e.g. a background image) into the
macOS installer.

Fixes: #16604

Tim Hutt authored Feb 14, 2017 and Brad King committed Feb 17, 2017

When using the productbuild generator this lets you specify the value of
the `--component-plist` parameter when it runs pkgbuild for a component.

Fixes: #16638

BUILD_WITH_INSTALL_RPATH, SKIP_BUILD_RPATH, CMAKE_SKIP_RPATH and
CMAKE_SKIP_INSTALL_RPATH no longer any effect on the install name
of a target on macOS.

Fixes: #16589