summaryrefslogtreecommitdiff
path: root/Help
diff options
context:
space:
mode:
authorFelix Geyer <fgeyer@debian.org>2015-08-20 14:13:28 +0200
committerBrad King <brad.king@kitware.com>2015-08-20 10:45:09 -0400
commitf799ffb5cb895855ac2aba54765622b81db5be38 (patch)
tree211d48c7fa168fe7945939de227a396302e65dce /Help
parent899458ab20876aeea915a59e9bfb459d92d264de (diff)
downloadcmake-f799ffb5cb895855ac2aba54765622b81db5be38.tar.gz
Do not set SONAME for MODULE library targets (#15705)
The SONAME field is only useful for shared libraries that application link against.
Diffstat (limited to 'Help')
-rw-r--r--Help/prop_tgt/NO_SONAME.rst6
-rw-r--r--Help/release/dev/modules-no-soname.rst7
2 files changed, 10 insertions, 3 deletions
diff --git a/Help/prop_tgt/NO_SONAME.rst b/Help/prop_tgt/NO_SONAME.rst
index fc668b588e..ee45ed8497 100644
--- a/Help/prop_tgt/NO_SONAME.rst
+++ b/Help/prop_tgt/NO_SONAME.rst
@@ -1,11 +1,11 @@
NO_SONAME
---------
-Whether to set "soname" when linking a shared library or module.
+Whether to set "soname" when linking a shared library.
-Enable this boolean property if a generated shared library or module
+Enable this boolean property if a generated shared library
should not have "soname" set. Default is to set "soname" on all
-shared libraries and modules as long as the platform supports it.
+shared libraries as long as the platform supports it.
Generally, use this property only for leaf private libraries or
plugins. If you use it on normal shared libraries which other targets
link against, on some platforms a linker will insert a full path to
diff --git a/Help/release/dev/modules-no-soname.rst b/Help/release/dev/modules-no-soname.rst
new file mode 100644
index 0000000000..8fe74f8eb1
--- /dev/null
+++ b/Help/release/dev/modules-no-soname.rst
@@ -0,0 +1,7 @@
+modules-no-soname
+-----------------
+
+* The ``SONAME`` field is no longer set for ``MODULE`` libraries
+ created with the :command:`add_library` command. ``MODULE``
+ libraries are meant for explicit dynamic loading at runtime.
+ They cannot be linked so ``SONAME`` is not useful.