summaryrefslogtreecommitdiff
path: root/lib
diff options
context:
space:
mode:
authorbecker33 <becker33@llnl.gov>2017-10-04 18:32:13 -0700
committerscheibelp <scheibel1@llnl.gov>2017-10-04 18:32:13 -0700
commit04a4ac68d5320f02f30c4d24ff62a8322ea84dc0 (patch)
tree1708375d7d2e61488119eb699628c0f84e2013ef /lib
parent328ab328be6025a5782391eb4ef63474dee6c492 (diff)
downloadspack-04a4ac68d5320f02f30c4d24ff62a8322ea84dc0.tar.gz
spack-04a4ac68d5320f02f30c4d24ff62a8322ea84dc0.tar.bz2
spack-04a4ac68d5320f02f30c4d24ff62a8322ea84dc0.tar.xz
spack-04a4ac68d5320f02f30c4d24ff62a8322ea84dc0.zip
Identify the flag handlers feature as beta (#5609)
The flag-handling logic added in #4421 may change semantics, so this commit adds a warning to the documentation for this feature.
Diffstat (limited to 'lib')
-rw-r--r--lib/spack/docs/packaging_guide.rst5
1 files changed, 5 insertions, 0 deletions
diff --git a/lib/spack/docs/packaging_guide.rst b/lib/spack/docs/packaging_guide.rst
index 4a977205db..ac89f9724a 100644
--- a/lib/spack/docs/packaging_guide.rst
+++ b/lib/spack/docs/packaging_guide.rst
@@ -2572,6 +2572,11 @@ passes those flags to the relevant environment variables (``CFLAGS``,
packages, the default behavior is to inject the flags directly into the
compiler commands using Spack's compiler wrappers.
+.. warning::
+
+ The flag handling methods described in this section are in beta.
+ The exact semantics are liable to change to improve usability.
+
Individual packages can override the default behavior for the flag
handling. Packages can define a ``default_flag_handler`` method that
applies to all sets of flags handled by Spack, or may define