ENH: Added 1.38 since it'll be out soon.  More documentation and clarified examples, addressed autolinking issue on MSVC

BUG: Do not check for GCC version encoding in filenames on Boost libraries prior to 1.35.  Eliminate "lib" prefix except on MSVC.

BUG: Fixes problem with _boost_ABI_TAG appending to itself if FindBoost is called more than once (Issue #7460)

BUG: Removed some code which was squashing Boost_LIBRARIES on WIN32 under the auspices of forcing the user to use autolinking, but it only did this squashing on the first call to FindBoost.  Subsequent calls to FindBoost would not have Boost_LIBRARIES squashed so this code was doing nothing.  If you link your target_link_libraries() against dynamic boost libraries it appears from tools like Dependency Walker that the pragma calls to autolink to the static boost libraries are ignored.  It's therefore too late to make this squash apply to all calls to FindBoost because that would break users that have not setup autolinking properly.   For now this fix is largely cosmetic since the original code never worked anyways (see version 1.5 introduced on 4/22/08).

BUG: Fixed documentation bug with Boost_USE_MULTITHREADED, removed OPTION() call since it would be useless and confusing after an initial configure.

BUG: Fixed superfluous and duplicate dirs in Boost_LIBRARY_DIR.  Employed workaround for Issue #8378.  Resolves Issue #8099

regression for bjam users on Win32 introduced in 1.4.2.4 (7/13/08).  This
commit partially or completely resolves Issues #8173, #8326, #7943, #7725!

Recently we taught find_package to re-find a package configuration file
if it is given a wrong answer.  This fixes the documentation to reflect
the change.

The documentation of cmake_policy PUSH and POP states that they must
always match.  Previously we enforced this only for the top scope of
each CMakeLists.txt file.  This enforces the requirement for all files.

This creates the variable CMAKE_VERSION containing the full version of
cmake in "major.minor.patch" format.  It is particularly useful with the
component-wise version comparison provided by the if() command.

This adds documentation of CMAKE_PATCH_VERSION to the generated
variables documentation.

reporting version x.y and not x.y.z

This uses an automatic variable to push and pop variable scope inside a
function call.  Previously if the function failed its scope would not be
popped.  This approach guarantees a balanced push/pop.

The Borland 5.5 compiler's STL set does not define correct signatures
for its find() members, leading to build errors.  This works around the
problem.

Recently we taught find_package to re-find a package if its
<package>_DIR result variable was set to a location not containing the
package (instead of reporting an error as before).  This tests the
feature.

This adds a PARTS option to the ctest_submit command which tells it to
submit only parts whose names are listed with the option.

This splits the list of files for CTest to submit into those belonging
to each part.  The set is recombined just before submission.  Later this
will allow piecewise submissions.

This introduces the name "part" to denote a portion of the testing and
submission process performed by ctest.  We generalize the boolean
indicating whether each part is enabled into a structure to which more
information can be added later.  We provide bi-directional mapping
between part id and part names.

This adds an APPEND option to the ctest_* commands which tells them to
put the Append="true" attribute in the Site element of their XML file.

The previous approach to handling of arguments to ctest_* commands
worked only for keyword/value arguments with a single value.  This
refactors the approach to allow some commands to define alternative
argument forms.