changeset 1165:8d2032c88258

vanilla: add note about static and shared libraries
author David Demelier <markand@malikania.fr>
date Tue, 08 Oct 2019 20:06:00 +0200
parents 872dc291306a
children 72824bb09754
files Docs/manual.md
diffstat 1 files changed, 15 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/Docs/manual.md	Tue Oct 08 20:04:00 2019 +0200
+++ b/Docs/manual.md	Tue Oct 08 20:06:00 2019 +0200
@@ -320,6 +320,21 @@
 
 See also the template file in Templates/rc.
 
+Static and shared libraries
+===========================
+
+By default, your package *MUST* ship both static and shared libraries if
+applicable.
+
+If possible, the package should provide the option *STATIC* that should do the
+following if set to *yes*:
+
+- On library packages, disable generation of shared libraries,
+- On executables, build static binaries,
+- If the package provides both, do the two steps.
+
+This option should not be enabled by default unless absolutely necessary.
+
 Libtool files
 =============