summaryrefslogtreecommitdiff
path: root/solenv
diff options
context:
space:
mode:
authorMichael Stahl <mstahl@redhat.com>2015-06-01 14:37:28 +0200
committerMichael Stahl <mstahl@redhat.com>2015-06-01 16:36:32 +0200
commit6b5d7b238b5471c23bfe05a1b1643e52c6c55c72 (patch)
treefec83a6f36d3c333dc72b7b4806358877713b303 /solenv
parent241083066c1e7c94d9e7a4240751e775eb023829 (diff)
gbuild: document what CFLAGS/CXXFLAGS etc. *actually* do
Looks like following GNU build system standards isn't necessarily the best idea, if even the documentation gets it wrong. Also document the ENVCFLAGS/ENVCFLAGSCXX variables. see also: i#116959 and: http://www.gnu.org/software/autoconf/manual/standards.html#Command-Variables Change-Id: I56d8623cbbc800ef80da1610f6fd104ac29beaf9 (cherry picked from commit d3171eb7d0291e3020d542cfc06d0725e039dbfb)
Diffstat (limited to 'solenv')
-rw-r--r--solenv/gbuild/gbuild.help.txt21
1 files changed, 13 insertions, 8 deletions
diff --git a/solenv/gbuild/gbuild.help.txt b/solenv/gbuild/gbuild.help.txt
index be744fc4b9df..adb9634209b9 100644
--- a/solenv/gbuild/gbuild.help.txt
+++ b/solenv/gbuild/gbuild.help.txt
@@ -108,14 +108,19 @@ INTERACTIVE VARIABLES:
PARALLELISM If not empty, pass argument on as the -j switch
to recursive make invocations. Useful to
lower/increase build parallelism individually.
- LEXFLAGS Add as flags for LEX scanner generator invocation.
- YACCFLAGS Add as flags for YACC parser generator invocation.
- CPPFLAGS Add as preprocessor flags for C/C++/ObjC/ObjC++ compilation.
- CFLAGS Add as compiler flags for plain C compilation.
- CXXFLAGS Add as compiler flags for C++ compilation.
- OBJCFLAGS Add as compiler flags for Objective C compilation.
- OBJCXXFLAGS Add as compiler flags for Objective C++ compilation.
- LDFLAGS Add as linker flags.
+ LEXFLAGS Append flags for LEX scanner generator invocation.
+ YACCFLAGS Append flags for YACC parser generator invocation.
+ CPPFLAGS Append preprocessor flags for C/C++/ObjC/ObjC++ compilation.
+ CFLAGS Override compiler flags for plain C compilation.
+ ENVCFLAGS Append compiler flags for plain C compilation.
+ CXXFLAGS Override compiler flags for C++ compilation.
+ Note: this overrides default optimization and debug
+ flags; to append flags without overriding, use:
+ CXXFLAGS='$(call gb_LinkTarget__get_debugcxxflags,$(1)) -Wfoo'
+ ENVCFLAGSCXX Append compiler flags for C++ compilation.
+ OBJCFLAGS Override compiler flags for Objective C compilation.
+ OBJCXXFLAGS Override compiler flags for Objective C++ compilation.
+ LDFLAGS Override linker flags.
gb_FULLDEPS Generate and use dependencies (on by default, handle with care).
gb_COLOR Use ASCII color output.
gb_TITLES Show progress in terminal title.