summaryrefslogtreecommitdiff
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2015-08-17 10:25:04 -0400
committerCMake Topic Stage <kwrobot@kitware.com>2015-08-17 10:25:04 -0400
commita38ea312c02eec6e4ee61015f70920999bf79ff9 (patch)
tree0e5b9188bd5cc21f2fc0ee2a0c6601fe3504470a /Help
parentbc9103ed5b326b480140b43934bb762f9c9ec5f5 (diff)
parent7f0b83e0185f4e131110a61d898cec4a96bd9a7d (diff)
downloadcmake-a38ea312c02eec6e4ee61015f70920999bf79ff9.tar.gz
Merge topic 'propagate-link-search-to-try_compile'
7f0b83e0 try_compile: Update documentation for other propagated variables fb77c2c5 try_compile: Propogate the CMAKE_LINK_SEARCH_ variables
Diffstat (limited to 'Help')
-rw-r--r--Help/command/try_compile.rst11
-rw-r--r--Help/variable/CMAKE_LINK_SEARCH_END_STATIC.rst5
-rw-r--r--Help/variable/CMAKE_LINK_SEARCH_START_STATIC.rst5
-rw-r--r--Help/variable/CMAKE_POSITION_INDEPENDENT_CODE.rst9
4 files changed, 22 insertions, 8 deletions
diff --git a/Help/command/try_compile.rst b/Help/command/try_compile.rst
index 9a70885200..1ed24df701 100644
--- a/Help/command/try_compile.rst
+++ b/Help/command/try_compile.rst
@@ -96,5 +96,16 @@ the try_compile call of interest, and then re-run cmake again with
Other Behavior Settings
^^^^^^^^^^^^^^^^^^^^^^^
+If set, the following variables are passed in to the generated
+try_compile CMakeLists.txt to initialize compile target properties with
+default values:
+
+* :variable:`CMAKE_LINK_SEARCH_START_STATIC`
+* :variable:`CMAKE_LINK_SEARCH_END_STATIC`
+* :variable:`CMAKE_POSITION_INDEPENDENT_CODE`
+
+If :policy:`CMP0056` is set to ``NEW``, then
+:variable:`CMAKE_EXE_LINKER_FLAGS` is passed in as well.
+
Set the :variable:`CMAKE_TRY_COMPILE_CONFIGURATION` variable to choose
a build configuration.
diff --git a/Help/variable/CMAKE_LINK_SEARCH_END_STATIC.rst b/Help/variable/CMAKE_LINK_SEARCH_END_STATIC.rst
index 8a9951d5a2..673f5d851c 100644
--- a/Help/variable/CMAKE_LINK_SEARCH_END_STATIC.rst
+++ b/Help/variable/CMAKE_LINK_SEARCH_END_STATIC.rst
@@ -13,6 +13,7 @@ back to its starting type. This property switches the final linker
search type to -Bstatic regardless of how it started.
This variable is used to initialize the target property
-LINK_SEARCH_END_STATIC for all targets.
+:prop_tgt:`LINK_SEARCH_END_STATIC` for all targets. If set, it's
+value is also used by the :command:`try_compile` command.
-See also CMAKE_LINK_SEARCH_START_STATIC.
+See also :variable:`CMAKE_LINK_SEARCH_START_STATIC`.
diff --git a/Help/variable/CMAKE_LINK_SEARCH_START_STATIC.rst b/Help/variable/CMAKE_LINK_SEARCH_START_STATIC.rst
index 715db4b078..223702c4dc 100644
--- a/Help/variable/CMAKE_LINK_SEARCH_START_STATIC.rst
+++ b/Help/variable/CMAKE_LINK_SEARCH_START_STATIC.rst
@@ -14,6 +14,7 @@ when linking an executable statically (e.g. with the GNU -static
option).
This variable is used to initialize the target property
-LINK_SEARCH_START_STATIC for all targets.
+:prop_tgt:`LINK_SEARCH_START_STATIC` for all targets. If set, it's
+value is also used by the :command:`try_compile` command.
-See also CMAKE_LINK_SEARCH_END_STATIC.
+See also :variable:`CMAKE_LINK_SEARCH_END_STATIC`.
diff --git a/Help/variable/CMAKE_POSITION_INDEPENDENT_CODE.rst b/Help/variable/CMAKE_POSITION_INDEPENDENT_CODE.rst
index 5e71665670..43b1397eb8 100644
--- a/Help/variable/CMAKE_POSITION_INDEPENDENT_CODE.rst
+++ b/Help/variable/CMAKE_POSITION_INDEPENDENT_CODE.rst
@@ -1,8 +1,9 @@
CMAKE_POSITION_INDEPENDENT_CODE
-------------------------------
-Default value for POSITION_INDEPENDENT_CODE of targets.
+Default value for :prop_tgt:`POSITION_INDEPENDENT_CODE` of targets.
-This variable is used to initialize the POSITION_INDEPENDENT_CODE
-property on all the targets. See that target property for additional
-information.
+This variable is used to initialize the
+:prop_tgt:`POSITION_INDEPENDENT_CODE` property on all the targets.
+See that target property for additional information. If set, it's
+value is also used by the :command:`try_compile` command.