summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--doc/man/scons.122
-rw-r--r--src/CHANGES.txt3
2 files changed, 22 insertions, 3 deletions
diff --git a/doc/man/scons.1 b/doc/man/scons.1
index a2f265f..3d5691e 100644
--- a/doc/man/scons.1
+++ b/doc/man/scons.1
@@ -71,10 +71,25 @@ in the local directory,
will internally change its working
directory (chdir) to the directory containing the file.
+The
+.I SConstruct
+file can specify subsidiary
+configuration files using the
+.B SConscript()
+function.
+By convention,
+these subsidiary files are named
+.IR SConscript ,
+although any name may be used.
+(Because of this naming convention,
+the term "SConscript files"
+is sometimes used to refer
+generically to all
+.B scons
+configuration files,
+regardless of actual file name.)
+
The configuration files
-(generically referred to as
-.I SConscript
-files)
specify the target files to be built, and
(optionally) the rules to build those targets. Reasonable default
rules exist for building common software components (executable
@@ -913,6 +928,7 @@ function:
.ES
bar_obj = env.StaticObject('bar.c', CCFLAGS='-DBAR')
print "The path to bar_obj is:", str(bar_obj)
+.EE
.B scons
provides the following builders:
diff --git a/src/CHANGES.txt b/src/CHANGES.txt
index 4e1ffec..48c7e08 100644
--- a/src/CHANGES.txt
+++ b/src/CHANGES.txt
@@ -44,6 +44,9 @@ RELEASE 0.10 - XXX
multiple source files specified; the target is now deduced from just
the first source file in the list.
+ - Documentation fixes: better initial explanation of SConscript files;
+ fix a misformatted "table" in the StaticObject explanation.
+
From Steve Leblanc:
- Add a Clean() method to support removing user-specified targets