From 04a4ac68d5320f02f30c4d24ff62a8322ea84dc0 Mon Sep 17 00:00:00 2001 From: becker33 Date: Wed, 4 Oct 2017 18:32:13 -0700 Subject: [PATCH] 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. --- lib/spack/docs/packaging_guide.rst | 5 +++++ 1 file changed, 5 insertions(+) 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