summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2015-04-22 13:23:49 (GMT)
committerBrad King <brad.king@kitware.com>2015-04-22 13:29:55 (GMT)
commit941e3bd2b63769a0b91224c0d038e13b6cae6255 (patch)
tree6e8a99dedafe38d17b0f18341a2aeb0b1e5898f4
parent5a5ef00106662da5c6400d76438289f505b4a1ff (diff)
downloadCMake-941e3bd2b63769a0b91224c0d038e13b6cae6255.zip
CMake-941e3bd2b63769a0b91224c0d038e13b6cae6255.tar.gz
CMake-941e3bd2b63769a0b91224c0d038e13b6cae6255.tar.bz2
Help: Document in find_library how to search for static libraries
This has been implemented since commit v2.6.0~295 (Make find_library test for the library file as named, 2008-02-06). Add the docs.
-rw-r--r--Help/command/find_library.rst6
1 files changed, 6 insertions, 0 deletions
diff --git a/Help/command/find_library.rst b/Help/command/find_library.rst
index 09df688..e3dcd2b 100644
--- a/Help/command/find_library.rst
+++ b/Help/command/find_library.rst
@@ -34,6 +34,12 @@ default will consider one name at a time and search every directory
for it. The NAMES_PER_DIR option tells this command to consider one
directory at a time and search for all names in it.
+Each library name given to the ``NAMES`` option is first considered
+as a library file name and then considered with platform-specific
+prefixes (e.g. ``lib``) and suffixes (e.g. ``.so``). Therefore one
+may specify library file names such as ``libfoo.a`` directly.
+This can be used to locate static libraries on UNIX-like systems.
+
If the library found is a framework, then VAR will be set to the full
path to the framework <fullPath>/A.framework. When a full path to a
framework is used as a library, CMake will use a -framework A, and a