From c8b613d261e6ec6619e0c00c1bc5c65379ceebb7 Mon Sep 17 00:00:00 2001 From: Greg Becker Date: Thu, 29 Aug 2019 10:35:48 -0500 Subject: [PATCH] fix packaging_guide variant table (#12296) --- lib/spack/docs/packaging_guide.rst | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/lib/spack/docs/packaging_guide.rst b/lib/spack/docs/packaging_guide.rst index ffaacfd8f1..6c3d7c0602 100644 --- a/lib/spack/docs/packaging_guide.rst +++ b/lib/spack/docs/packaging_guide.rst @@ -3856,7 +3856,6 @@ variant names are: Name Default Description ======= ======== ======================== shared True Build shared libraries - static True Build static libraries mpi True Use MPI python False Build Python extension ======= ======== ======================== @@ -3864,6 +3863,12 @@ variant names are: If specified in this table, the corresponding default should be used when declaring a variant. +The semantics of the `shared` variant are important. When a package is +built `~shared`, the package guarantees that no shared libraries are +built. When a package is built `+shared`, the package guarantees that +shared libraries are built, but it makes no guarantee about whether +static libraries are built. + ^^^^^^^^^^^^^ Version Lists ^^^^^^^^^^^^^