summaryrefslogtreecommitdiffstats
path: root/Help/policy/CMP0008.rst
diff options
context:
space:
mode:
authorBartosz Kosiorek <bartosz.kosiorek@tomtom.com>2019-03-26 15:13:41 (GMT)
committerBartosz Kosiorek <bartosz.kosiorek@tomtom.com>2019-03-27 15:01:20 (GMT)
commit07f3082d3b52f1bcba8dd4ef82b3e02c362b392e (patch)
tree36eb4256e37351a30273b3852c2d799c0e2e2e03 /Help/policy/CMP0008.rst
parentdb20cb2f9f2ff1d00593e0fc921184d99f58749a (diff)
downloadCMake-07f3082d3b52f1bcba8dd4ef82b3e02c362b392e.zip
CMake-07f3082d3b52f1bcba8dd4ef82b3e02c362b392e.tar.gz
CMake-07f3082d3b52f1bcba8dd4ef82b3e02c362b392e.tar.bz2
Help: Improve documentation links and formatting
Diffstat (limited to 'Help/policy/CMP0008.rst')
-rw-r--r--Help/policy/CMP0008.rst14
1 files changed, 7 insertions, 7 deletions
diff --git a/Help/policy/CMP0008.rst b/Help/policy/CMP0008.rst
index f1e2ddd..654a90f 100644
--- a/Help/policy/CMP0008.rst
+++ b/Help/policy/CMP0008.rst
@@ -9,26 +9,26 @@ In CMake 2.4 and below it is possible to write code like
target_link_libraries(myexe /full/path/to/somelib)
-where "somelib" is supposed to be a valid library file name such as
-"libsomelib.a" or "somelib.lib". For Makefile generators this
+where ``somelib`` is supposed to be a valid library file name such as
+``libsomelib.a`` or ``somelib.lib``. For Makefile generators this
produces an error at build time because the dependency on the full
path cannot be found. For VS IDE and Xcode generators this used to
work by accident because CMake would always split off the library
directory and ask the linker to search for the library by name
-(-lsomelib or somelib.lib). Despite the failure with Makefiles, some
+(``-lsomelib`` or ``somelib.lib``). Despite the failure with Makefiles, some
projects have code like this and build only with VS and/or Xcode.
This version of CMake prefers to pass the full path directly to the
native build tool, which will fail in this case because it does not
name a valid library file.
This policy determines what to do with full paths that do not appear
-to name a valid library file. The OLD behavior for this policy is to
+to name a valid library file. The ``OLD`` behavior for this policy is to
split the library name from the path and ask the linker to search for
-it. The NEW behavior for this policy is to trust the given path and
+it. The ``NEW`` behavior for this policy is to trust the given path and
pass it directly to the native build tool unchanged.
This policy was introduced in CMake version 2.6.1. CMake version
-|release| warns when the policy is not set and uses OLD behavior. Use
-the cmake_policy command to set it to OLD or NEW explicitly.
+|release| warns when the policy is not set and uses ``OLD`` behavior. Use
+the :command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly.
.. include:: DEPRECATED.txt