commit: 7d4e00f503c79caafc53f931a094a57f144b123b Author: Michał Górny <mgorny <AT> gentoo <DOT> org> AuthorDate: Fri Jan 1 12:14:42 2016 +0000 Commit: Michał Górny <mgorny <AT> gentoo <DOT> org> CommitDate: Fri Jan 8 05:14:36 2016 +0000 URL: https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=7d4e00f5
scons-utils.eclass: Describe common issues with scons 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 used sanely. +# 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 #