--- eclass/scons-utils.eclass | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-)
diff --git a/eclass/scons-utils.eclass b/eclass/scons-utils.eclass index 2c52b59..4b1fe49 100644 --- a/eclass/scons-utils.eclass +++ b/eclass/scons-utils.eclass @@ -9,8 +9,23 @@ # @DESCRIPTION: # This eclass provides a set of function to help developers sanely call # dev-util/scons and pass parameters to it. -# @EXAMPLE: # +# Please note that SCons is more like a 'build system creation kit', +# and requires a lot of upstream customization to be useful. +# You will often need to request fixes upstream and/or patch the build +# system. In particular: +# +# 1. There are no 'standard' variables. To respect CC, CXX, CFLAGS, +# CXXFLAGS, CPPFLAGS, LDFLAGS, upstream needs to define appropriate +# variables explicitly. In some cases, upstreams respect envvars, +# in others you need to pass them as options. +# +# 2. SCons scrubs out environment by default and replaces it with some +# pre-defined values. To respect environment variables such as PATH, +# upstreams need to explicitly get them from os.environ and copy them +# to the build environment. +# +# @EXAMPLE: # @CODE # inherit scons-utils toolchain-funcs # -- 2.6.4
