[pkgsrc/trunk]: pkgsrc/devel/scons devel/scons: Explain about common woes

[gdt <gdt%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/48d493a94059
branches:  trunk
changeset: 333140:48d493a94059
user:      gdt <gdt%pkgsrc.org@localhost>
date:      Tue Apr 30 22:14:57 2019 +0000

description:
devel/scons: Explain about common woes

diffstat:

 devel/scons/buildlink3.mk |  13 ++++++++++++-
 1 files changed, 12 insertions(+), 1 deletions(-)

diffs (20 lines):

diff -r 280331d287d0 -r 48d493a94059 devel/scons/buildlink3.mk
--- a/devel/scons/buildlink3.mk Tue Apr 30 21:54:54 2019 +0000
+++ b/devel/scons/buildlink3.mk Tue Apr 30 22:14:57 2019 +0000
@@ -1,4 +1,15 @@
-# $NetBSD: buildlink3.mk,v 1.1 2019/01/02 17:18:47 tnn Exp $
+# $NetBSD: buildlink3.mk,v 1.2 2019/04/30 22:14:57 gdt Exp $
+
+# Note that while scons is a build tool, it requires running a python
+# program on the host that uses the scons library.  Currently, the
+# python version on the host and the version being used on the target
+# for the package being built are linked.
+# \todo Consider if this can be BUILD_DEPENDS (or TOOL), instead of buildlink.
+
+# scons scripts (SConstruct) have a number of common problems,
+# including not passing environment variables set by pkgsrc to
+# invocations of the compiler.  See the
+# /usr/pkgsrc/*/*/patch-SConstruct for typical remediations.
 
 SCONSBIN=      ${PREFIX}/bin/scons