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

This new property controls whether to apply INSTALL_NAME_DIR to the
build tree.  It also overrides BUILD_WITH_INSTALL_RPATH.

Since commit v3.8.0-rc1~232^2 (execute_process: Add ENCODING option for
Windows child process output, 2016-11-23) we decode child process output
using the console's active codepage by default.  This differs from
previous versions of CMake and is therefore incompatible.  Changing this
default will require a policy, so for now revert the default behavior
back to performing no decoding.
Reported-by: Nils Gladitz <nilsgladitz@gmail.com>

Spell out the options in a definition list and document each one.

Robert Maynard authored Feb 08, 2017 and Brad King committed Feb 10, 2017

The `nvcc -v` output provides what include directories need to be added
to use the CUDA toolkit from other languages ( C/C++ ).

Some of our "cmake" code blocks do not use fully valid CMake syntax
because they have placeholders for human reference.  Sphinx has
never been able to properly lex and highlight these, but now warns.
Fix each block's syntax or change to a non-cmake block as appropriate.

Evgeny Fimochkin authored Jan 27, 2017 and Brad King committed Feb 07, 2017

Fixes: #16469

Bradley Lowekamp authored Feb 06, 2017 and Brad King committed Feb 07, 2017

Extract the `gtest_add_tests` macro from `FindGTest` into a separate
module. GTest or GoogleTest can be used by a project in a several
different ways, including installed libraries in the system, from an
ExternalProject, or adding the GTest source directory as a sub directory
of the project. As not all of these uses are supported by the FindGTest
module the useful `gtest_add_tests` macro is separated to easily enable
reuse.

Issue: #14151

Sébastien GALLOU authored Feb 06, 2017 and Brad King committed Feb 06, 2017

Add a `Protobuf_USE_STATIC_LIBS` input variable to optionally restrict
searches to static library names.  This follows the approach of
`FindBoost`.

Nils Gladitz authored Feb 03, 2017 and Brad King committed Feb 06, 2017

The new variable allows specification of a custom root folder ID.
The implicit default is "ProgramFiles<64>Folder".

The "<64>" token is replaced by "" for 32-bit and "64" for 64-bit builds.

Inspired-By: Eric Backus
Fixes: #16573

Release versions do not have the development topic section of
the CMake Release Notes index page.

Add section headers similar to the 3.7 release notes and move each
individual bullet into an appropriate section.  Revise a few bullets.

Move all development release notes into a new version-specific document:

    tail -q -n +3 Help/release/dev/* > Help/release/3.8.rst
    git rm -- Help/release/dev/*

except the sample topic:

    git checkout HEAD -- Help/release/dev/0-sample-topic.rst

Reference the new document from the release notes index document.
Add a title and intro sentence to the new document by hand.

Include each language name in the text of the link to its standards
property.

Issue: #16616

Fixes: #16616