kolan/CMake
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Merge topic 'doc-FindBoost-updates'

Browse Source 
f53878b FindBoost: Clarify example static libs option (#13663)
a42a665 FindBoost: Refine .rst formatting
This commit is contained in:
Brad King 2013-11-02 10:54:37 -04:00 committed by CMake Topic Stage
commit 443d414047
1 changed files with 12 additions and 33 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
Modules/FindBoost.cmake
View File

@ -4,9 +4,7 @@
# #
# Find Boost include dirs and libraries # Find Boost include dirs and libraries
# #
# Use this module by invoking find_package with the form: # Use this module by invoking find_package with the form::
#
# ::
# #
# find_package(Boost # find_package(Boost
# [version] [EXACT] # Minimum or EXACT version e.g. 1.36.0 # [version] [EXACT] # Minimum or EXACT version e.g. 1.36.0
@ -17,9 +15,7 @@
# This module finds headers and requested component libraries OR a CMake # This module finds headers and requested component libraries OR a CMake
# package configuration file provided by a "Boost CMake" build. For the # package configuration file provided by a "Boost CMake" build. For the
# latter case skip to the "Boost CMake" section below. For the former # latter case skip to the "Boost CMake" section below. For the former
# case results are reported in variables: # case results are reported in variables::
#
# ::
# #
# Boost_FOUND - True if headers and requested libraries were found # Boost_FOUND - True if headers and requested libraries were found
# Boost_INCLUDE_DIRS - Boost include directories # Boost_INCLUDE_DIRS - Boost include directories
@ -38,11 +34,7 @@
# information about Boost's automatic linking # information about Boost's automatic linking
# displayed during compilation # displayed during compilation
# #
# # This module reads hints about search locations from variables::
#
# This module reads hints about search locations from variables:
#
# ::
# #
# BOOST_ROOT - Preferred installation prefix # BOOST_ROOT - Preferred installation prefix
# (or BOOSTROOT) # (or BOOSTROOT)
@ -54,9 +46,7 @@
# - List of Boost versions not known to this module # - List of Boost versions not known to this module
# (Boost install locations may contain the version) # (Boost install locations may contain the version)
# #
# and saves search results persistently in CMake cache entries: # and saves search results persistently in CMake cache entries::
#
# ::
# #
# Boost_INCLUDE_DIR - Directory containing Boost headers # Boost_INCLUDE_DIR - Directory containing Boost headers
# Boost_LIBRARY_DIR - Directory containing Boost libraries # Boost_LIBRARY_DIR - Directory containing Boost libraries
@ -83,9 +73,7 @@
# #
# Boost libraries come in many variants encoded in their file name. # Boost libraries come in many variants encoded in their file name.
# Users or projects may tell this module which variant to find by # Users or projects may tell this module which variant to find by
# setting variables: # setting variables::
#
# ::
# #
# Boost_USE_MULTITHREADED - Set to OFF to use the non-multithreaded # Boost_USE_MULTITHREADED - Set to OFF to use the non-multithreaded
# libraries ('mt' tag). Default is ON. # libraries ('mt' tag). Default is ON.
@ -109,9 +97,7 @@
# such as "pthread" or "win32". Names with # such as "pthread" or "win32". Names with
# and without this suffix will both be tried. # and without this suffix will both be tried.
# #
# Other variables one may set to control this module are: # Other variables one may set to control this module are::
#
# ::
# #
# Boost_DEBUG - Set to ON to enable debug output from FindBoost. # Boost_DEBUG - Set to ON to enable debug output from FindBoost.
# Please enable this before filing any bug report. # Please enable this before filing any bug report.
@ -132,17 +118,13 @@
# to be linked explicitly or available in the link library search path. # to be linked explicitly or available in the link library search path.
# In this case setting Boost_USE_STATIC_LIBS to OFF may not achieve # In this case setting Boost_USE_STATIC_LIBS to OFF may not achieve
# dynamic linking. Boost automatic linking typically requests static # dynamic linking. Boost automatic linking typically requests static
# libraries with a few exceptions (such as Boost.Python). Use # libraries with a few exceptions (such as Boost.Python). Use::
#
# ::
# #
# add_definitions(${Boost_LIB_DIAGNOSTIC_DEFINITIONS}) # add_definitions(${Boost_LIB_DIAGNOSTIC_DEFINITIONS})
# #
# to ask Boost to report information about automatic linking requests. # to ask Boost to report information about automatic linking requests.
# #
# Example to find Boost headers only: # Example to find Boost headers only::
#
# ::
# #
# find_package(Boost 1.36.0) # find_package(Boost 1.36.0)
# if(Boost_FOUND) # if(Boost_FOUND)
@ -150,11 +132,9 @@
# add_executable(foo foo.cc) # add_executable(foo foo.cc)
# endif() # endif()
# #
# Example to find Boost headers and some libraries: # Example to find Boost headers and some *static* libraries::
# #
# :: # set(Boost_USE_STATIC_LIBS ON) # only find static libs
#
# set(Boost_USE_STATIC_LIBS ON)
# set(Boost_USE_MULTITHREADED ON) # set(Boost_USE_MULTITHREADED ON)
# set(Boost_USE_STATIC_RUNTIME OFF) # set(Boost_USE_STATIC_RUNTIME OFF)
# find_package(Boost 1.36.0 COMPONENTS date_time filesystem system ...) # find_package(Boost 1.36.0 COMPONENTS date_time filesystem system ...)
@ -164,9 +144,8 @@
# target_link_libraries(foo ${Boost_LIBRARIES}) # target_link_libraries(foo ${Boost_LIBRARIES})
# endif() # endif()
# #
# # Boost CMake
# # ^^^^^^^^^^^
# Boost CMake ----------------------------------------------------------
# #
# If Boost was built using the boost-cmake project it provides a package # If Boost was built using the boost-cmake project it provides a package
# configuration file for use with find_package's Config mode. This # configuration file for use with find_package's Config mode. This