2 # __FILE__ __REVISION__ __DATE__ __DEVELOPER__
5 SCons - a software construction tool
15 - Fix Java parsing to avoid erroneously identifying a new array
16 of class instances as an anonymous inner class.
18 - Fix a typo in the man page description of PathIsDirCreate.
20 - Fix the intelc.py Tool module to not throw an exception if the
21 only installed version is something other than ia32.
25 - Allow Help() to be called multiple times, appending to the help
28 - Allow Tools found on a toolpath to import Python modules from
29 their local directory.
31 - Have the environment store the toolpath and re-use it to find Tools
32 modules during later Copy() or Tool() calls (unless overridden).
34 - Normalize the directory path names in SConsignFile() database
35 files so the same signature file can interoperate on Windows and
38 - Make --debug=stacktrace print a stacktrace when a UserError is thrown.
40 - Remove an old, erroneous cut-and-paste comment in Scanner/Dir.py.
42 From Stanislav Baranov:
44 - Make it possible to support with custom Alias (sub-)classes.
46 - Allow Builders to take empty source lists when called.
48 - Allow access to both TARGET and SOURCE in $*PATH expansions.
50 - Allow SConscript files to modify BUILD_TARGETS.
52 - Add a separate MSVSSolution() Builder, with support for the
53 following new construction variables: $MSVSBUILDCOM, $MSVSCLEANCOM,
54 $MSVSENCODING, $MSVSREBUILDCOM, $MSVSSCONS, $MSVSSCONSCOM,
55 $MSVSSCONSFLAGS, $MSVSSCONSCRIPT and $MSVSSOLUTIONCOM.
59 - Add support for Objective C/C++ .m and .mm file suffixes (for
62 From Steve Christensen:
64 - Handle exceptions from Python functions as build actions.
66 - Add a set of canned PathOption validators: PathExists (the default),
67 PathIsFile, PathIsDir and PathIsDirCreate.
71 - Fix the PharLap linkloc.py module to use target+source arguments
72 when calling env.subst().
76 - Add support for .lex and .yacc file suffixes for Lex and Yacc files.
80 - Fix an incorrect Command() keyword argument in the man page.
82 - Add a $TEMPFILEPREFIX variable to control the prefix or flag used
83 to pass a long-command-line-execution tempfile to a command.
87 - Huge performance improvement: wrap the tuples representing an
88 include path in an object, so that the time it takes to hash the
89 path doesn't grow porportionally to the length of the path.
91 From Gottfried Ganssauge:
93 - Fix SCons on SuSE/AMD-64 Linux by having the wrapper script also
94 check for the build engine in the parent directory of the Python
95 library directory (/usr/lib64 instead of /usr/lib).
97 From Ralph W. Grosse-Kunstleve and Patrick Mezard:
99 - Remove unneceesary (and incorrect) SCons.Util strings on some function
104 - Fix C/C++ compiler selection on AIX to not always use the external $CC
105 environment variable.
107 From August Hörandl:
109 - Add a scanner for \include and \import files, with support for
110 searching a directory list in $TEXINPUTS (imported from the external
113 - Support $MAKEINDEX, $MAKEINDEXCOM, $MAKEINDEXCOMSTR and
114 $MAKEINDEXFLAGS for generating indices from .idx files.
116 From Stephen Kennedy:
118 - Speed up writing the .sconsign file at the end of a run by only
119 calling sync() once at the end, not after every entry.
123 - When compiling with Microsoft Visual Studio, don't include the ATL and
124 MFC directories in the default INCLUDE and LIB environment variables.
126 - Remove the following deprecated features: the ParseConfig()
127 global function (deprecated in 0.93); the misspelled "validater"
128 keyword to the Options.Add() method (deprecated in 0.91); the
129 SetBuildSignatureType(), SetContentSignatureType(), SetJobs() and
130 GetJobs() global functions (deprecated in 0.14).
132 - Fix problems with corrupting the .sconsign.dblite file when
133 interrupting builds by writing to a temporary file and renaming,
134 not writing the file directly.
136 - Fix a 0.96 regression where when running with -k, targets built from
137 walking dependencies later on the command line would not realize
138 that a dependency had failed an earlier build attempt, and would
139 try to rebuild the dependent targets.
141 - Change the final messages when using -k and errors occur from
142 "{building,cleaning} terminated because of errors" to "done
143 {building,cleaning} targets (errors occurred during {build,clean})."
145 - Allow Configure.CheckFunc() to take an optional header argument
146 (already supported by Conftest.py) to specify text at the top of
147 the compiled test file.
149 - Fix the --debug=explain output when a Python function action changed
150 so it prints a meaningful string, not the binary representation of
151 the function contents.
153 - Allow a ListOption's default value(s) to be a Python list of specified
154 values, not just a string containing a comma-separated list of names.
156 - Add a ParseDepends() function that will parse up a list of explicit
157 dependencies from a "make depend" style file.
159 - Support the ability to change directory when executing an Action
160 through "chdir" keyword arguments to Action and Builder creation
163 - Fix handling of Action ojects (and other callables that don't match
164 our calling arguments) in construction variable expansions.
166 - On Win32, install scons.bat in the Python directory when installing
167 from setup.py. (The bdist_wininst installer was already doing this.)
169 - Fix env.SConscript() when called with a list of SConscipt files.
170 (The SConscript() global function already worked properly.)
172 - Add a missing newline to the end of the --debug=explain "unknown
175 - Enhance ParseConfig() to work properly for spaces in between the -I,
176 -L and -l options and their arguments.
178 - Packaging build fix: Rebuild the files that are use to report the
179 --version of SCons whenever the development version number changes.
181 - Fix the ability to specify a target_factory of Dir() to a Builder,
182 which the default create-a-directory Builder was interfering with.
184 - Mark a directory as built if it's created as part of the preparation
185 for another target, to avoid trying to build it again when it comes
186 up in the target list.
188 - Allow a function with the right calling signature to be put directly
189 in an Environment's BUILDERS dictionary, making for easier creation
190 and use of wrappers (pseudo-Builders) that call other Builders.
192 - On Python 2.x, wrap lists of Nodes returned by Builders in a UserList
193 object that adds a method that makes str() object return a string
194 with all of the Nodes expanded to their path names. (Builders under
195 Python 1.5.2 still return lists to avoid TypeErrors when trying
196 to extend() list, so Python 1.5.2 doesn't get pretty-printing of Node
197 lists, but everything should still function.)
199 - Allow Aliases to have actions that will be executed whenever
200 any of the expanded Alias targets are out of date.
202 - Fix expansion of env.Command() overrides within target and
205 - Support easier customization of what's displayed by various default
206 actions by adding lots of new construction variables: $ARCOMSTR,
207 $ASCOMSTR, $ASPPCOMSTR, $BIBTEXCOMSTR, $BITKEEPERCOMSTR, $CCCOMSTR,
208 $CVSCOMSTR, $CXXCOMSTR, $DCOMSTR, $DVIPDFCOMSTR, $F77COMSTR,
209 $F90COMSTR, $F95COMSTR, $FORTRANCOMSTR, $GSCOMSTR, $JARCOMSTR,
210 $JAVACCOMSTR, $JAVAHCOMSTR, $LATEXCOMSTR, $LEXCOMSTR, $LINKCOMSTR,
211 $M4COMSTR, $MIDLCOMSTR, $P4COMSTR, $PCHCOMSTR, $PDFLATEXCOMSTR,
212 $PDFTEXCOMSTR, $PSCOMSTR, $QT_MOCFROMCXXCOMSTR, $QT_MOCFROMHCOMSTR,
213 $QT_UICCOMSTR, $RCCOMSTR, $REGSVRCOMSTR, $RCS_COCOMSTR, $RMICCOMSTR,
214 $SCCSCOMSTR, $SHCCCOMSTR, $SHCXXCOMSTR, $SHF77COMSTR, $SHF90COMSTR,
215 $SHF95COMSTR, $SHFORTRANCOMSTR, $SHLINKCOMSTR, $SWIGCOMSTR,
216 $TARCOMSTR, $TEXCOMSTR, $YACCCOMSTR and $ZIPCOMSTR.
218 - Add an optional "map" keyword argument to ListOption() that takes a
219 dictionary to map user-specified values to legal values from the list
220 (like EnumOption() already doee).
222 - Add specific exceptions to try:-except: blocks without any listed,
223 so that they won't catch and mask keyboard interrupts.
225 - Make --debug={tree,dtree,stree} print something even when there's
228 - Fix how Scanners sort the found dependencies so that it doesn't
229 matter whether the dependency file is in a Repository or not.
230 This may cause recompilations upon upgrade to this version.
232 - Make AlwaysBuild() work with Alias and Python value Nodes (making
233 it much simpler to support aliases like "clean" that just invoke
234 an arbitrary action).
236 - Have env.ParseConfig() use AppendUnique() by default to suppress
237 duplicate entries from multiple calls. Add a "unique" keyword
238 argument to allow the old behavior to be specified.
240 - Allow the library modules imported by an SConscript file to get at
241 all of the normally-available global functions and variables by saying
242 "from SCons.Script import *".
244 - Add a --debug=memoizer option to print Memoizer hit/mass statistics.
246 - Allow more than one --debug= option to be set at a time.
248 - Change --debug=count to report object counts before and after
249 reading SConscript files and before and after building targets.
251 - Change --debug=memory output to line up the numbers and to better
252 match (more or less) the headers on the --debug=count columns.
254 - Speed things up when there are lists of targets and/or sources by
255 getting rid of some N^2 walks of the lists involved.
257 - Cache evaluation of LazyActions so we don't create a new object
260 - When scanning, don't create Nodes for include files that don't
261 actually exist on disk.
263 - Make supported global variables CScanner, DScanner, ProgramScanner and
264 SourceFileScanner. Make SourceFileScanner.add_scanner() a supported
265 part of the public interface. Keep the old SCons.Defaults.*Scan names
266 around for a while longer since some people were already using them.
268 - By default, don't scan directories for on-disk files. Add a
269 DirScanner global scanner that can be used in Builders or Command()
270 calls that want source directory trees scanned for on-disk changes.
271 Have the Tar() and Zip() Builders use the new DirScanner to preserve
272 the behavior of rebuilding a .tar or .zip file if any file or
273 directory under a source tree changes. Add Command() support for
274 a source_scanner keyword argument to Command() that can be set to
275 DirScanner to get this behavior.
277 - Documentation changes: Explain that $CXXFLAGS contains $CCFLAGS
278 by default. Fix a bad target_factory example in the man page.
279 Add appendices to the User's Guide to cover the available Tools,
280 Builders and construction variables. Comment out the build of
281 the old Python 10 paper, which doesn't build on all systems and
282 is old enough at this point that it probably isn't worth the
283 effort to make it do so.
285 - Enhanced the SCons setup.py script to install man pages on
288 - Add support for an Options.FormatOptionHelpText() method that can
289 be overridden to customize the format of Options help text.
291 - Add a global name for the Entry class (which had already been
294 - Fix re-scanning of generated source files for implicit dependencies
295 when the -j option is used.
297 - Fix a dependency problem that caused $LIBS scans to not be added
298 to all of the targets in a multiple-target builder call, which
299 could cause out-of-order builds when the -j option is used.
301 - Store the paths of source files and dependencies in the .sconsign*
302 file(s) relative to the target's directory, not relative to the
303 top-level SConstruct directory. This starts to make it possible to
304 subdivide the dependency tree arbitrarily by putting an SConstruct
305 file in every directory and using content signatures.
307 - Add support for $YACCHFILESUFFIX and $YACCHXXFILESUFFIX variables
308 that accomodate parser generators that write header files to a
309 different suffix than the hard-coded .hpp when the -d option is used.
311 - The default behavior is now to store signature information in a
312 single .sconsign.dblite file in the top-level SConstruct directory.
313 The old behavior of a separate .sconsign file in each directory can
314 be specified by calling SConsignFile(None).
316 - Remove line number byte codes within the signature calculation
317 of Python function actions, so that changing the location of an
318 otherwise unmodified Python function doesn't cause rebuilds.
320 - Fix AddPreAction() and AddPostAction() when an action has more than
321 one target file: attach the actions to the Executor, not the Node.
323 - Allow the source directory of a BuildDir / build_dir to be outside
324 of the top-level SConstruct directory tree.
326 - Add a --debug=nomemoizer option that disables the Memoizer for clearer
327 looks at the counts and profiles of the underlying function calls,
328 not the Memoizer wrappers.
330 - Print various --debug= stats even if we exit early (e.g. using -h).
332 - Really only use the cached content signature value if the file
333 is older than --max-drift, not just if --max-drift is set.
335 - Remove support for conversion from old (pre 0.96) .sconsign formats.
337 - Add support for a --diskcheck option to enable or disable various
338 on-disk checks: that File and Dir nodes match on-disk entries;
339 whether an RCS file exists for a missing source file; whether an
340 SCCS file exists for a missing source file.
342 - Add a --raw argument to the sconsign script, so it can print a
343 raw representation of each entry's NodeInfo dictionary.
345 - Add the 'f90' and 'f95' tools to the list of Fortran compilers
346 searched for by default.
348 - Add the +Z option by default when compiling shared objects on
351 - Check for whether files exist on disk by listing the directory
352 contents, not calling os.path.exists() file by file. This is
353 somewhat more efficient in general, and may be significantly
354 more efficient on Windows.
356 - Minor speedups in the internal is_Dict(), is_List() and is_String()
359 - Fix a signature refactoring bug that caused Qt header files to
360 get re-generated every time.
362 - Don't fail when writing signatures if the .sconsign.dblite file is
363 owned by a different user (e.g. root) from a previous run.
365 - When deleting variables from stacked OverrideEnvironments, don't
366 throw a KeyError if we were able to delte the variable from any
367 Environment in the stack.
369 - Get rid of the last indentation tabs in the SCons source files and
370 add -tt to the Python invocations in the packaging build and the
371 tests so they don't creep back in.
373 - In Visual Studio project files, put quotes around the -C directory
374 so everything works even if the path has spaces in it.
376 - The Intel Fortran compiler uses -object:$TARGET, not "-o $TARGET",
377 when building object files on Windows. Have the the ifort Tool
378 modify the default command lines appropriately.
380 - Document the --debug=explain option in the man page. (How did we
383 - Add a $LATEXRETRIES variable to allow configuration of the number of
384 times LaTex can be re-called to try to resolve undefined references.
386 - Change the order of the arguments to Configure.Checklib() to match
389 - Handle signature calculation properly when the Python function used
390 for a FunctionAction is an object method.
394 - Handle Visual Studio project and solution files in Unicode.
398 - Avoid "maximum recursion limit" errors when removing $(-$) pairs
399 from long command lines.
403 - Make ParseConfig() recognize and add -mno-cygwin to $LINKFLAGS and
404 $CCFLAGS, and -mwindows to $LINKFLAGS.
408 - Correct TeX-related command lines to just $SOURCE, not $SOURCES
410 - Fix a bad use of Copy() in an example in the man page, and a
411 bad regular expression example in the man page and User's Guide.
415 - Have the Visual Studio project file(s) echo "Starting SCons" before
416 executing SCons, mainly to work around a quote-stripping bug in
417 (some versions of?) the Windows cmd command executor.
419 From Michael McCracken:
421 - Add a new "applelink" tool to handle the things like Frameworks and
422 bundles that Apple has added to gcc for linking.
424 - Use more appropriate default search lists of linkers, compilers and
425 and other tools for the 'darwin' platform.
427 - Add a LoadableModule Builder that builds a bundle on Mac OS X (Darwin)
428 and a shared library on other systems.
430 - Improve SWIG tests for use on Mac OS X (Darwin).
434 - Execute build commands for a command-line target if any of the
435 files built along with the target is out of date or non-existent,
436 not just if the command-line target itself is out of date.
438 - Fix the -n option when used with -c to print all of the targets
439 that will be removed for a multi-target Builder call.
441 - If there's no file in the source directory, make sure there isn't
442 one in the build directory, too, to avoid dangling files left
443 over from previous runs when a source file is removed.
445 - Allow AppendUnique() and PrependUnique() to append strings (and
446 other atomic objects) to lists.
450 - Remove the space after the -o option when invoking the Borland
451 BCC compiler; some versions apparently require that the file name
452 argument be concatenated with the option.
456 - Extend latex.py, pdflatex.py, pdftex.py and tex.py so that building
457 from both TeX and LaTeX files uses the same logic to call $BIBTEX
458 when it's necessary, to call $MAKEINDEX when it's necessary, and to
459 call $TEX or $LATEX multiple times to handle undefined references.
463 - Enhance the tests to guarantee persistence of ListOption
464 values in saved options files.
466 - Supply the help text when -h is used with the -u, -U or -D options.
468 From Leanid Nazdrynau:
470 - Fix the Java parser's handling of backslashes in strings.
472 - Fix the Qt UIC scanner to work with generated .ui files (by using
473 the FindFile() function instead of checking by-hand for the file).
477 - Fix the Java parser's handling of string definitions to avoid ignoring
480 From Han-Wen Nienhuys:
482 - Optimize variable expansion by: using the re.sub() method (when
483 possible); not using "eval" for variables for which we can fetch the
484 value directory; avoiding slowing substitution logic when there's no
487 From Jan Nieuwenhuizen:
489 - Fix a problem with interpreting quoted argument lists on command lines.
493 - Add construction variables to support frameworks on Mac OS X:
494 $FRAMEWORKS, $FRAMEWORKPREFIX, $FRAMEWORKPATH, $FRAMEWORKPATHPREFIX.
496 - Re-order link lines so the -o option always comes right after the
499 - Add /sw/bin to the default execution PATH on Mac OS X.
501 From Gary Oberbrunner:
503 - Add an Environment.Dump() method to print the contents of a
504 construction environment.
506 - Allow $LIBS (and similar variables) to contain explicit File Nodes.
508 - Change ParseConfig to add the found library names directly to the
509 $LIBS variable, instead of returning them.
511 - Add ParseConfig() support for the -framework GNU linker option.
513 - Add a PRINT_CMD_LINE_FUNC construction variable to allow people
514 to filter (or log) command-line output.
516 - Print an internal Python stack trace in response to an otherwise
517 unexplained error when --debug=stacktrace is specified.
519 - Add a --debug=findlibs option to print what's happening when
520 the scanner is searching for libraries.
522 - Allow Tool specifications to be passed a dictionary of keyword
525 - Support an Options default value of None, in which case the variable
526 will not be added to the construction environment unless it's set
527 explicitly by the user or from an Options file.
529 - Avoid copying __builtin__ values into a construction environment's
530 dictionary when evaluating construction variables.
532 - Add a new cross-platform intelc.py Tool that can detect and
533 configure the Intel C++ v8 compiler on both Windows, where it's
534 named icl, and Linux, where it's named icc. It also checks that
535 the directory specified in the Windows registry exists, and sets a
536 new $INTEL_C_COMPILER_VERSION construction variable to identify the
537 version being used. (Niall Douglas contributed an early prototype
538 of parts of this module.)
540 - Fix the private Conftest._Have() function so it doesn't change
541 non-alphanumeric characters to underscores.
543 - Supply a better error message when a construction variable expansion
544 has an unknown attribute.
546 - Documentation changes: Update the man page to describe use of
547 filenames or Nodes in $LIBS.
549 - Add support for Intel C++ beta 9.0 (both 32 and 64 bit versions).
551 - Document the new $FRAMEWORK* variables for Mac OS X.
555 - When building a .jar file and there is a $JARCHDIR, put the -C
556 in front of each .class file on the command line.
558 - Recognize the Java 1.5 enum keyword.
562 - Have the linkloc tool use $MSVS_VERSION to select the Microsoft
563 Visual Studio version to use.
567 - Add $RPATH (-R) support to the Sun linker Tool (sunlink).
569 - Add a description of env.subst() to the man page.
573 - Look in the right directory, not always the local directory, for a
574 same-named file or directory conflict on disk.
576 - On Windows, preserve the external environment's %SYSTEMDRIVE%
579 From Asfand Yar Qazi:
581 - Add /opt/bin to the default execution PATH on all POSIX platforms
582 (between /usr/local/bin and /bin).
586 - Fix the Builder name returned from ListBuilders and other instances
587 of subclasses of the BuilderBase class.
589 - Add Builders and construction variables to support rpcgen:
590 RPCGenClient(), RPCGenHeader(), RPCGenService(), RPCGenXDR(),
591 $RPCGEN, $RPCGENFLAGS, $RPCGENCLIENTFLAGS, $RPCGENHEADERFLAGS,
592 $RPCGENSERVICEFLAGS, $RPCGENXDRFLAGS.
594 - Update the man page to document that prefix and suffix Builder
595 keyword arguments can be strings, callables or dictionaries.
597 - Provide more info in the error message when a user tries to build
598 a target multiple ways.
600 - Fix Delete() when a file doesn't exist and must_exist=1. (We were
601 unintentionally dependent on a bug in versions of the Python shutil.py
602 module prior to Python 2.3, which would generate an exception for
603 a nonexistent file even when ignore_errors was set.)
605 - Only replace a Node's builder with a non-null source builder.
607 - Fix a stack trace when a suffix selection dictionary is passed
608 an empty source file list.
610 - Allow optional names to be attached to Builders, for default
611 Builders that don't get attached to construction environments.
613 - Fix problems with Parallel Task Exception handling.
615 - Build targets in an associated BuildDir even if there are targets
616 or subdirectories locally in the source directory.
618 - If a FunctionAction has a callable class as its underlying Python
619 function, use its strfunction() method (if any) to display the
622 - Fix handling when BuildDir() exists but is unwriteable. Add
623 "Stop." to those error messages for consistency.
625 - Catch incidents of bad builder creation (without an action) and
626 supply meaningful error messages.
628 - Fix handling of src_suffix values that aren't extensions (don't
631 - Don't retrieve files from a CacheDir, but report what would happen,
632 when the -n option is used.
634 - Use the source_scanner from the target Node, not the source node
637 - Internal Scanners fixes: Make sure Scanners are only passed Nodes.
638 Fix how a Scanner.Selector called its base class initialization.
639 Make comparisons of Scanner objects more robust. Add a name to
640 an internal default ObjSourceScanner.
642 - Add a deprecated warning for use of the old "scanner" keyword argument
645 - Improve the --debug=explain message when the build action changes.
647 - Test enhancements in SourceCode.py, option-n.py, midl.py. Better
648 Command() and Scanner test coverage. Improved test infrastructure
651 - Refactor the interface between Action and Executor objects to treat
654 - The --debug=presub option will now report the pre-substitution
655 each action seprately, instead of reporting the entire list before
656 executing the actions one by one.
658 - The --debug=explain option explaining a changed action will now
659 (more correctly) show pre-substitution action strings, instead of
660 the commands with substituted file names.
662 - A Node (file) will now be rebuilt if its PreAction or PostAction
665 - Python Function actions now have their calling signature (target,
666 source, env) reported correctly when displayed.
668 - Fix BuildDir()/build_dir handling when the build_dir is underneath
669 the source directory and trying to use entries from the build_dir
670 as sources for other targets in the build-dir.
672 - Fix hard-coding of JDK path names in various Java tests.
674 - Handle Python stack traces consistently (stop at the SConscript stack
675 frame, by default) even if the Python source code isn't available.
677 - Improve the performance of the --debug={tree,dtree} options.
679 - Add --debug=objects logging of creation of OverrideWarner,
680 EnvironmentCopy and EnvironmentOverride objects.
682 - Fix command-line expansion of Python Value Nodes.
684 - Internal cleanups: Remove an unnecessary scan argument. Associate
685 Scanners only with Builders, not nodes. Apply overrides once when
686 a Builder is called, not in multiple places. Cache results from the
687 Node.FS.get_suffix() and Node.get_build_env() methods. Use the Python
688 md5 modules' hexdigest() method, if there is one. Have Taskmaster
689 call get_stat() once for each Node and re-use the value instead of
690 calling it each time it needs the value. Have Node.depends_on()
691 re-use the list from the children() method instead of calling it
694 - Use the correct scanner if the same source file is used for targets in
695 two different environments with the same path but different scanners.
697 - Collect logic for caching values in memory in a Memoizer class,
698 which cleans up a lot of special-case code in various methods and
699 caches additional values to speed up most configurations.
701 - Add a PathAccept validator to the list of new canned PathOption
704 From Christoph Schulz:
706 - Add support for $CONFIGUREDIR and $CONFIGURELOG variables to control
707 the directory and logs for configuration tests.
709 - Add support for a $INSTALLSTR variable.
713 - Have the Fortran module emitter look for Fortan modules to be created
714 relative to $FORTRANMODDIR, not the top-level directory.
716 - When saving Options to a file, run default values through the
717 converter before comparing them with the set values. This correctly
718 suppresses Boolean Option values from getting written to the saved
719 file when they're one of the many synonyms for a default True or
722 - Fix the Fortran Scanner's ability to handle a module being used
723 in the same file in which it is defined.
727 - Documentation changes: Use $CPPDEFINES instead of $CCFLAGS in man
732 - Allow $JARCHDIR to be expanded to other construction variables.
736 - Add the -KPIC option by default when compiling shared objects on
739 - Change the default suffix for Solaris objects to .o, to conform to
740 Sun WorkShop's expectations. Change the profix to so_ so they can
741 still be differentiated from static objects in the same directory.
745 - When calling the resource compiler on MinGW, add --include-dir and
746 the source directory so it finds the source file.
748 - Update EnsureSConsVersion() to support revision numbers.
750 - Add use of $CPPDEFINES to $RCCOM (resource file compilation) on MinGW.
752 From Dobes Vandermeer:
754 - Add support for SCC and other settings in Microsoft Visual
755 Studio project and solution files: $MSVS_PROJECT_BASE_PATH,
756 $MSVS_PROJECT_GUID, $MSVS_SCC_AUX_PATH, $MSVS_SCC_LOCAL_PATH,
757 $MSVS_SCC_PROJECT_NAME, $MSVS_SCC_PROVIDER,
759 - Add support for using a $SCONS_HOME variable (imported from the
760 external environment, or settable internally) to put a shortened
761 SCons execution line in the Visual Studio project file.
765 - Fix a misplaced line in the man page.
767 From Christoph Wiedemann:
769 - Add an Environment.SetDefault() method that only sets values if
770 they aren't already set.
772 - Have the qt.py Tool not override variables already set by the user.
774 - Add separate $QT_BINPATH, $QT_CPPPATH and $QT_LIBPATH variables
775 so these can be set individually, instead of being hard-wired
778 - The %TEMP% and %TMP% external environment variables are now propagated
779 automatically to the command execution environment on Windows systems.
781 - A new --config= command-line option allows explicit control of
782 of when the Configure() tests are run: --config=force forces all
783 checks to be run, --config=cache uses all previously cached values,
784 --config=auto (the default) runs tests only when dependency analysis
785 determines it's necessary.
787 - The Configure() subsystem can now write a config.h file with values
788 like HAVE_STDIO_H, HAVE_LIBM, etc.
790 - The Configure() subsystem now executes its checks silently when the
791 -Q option is specified.
793 - The Configure() subsystem now reports if a test result is being
794 taken from cache, and prints the standard output and error output
795 of tests even when cached.
797 - Configure() test results are now reported as "yes" or "no" instead of
800 - Fixed traceback printing when calling the env.Configure() method
801 instead of the Configure() global function.
803 - The Configure() subsystem now caches build failures in a .sconsign
804 file in the subdirectory, not a .cache file. This may cause
805 tests to be re-executed the first time after you install 0.97.
807 - Additional significant internal cleanups in the Configure() subsystem
810 - Have the Qt Builder make uic-generated files dependent on the .ui.h
813 - Add a test to make sure that SCons source code does not contain
814 try:-except: blocks that catch all errors, which potentially catch
815 and mask keyboard interrupts.
817 - Fix us of TargetSignatures('content') with the SConf subsystem.
819 From Russell Yanofsky:
821 - Add support for the Metrowerks Codewarrior compiler and linker
830 - Handle white space in the executable Python path name within in MSVS
831 project files by quoting the path.
833 - Correct the format of a GUID string in a solution (.dsw) file so
834 MSVS can correctly "build enable" a project.
838 - Add a must_exist flag to Delete() to let the user control whether
839 it's an error if the specified entry doesn't exist. The default
840 behavior is now to silently do nothing if it doesn't exist.
842 - Package up the new Platform/darwin.py, mistakenly left out of 0.96.
844 - Make the scons.bat REM statements into @REM so they aren't printed.
846 - Make the SCons packaging SConscript files platform independent.
850 - Fix scanning of pre-compiled header (.pch) files for #includes,
855 RELEASE 0.96 - Wed, 18 Aug 2004 13:36:40 +0000
859 - Make the CacheDir() directory if it doesn't already exist.
861 - Allow construction variable substitutions in $LIBS specifications.
863 - Allow the emitter argument to a Builder() to be or expand to a list
864 of emitter functions, which will be called in sequence.
866 - Suppress null values in construction variables like $LIBS that use
867 the internal _concat() function.
869 - Remove .dll files from the construction variables searched for
870 libraries that can be fed to Win32 compilers.
872 From Chad Austin and Christoph Wiedemann:
874 - Add support for a $RPATH variable to supply a list of directories
875 to search for shared libraries when linking a program. Used by
876 the GNU and IRIX linkers (gnulink and sgilink).
880 - Restore the ability to do construction variable substitutions in all
881 kinds of *PATH variables, even when the substitution returns a Node
886 - Allow the Java() Builder to take more than one source directory.
888 From Ralf W. Grosse-Kunstleve:
890 - Have SConsignFile() use, by default, a custom "dblite.py" that we can
891 control and guarantee to work on all Python versions (or nearly so).
893 From Jonathan Gurley:
895 - Add support for the newer "ifort" versions of the Intel Fortran
900 - Make the new *FLAGS variable type work with copied Environments.
904 - Initialize the name of a Scanner.Classic scanner correctly.
908 - Add support for the .dylib shared library suffix and the -dynamiclib
909 linker option on Mac OS X.
913 - Add an Execute() method for executing actions directly.
915 - Support passing environment override keyword arguments to Command().
917 - Fix use of $MSVS_IGNORE_IDE_PATHS, which was broken when we added
918 support for $MSVS_USE_MFC_DIRS last release.
920 - Make env.Append() and env.Prepend() act like the underlying Python
921 behavior when the variable being appended to is a UserList object.
923 - Fix a regression that prevented the Command() global function in
924 0.95 from working with command-line strings as actions.
926 - Fix checking out a file from a source code management system when
927 the env.SourceCode() method was called with an individual file name
928 or node, not a directory name or node.
930 - Enhance the Task.make_ready() method to create a list of the
931 out-of-date Nodes for the task for use by the wrapping interface.
933 - Allow Scanners to pull the list of suffixes from the construction
934 environment when the "skeys" keyword argument is a string containing
935 a construction variable to be expanded.
937 - Support new $CPPSUFFIXES, $DSUFFIXES $FORTRANSUFFIXES, and
938 $IDLSUFFIXES. construction variables that contain the default list
939 of suffixes to be scanned by a given type of scanner, allowing these
940 suffix lists to be easily added to or overridden.
942 - Speed up Node creation when calling a Builder by comparing whether two
943 Environments are the same object, not if their underlying dictionaries
946 - Add a --debug=explain option that reports the reason(s) why SCons
947 thinks it must rebuild something.
949 - Add support for functions that return platform-independent Actions
950 to Chmod(), Copy(), Delete(), Mkdir(), Move() and Touch() files
951 and/or directories. Like any other Actions, the returned Action
952 object may be executed directly using the Execute() global function
953 or env.Execute() environment method, or may be used as a Builder
954 action or in an env.Command() action list.
956 - Add support for the strfunction argument to all types of Actions:
957 CommandAction, ListAction, and CommandGeneratorAction.
959 - Speed up turning file system Nodes into strings by caching the
960 values after we're finished reading the SConscript files.
962 - Have ParseConfig() recognize and supporting adding the -Wa, -Wl,
963 and -Wp, flags to ASFLAGS, LINKFLAGS and CPPFLAGS, respectively.
965 - Change the .sconsign format and the checks for whether a Node is
966 up-to-date to make dependency checks more efficient and correct.
968 - Add wrapper Actions to SCons.Defaults for $ASCOM, $ASPPCOM, $LINKCOM,
969 $SHLINKCOM, $ARCOM, $LEXCOM and $YACCCOM. This makes it possible
970 to replace the default print behavior with a custom strfunction()
973 - When a Node has been built, don't walk the whole tree back to delete
974 the parents's implicit dependencies, let returning up the normal
975 Taskmaster descent take care of it for us.
977 - Add documented support for separate target_scanner and source_scanner
978 arguments to Builder creation, which allows different scanners to
979 be applied to source files
981 - Don't re-install or (re-generate) .h files when a subsidiary #included
982 .h file changes. This eliminates incorrect circular dependencies
983 with .h files generated from other source files.
985 - Slim down the internal Sig.Calculator class by eliminating methods
986 whose functionality is now covered by Node methods.
988 - Document use of the target_factory and source_factory keyword
989 arguments when creating Builder objects. Enhance Dir Nodes so that
990 they can be created with user-specified Builder objects.
992 - Don't blow up with stack trace when the external $PATH environment
995 - Make Builder calls return lists all the time, even if there's only
996 one target. This keeps things consistent and easier to program to
999 - Add a Flatten() function to make it easier to deal with the Builders
1000 all returning lists of targets, not individual targets.
1002 - Performance optimizations in Node.FS.__doLookup().
1004 - Man page fixes: formatting typos, misspellings, bad example.
1006 - User's Guide fixes: Fix the signatures of the various example
1007 *Options() calls. Triple-quote properly a multi-line Split example.
1009 - User's Guide additions: Chapter describing File and Directory
1010 Nodes. Section describing declarative nature of SCons functions in
1011 SConscript files. Better organization and clarification of points
1012 raised by Robert P. J. Day. Chapter describing SConf (Autoconf-like)
1013 functionality. Chapter describing how to install Python and
1014 SCons. Chapter describing Java builds.
1018 - Add a .win32 attribute to force file names to expand with
1019 Windows backslash path separators.
1021 - Fix escaping file names on command lines when the expansion is
1022 concatenated with another string.
1024 - Add support for Fortran 90 and Fortran 95. This adds $FORTRAN*
1025 variables that specify a default compiler, command-line, flags,
1026 etc. for all Fortran versions, plus separate $F90* and $F95*
1027 variables for when different compilers/flags/etc. must be specified
1028 for different Fortran versions.
1030 - Have individual tools that create libraries override the default
1031 $LIBPREFIX and $LIBSUFFIX values set by the platform. This makes
1032 it easier to use Microsoft Visual Studio tools on a CygWin platform.
1034 From Gary Oberbrunner:
1036 - Add a --debug=presub option to print actions prior to substitution.
1038 - Add a warning upon use of the override keywords "targets" and
1039 "sources" when calling Builders. These are usually mistakes which
1040 are otherwise silently (and confusingly) turned into construction
1043 - Try to find the ICL license file path name in the external environment
1044 and the registry before resorting to the hard-coded path name.
1046 - Add support for fetching command-line keyword=value arguments in
1047 order from an ARGLIST list.
1049 - Avoid stack traces when trying to read dangling symlinks.
1051 - Treat file "extensions" that only contain digits as part of the
1052 file basename. This supports version numbers as part of shared
1053 library names, for example.
1055 - Avoid problems when there are null entries (None or '') in tool
1058 - Add an example and explanation of how to use "tools = ['default', ..."
1059 when creating a construction environment.
1061 - Add a section describing File and Directory Nodes and some of their
1062 attributes and methods.
1064 - Have ParseConfig() add a returned -pthread flag to both $CCFLAGS
1067 - Fix some test portability issues on Mac OS X (darwin).
1071 - Fix a bug introduced in building shared libraries under MinGW.
1075 - Handling SCons exceptions according to Pythonic standards.
1077 - Fix test/chained-build.py on systems that execute within one second.
1079 - Fix tests on systems where 'ar' warns about archive creation.
1083 - Fix use of the --implicit-cache option with timestamp signatures.
1085 - If Visual Studio is installed, assume the C/C++ compiler, the linker
1086 and the MIDL compiler that comes with it are available, too.
1088 - Better error messages when evaluating a construction variable
1089 expansion yields a Python syntax error.
1091 - Change the generation of PDB files when using Visual Studio from
1092 compile time to link time.
1096 - Allow SConf.CheckLib() to search a list of libraries, like the
1097 Autoconf AC_SEARCH_LIBS macro.
1099 - Allow the env.WhereIs() method to take a "reject" argument to
1100 let it weed out specific path names.
1102 From Christoph Wiedemann:
1104 - Add new Moc() and Uic() Builders for more explicit control over
1105 Qt builds, plus new construction variables to control them:
1106 $QT_AUTOSCAN, $QT_DEBUG, $QT_MOCCXXPREFIX, $QT_MOCCXXSUFFIX,
1107 $QT_MOCHPREFIX, $QT_MOCHSUFFIX, $QT_UICDECLPREFIX, $QT_UICDECLSUFFIX,
1108 $QT_UICIMPLPREFIX, $QT_UICIMPLSUFFIX and $QT_UISUFFIX.
1110 - Add a new single_source keyword argument for Builders that enforces
1111 a single source file on calls to the Builder.
1115 RELEASE 0.95 - Mon, 08 Mar 2004 06:43:20 -0600
1119 - Replace print statements with calls to sys.stdout.write() so output
1120 lines stay together when -j is used.
1122 - Add portability fixes for a number of tests.
1124 - Accomodate the fact that Cygwin's os.path.normcase() lies about
1125 the underlying system being case-sensitive.
1127 - Fix an incorrect _concat() call in the $RCINCFLAGS definition for
1130 - Fix a problem with the msvc tool with Python versions prior to 2.3.
1132 - Add support for a "toolpath" Tool() and Environment keyword that
1133 allows Tool modules to be found in specified local directories.
1135 - Work around Cygwin Python's silly fiction that it's using a
1136 case-sensitive file system.
1138 - More robust handling of data in VCComponents.dat.
1140 - If the "env" command is available, spawn commands with the more
1141 general "env -" instead of "env -i".
1143 From Kerim Borchaev:
1145 - Fix a typo in a msvc.py's registry lookup: "VCComponents.dat", not
1148 From Chris Burghart:
1150 - Fix the ability to save/restore a PackageOption to a file.
1152 From Steve Christensen:
1154 - Update the MSVS .NET and MSVC 6.0/7.0 path detection.
1156 From David M. Cooke:
1158 - Make the Fortran scanner case-insensitive for the INCLUDE string.
1162 - If no version of MSVC is detected but the tool is specified,
1163 use the MSVC 6.0 paths by default.
1165 - Ignore any "6.1" version of MSVC found in the registry; this is a
1166 phony version number (created by later service packs?) and would
1167 throw off the logic if the user had any non-default paths configure.
1169 - Correctly detect if the user has independently configured the MSVC
1170 "include," "lib" or "path" in the registry and use the appropriate
1171 values. Previously, SCons would only use the values if all three
1172 were set in the registry.
1174 - Make sure side-effect nodes are prepare()d before building their
1175 corresponding target.
1177 - Preserve the ability to call BuildDir() multiple times with the
1178 same target and source directory arguments.
1182 - Add support for the Digital Mars "D" programming language.
1184 From Scott Lystig Fritchie:
1186 - Fix the ability to use a custom _concat() function in the
1187 construction environment when calling _stripixes().
1189 - Make the message about ignoring a missing SConscript file into a
1190 suppressable Warning, not a hard-coded sys.stderr.write().
1192 - If a builder can be called multiple times for a target (because
1193 the sources and overrides are identical, or it's a builder with the
1194 "multi" flag set), allow the builder to be called through multiple
1195 environments so long as the builders have the same signature for
1196 the environments in questions (that is, they're the same action).
1200 - When multiple targets are built by a single action, retrieve all
1201 of them from cache, not just the first target, and exec the build
1202 command if any of the targets isn't present in the cache.
1204 From Zephaniah Hull:
1206 - Fix command-line ARGUMENTS with multiple = in them.
1210 - Fix EnsureSConsVersion() so it checks against the SCons version,
1211 not the Python version, on Pythons with sys.version_info.
1213 - Don't swallow the AttributeError when someone uses an expansion like
1214 $TARGET.bak, so we can supply a more informative error message.
1216 - Fix an odd double-quote escape sequence in the man page.
1218 - Fix looking up a naked drive letter as a directory (Dir('C:')).
1220 - Support using File nodes in the LIBS construction variable.
1222 - Allow the LIBS construction variable to be a single string or File
1223 node, not a list, when only one library is needed.
1225 - Fix typos in the man page: JAVACHDIR => JARCHDIR; add "for_signature"
1226 to the __call__() example in the "Variable Substitution" section.
1228 - Correct error message spellings of "non-existant" to "non-existent."
1230 - When scanning for libraries to link with, don't append $LIBPREFIXES
1231 or $LIBSUFFIXES values to the $LIBS values if they're already present.
1233 - Add a ZIPCOMPRESSION construction variable to control whether the
1234 internal Python action for the Zip Builder compresses the file or
1235 not. The default value is zipfile.ZIP_DEFLATED, which generates
1238 - Refactor construction variable expansion to support recursive
1239 expansion of variables (e.g. CCFLAGS = "$CCFLAGS -g") without going
1240 into an infinite loop. Support this in all construction variable
1241 overrides, as well as when copying Environments.
1243 - Fix calling Configure() from more than one subsidiary SConscript file.
1245 - Fix the env.Action() method so it returns the correct type of
1246 Action for its argument(s).
1248 - Fix specifying .class files as input to JavaH with the .class suffix
1249 when they weren't generated using the Java Builder.
1251 - Make the check for whether all of the objects going into a
1252 SharedLibrary() are shared work even if the object was built in a
1255 - Supply meaningful error messages, not stack traces, if we try to add
1256 a non-Node as a source, dependency, or ignored dependency of a Node.
1258 - Generate MSVS Project files that re-invoke SCons properly regardless
1259 of whether the file was built via scons.bat or scons.py.
1260 (Thanks to Niall Douglas for contributing code and testing.)
1262 - Fix TestCmd.py, runtest.py and specific tests to accomodate being
1263 run from directories whose paths include white space.
1265 - Provide a more useful error message if a construction variable
1266 expansion contains a syntax error during evaluation.
1268 - Fix transparent checkout of implicit dependency files from SCCS
1271 - Added new --debug=count, --debug=memory and --debug=objects options.
1272 --debug=count and --debug=objects only print anything when run
1273 under Python 2.1 or later.
1275 - Deprecate the "overrides" keyword argument to Builder() creation
1276 in favor of using keyword argument values directly (like we do
1277 for builder execution and the like).
1279 - Always use the Builder overrides in substitutions, not just if
1280 there isn't a target-specific environment.
1282 - Add new "rsrcpath" and "rsrcdir" and attributes to $TARGET/$SOURCE,
1283 so Builder command lines can find things in Repository source
1284 directories when using BuildDir.
1286 - Fix the M4 Builder so that it chdirs to the Repository directory
1287 when the input file is in the source directory of a BuildDir.
1289 - Save memory at build time by allowing Nodes to delete their build
1290 environments after they've been built.
1292 - Add AppendUnique() and PrependUnique() Environment methods, which
1293 add values to construction variables like Append() and Prepend()
1294 do, but suppress any duplicate elements in the list.
1296 - Allow the 'qt' tool to still be used successfully from a copied
1297 Environment. The include and library directories previously ended up
1298 having the same string re-appended to the end, yielding an incorrect
1301 - Supply a more descriptive error message when the source for a target
1304 - Initialize all *FLAGS variables with objects do the right thing with
1305 appending flags as strings or lists.
1307 - Make things like ${TARGET.dir} work in *PATH construction variables.
1309 - Allow a $MSVS_USE_MFC_DIRS construction variable to control whether
1310 ATL and MFC directories are included in the default INCLUDE and
1313 - Document the dbm_module argument to the SConsignFile() function.
1317 - Add support for the bcc32, ilink32 and tlib Borland tools.
1321 - Supply an error message if the user tries to configure a BuildDir
1322 for a directory that already has one.
1324 - Remove documentation of the still-unimplemented -e option.
1326 - Add -H help text listing the legal --debug values.
1328 - Don't choke if a construction variable is a non-string value.
1330 - Build Type Libraries in the target directory, not the source
1333 - Add an appendix to the User's Guide showing how to accomplish
1334 various common tasks in Python.
1338 - Add support for Microsoft Visual Studio 2003 (version 7.1).
1340 - Evaluate $MSVSPROJECTSUFFIX and $MSVSSOLUTIONSUFFIX when the Builder
1341 is invoked, not when the tool is initialized.
1343 From Christoph Wiedemann:
1345 - When compiling Qt, make sure the moc_*.cc files are compiled using
1346 the flags from the environment used to specify the target, not
1347 the environment that first has the Qt Builders attached.
1351 RELEASE 0.94 - Fri, 07 Nov 2003 05:29:48 -0600
1353 From Hartmut Goebel:
1355 - Add several new types of canned functions to help create options:
1356 BoolOption(), EnumOption(), ListOption(), PackageOption(),
1361 - Fix use of CPPDEFINES with C++ source files.
1363 - Fix env.Append() when the operand is an object with a __cmp__()
1364 method (like a Scanner instance).
1366 - Fix subclassing the Environment and Scanner classes.
1368 - Add BUILD_TARGETS, COMMAND_LINE_TARGETS and DEFAULT_TARGETS variables.
1372 - SGI fixes: Fix C++ compilation, add a separate Tool/sgic++.py module.
1374 From Gary Oberbrunner:
1376 - Fix how the man page un-indents after examples in some browsers.
1380 - Fix the C and C++ tool specifications for AIX.
1384 RELEASE 0.93 - Thu, 23 Oct 2003 07:26:55 -0500
1388 - On POSIX, execute commands with the more modern os.spawnvpe()
1389 function, if it's available.
1391 - Scan .S, .spp and .SPP files for C preprocessor dependencies.
1393 - Refactor the Job.Parallel() class to use a thread pool without a
1394 condition variable. This improves parallel build performance and
1395 handles keyboard interrupts properly when -j is used.
1399 - Add support for a JARCHDIR variable to control changing to a
1400 directory using the jar -C option.
1402 - Add support for detecting Java manifest files when using jar,
1403 and specifying them using the jar m flag.
1405 - Fix some Python 2.2 specific things in various tool modules.
1407 - Support directories as build sources, so that a rebuild of a target
1408 can be triggered if anything underneath the directory changes.
1410 - Have the scons.bat and scons.py files look for the SCons modules
1411 in site-packages as well.
1413 From Christian Engel:
1415 - Support more flexible inclusion of separate C and C++ compilers.
1417 - Use package management tools on AIX and Solaris to find where
1418 the comilers are installed, and what version they are.
1420 - Add support for CCVERSION and CXXVERSION variables for a number
1421 of C and C++ compilers.
1425 - Add test cases for the new capabilities to run bibtex and to rerun
1428 From Ralf W. Grosse-Kunstleve:
1430 - Accomodate anydbm modules that don't have a sync() method.
1432 - Allow SConsignFile() to take an argument specifying the DBM
1435 From Stephen Kennedy:
1437 - Add support for a configurable global .sconsign.dbm file which
1438 can be used to avoid cluttering each directory with an individual
1443 - Fix (re-)scanning of dependencies in generated or installed
1448 - The -Q option suppressed too many messages; fix it so that it only
1449 suppresses the Reading/Building messages.
1451 - Support #include when there's no space before the opening quote
1454 - Accomodate alphanumeric version strings in EnsurePythonVersion().
1456 - Support arbitrary expansion of construction variables within
1457 file and directory arguments to Builder calls and Environment methods.
1459 - Add Environment-method versions of the following global functions:
1460 Action(), AddPostAction(), AddPreAction(), Alias(), Builder(),
1461 BuildDir(), CacheDir(), Clean(), Configure(), Default(),
1462 EnsurePythonVersion(), EnsureSConsVersion(), Environment(),
1463 Exit(), Export(), FindFile(), GetBuildPath(), GetOption(), Help(),
1464 Import(), Literal(), Local(), Platform(), Repository(), Scanner(),
1465 SConscriptChdir(), SConsignFile(), SetOption(), SourceSignatures(),
1466 Split(), TargetSignatures(), Tool(), Value().
1468 - Add the following global functions that correspond to the same-named
1469 Environment methods: AlwaysBuild(), Command(), Depends(), Ignore(),
1470 Install(), InstallAs(), Precious(), SideEffect() and SourceCode().
1472 - Add the following global functions that correspond to the default
1473 Builder methods supported by SCons: CFile(), CXXFile(), DVI(), Jar(),
1474 Java(), JavaH(), Library(), M4(), MSVSProject(), Object(), PCH(),
1475 PDF(), PostScript(), Program(), RES(), RMIC(), SharedLibrary(),
1476 SharedObject(), StaticLibrary(), StaticObject(), Tar(), TypeLibrary()
1479 - Rearrange the man page to show construction environment methods and
1480 global functions in the same list, and to explain the difference.
1482 - Alphabetize the explanations of the builder methods in the man page.
1484 - Rename the Environment.Environment class to Enviroment.Base.
1485 Allow the wrapping interface to extend an Environment by using its own
1486 subclass of Environment.Base and setting a new Environment.Environment
1487 variable as the calling entry point.
1489 - Deprecate the ParseConfig() global function in favor of a same-named
1490 construction environment method.
1492 - Allow the Environment.WhereIs() method to take explicit path and
1493 pathext arguments (like the underlying SCons.Util.WhereIs() function).
1495 - Remove the long-obsolete {Get,Set}CommandHandler() functions.
1497 - Enhance env.Append() to suppress null values when appropriate.
1499 - Fix ParseConfig() so it works regardless of initial construction
1502 Extend CheckHeader(), CheckCHeader(), CheckCXXHeader() and
1503 CheckLibWithHeader() to accept a list of header files that will be
1504 #included in the test. The last one in the list is assumed to be
1505 the one being checked for. (Prototype code contributed by Gerard
1506 Patel and Niall Douglas).
1508 - Supply a warning when -j is used and threading isn't built in to
1509 the current version of Python.
1511 - First release of the User's Guide (finally, and despite a lot
1512 of things still missing from it...).
1516 - Generalize the action for .tex files so that it will decide whether
1517 a file is TeX or LaTeX, check the .aux output to decide if it should
1518 run bibtex, and check the .log output to re-run LaTeX if needed.
1520 From Bram Moolenaar:
1522 - Split the non-SCons-specific functionality from SConf.py to a new,
1523 re-usable Conftest.py module.
1525 From Gary Oberbrunner:
1527 - Allow a directory to be the target or source or dependency of a
1528 Depends(), Ignore(), Precious() or SideEffect() call.
1532 - Use the %{_mandir} macro when building our RPM package.
1534 From Marko Rauhamaa:
1536 - Have the closing message say "...terminated because of errors" if
1541 - On Win32 systems, only use "rm" to delete files if Cygwin is being
1542 used. ("rm" doesn't understand Win32-format path names.)
1544 From Christoph Wiedemann:
1546 - Fix test/SWIG.py to find the Python include directory in all cases.
1548 - Fix a bug in detection of Qt installed on the local system.
1550 - Support returning Python 2.3 BooleanType values from Configure checks.
1552 - Provide an error message if someone mistakenly tries to call a
1553 Configure check from within a Builder function.
1555 - Support calling a Builder when a Configure context is still open.
1557 - Handle interrupts better by eliminating all try:-except: blocks
1558 which caught any and all exceptions, including KeyboardInterrupt.
1560 - Add a --duplicate= option to control how files are duplicated.
1564 RELEASE 0.92 - Wed, 20 Aug 2003 03:45:28 -0500
1566 From Charles Crain and Gary Oberbrunner:
1568 - Fix Tool import problems with the Intel and PharLap linkers.
1572 - Refactor the DictCmdGenerator class to be a Selector subclass.
1574 - Allow the DefaultEnvironment() function to take arguments and pass
1575 them to instantiation of the default construction environment.
1577 - Update the Debian package so it uses Python 2.2 and more closely
1578 resembles the currently official Debian packaging info.
1582 - When the yacc -d flag is used, take the .h file base name from the
1583 target .c file, not the source (matching what yacc does).
1587 RELEASE 0.91 - Thu, 14 Aug 2003 13:00:44 -0500
1591 - Support specifying a list of tools when calling Environment.Copy().
1593 - Give a Value Nodes a timestamp of the system time when they're
1594 created, so they'll work when using timestamp-based signatures.
1596 - Add a DefaultEnvironment() function that only creates a default
1597 environment on-demand (for fetching source files, e.g.).
1599 - Portability fix for test/M4.py.
1603 - Tighten up the scons -H help output.
1605 - When the input yacc file ends in .yy and the -d flag is specified,
1606 recognize that a .hpp file (not a .h file) will be created.
1608 - Make builder prefixes work correctly when deducing a target
1609 from a source file name in another directory.
1611 - Documentation fixes: typo in the man page; explain up-front about
1612 not propagating the external environment.
1614 - Use "cvs co -d" instead of "cvs co -p >" when checking out something
1615 from CVS with a specified module name. This avoids zero-length
1616 files when there is a checkout error.
1618 - Add an "sconsign" script to print the contents of .sconsign files.
1620 - Speed up maintaining the various lists of Node children by using
1621 dictionaries to avoid "x in list" searches.
1623 - Cache the computed list of Node children minus those being Ignored
1624 so it's only calculated once.
1626 - Fix use of the --cache-show option when building a Program()
1627 (or using any other arbitrary action) by making sure all Action
1628 instances have strfunction() methods.
1630 - Allow the source of Command() to be a directory.
1632 - Better error handling of things like raw TypeErrors in SConscripts.
1634 - When installing using "setup.py install --prefix=", suppress the
1635 distutils warning message about adding the (incorrect) library
1636 directory to your search path.
1638 - Correct the spelling of the "validater" option to "validator."
1639 Add a DeprecatedWarning when the old spelling is used.
1641 - Allow a Builder's emitter to be a dictionary that maps source file
1642 suffixes to emitter functions, using the suffix of the first file
1643 in the source list to pick the right one.
1645 - Refactor the creation of the Program, *Object and *Library Builders
1646 so that they're moved out of SCons.Defaults and created on demand.
1648 - Don't split SConscript file names on white space.
1650 - Document the SConscript function's "dirs" and "name" keywords.
1652 - Remove the internal (and superfluous) SCons.Util.argmunge() function.
1654 - Add /TP to the default CXXFLAGS for msvc, so it can compile all
1655 of the suffixes we use as C++ files.
1657 - Allow the "prefix" and "suffix" attributes of a Builder to be
1658 callable objects that return generated strings, or dictionaries
1659 that map a source file suffix to the right prefix/suffix.
1661 - Support a MAXLINELINELENGTH construction variable on Win32 systems
1662 to control when a temporary file is used for long command lines.
1664 - Make how we build .rpm packages not depend on the installation
1665 locations from the distutils being used.
1667 - When deducing a target Node, create it directly from the first
1668 source Node, not by trying to create the right string to pass to
1671 - Add support for SWIG.
1673 From Bram Moolenaar:
1675 - Test portability fixes for FreeBSD.
1677 From Gary Oberbrunner:
1679 - Report the target being built in error messages when building
1680 multiple sources from different extensions, or when the target file
1681 extension can't be deduced, or when we don't have an action for a
1684 - Provide helpful error messages when the arguments to env.Install()
1687 - Fix the value returned by the Node.prevsiginfo() method to conform
1688 to a previous change when checking whether a node is current.
1690 - Supply a stack trace if the Taskmaster catches an exception.
1692 - When using a temporary file for a long link line on Win32 systems,
1693 (also) print the command line that is being executed through the
1696 - Initialize the LIB environment variable when using the Intel
1699 - Documentation fixes: better explain the AlwaysBuild() function.
1701 From Laurent Pelecq:
1703 - When the -debug=pdb option is specified, use pdb.Pdb().runcall() to
1704 call pdb directly, don't call Python recursively.
1708 - Add support for a platform-independent CPPDEFINES variable.
1710 From Christoph Wiedemann:
1712 - Have the g++ Tool actually use g++ in preference to c++.
1714 - Have the gcc Tool actually use gcc in preference to cc.
1716 - Add a gnutools.py test of the GNU tool chain.
1718 - Be smarter about linking: use $CC by default and $CXX only if we're
1719 linking with any C++ objects.
1721 - Avoid SCons hanging when a piped command has a lot of output to read.
1723 - Add QT support for preprocessing .ui files into .c files.
1727 RELEASE 0.90 - Wed, 25 Jun 2003 14:24:52 -0500
1731 - Fix the _concat() documentation, and add a test for it.
1733 - Portability fixes for non-GNU versions of lex and yacc.
1737 - Fix handling of library prefixes when the subdirectory matches
1740 From Timothee Bessett:
1742 - Add an M4 Builder.
1746 - Use '.lnk' as the suffix on the temporary file for linking long
1747 command lines (necessary for the Phar Lap linkloc linker).
1749 - Save non-string Options values as their actual type.
1751 - Save Options string values that contain a single quote correctly.
1753 - Save any Options values that are changed from the default
1754 Environment values, not just ones changed on the command line or in
1757 - Make closing the Options file descriptor exception-safe.
1761 - SCons now enforces (with an error) that construction variables
1762 must have the same form as valid Python identifiers.
1764 - Fix man page bugs: remove duplicate AddPostAction() description;
1765 document no_import_lib; mention that CPPFLAGS does not contain
1766 $_CPPINCFLAGS; mention that F77FLAGS does not contain $_F77INCFLAGS;
1767 mention that LINKFLAGS and SHLINKFLAGS contains neither $_LIBFLAGS
1770 - Eliminate a dependency on the distutils.fancy_getopt module by
1771 copying and pasting its wrap_text() function directly.
1773 - Make the Script.Options() subclass match the underlying base class
1776 - When reporting a target is up to date, quote the target like make
1777 (backquote-quote) instead of with double quotes.
1779 - Fix handling of ../* targets when using -U, -D or -u.
1783 - Don't update the .sconsign files when run with -n.
1785 From Gary Oberbrunner:
1787 - Add support for the Intel C Compiler (icl.exe).
1795 - Fix use of SConf in paths with white space in them.
1797 - Add CheckFunc and CheckType functionality to SConf.
1799 - Fix use of SConf with Builders that return a list of nodes.
1801 From David Snopek and Christoph Wiedemann
1803 - Fix use of the SConf subsystem with SConscriptChdir().
1807 - Check for the existence of MS Visual Studio on disk before using it,
1808 to avoid getting fooled by leftover junk in the registry.
1810 - Add support for MSVC++ .NET.
1812 - Add support for MS Visual Studio project files (DSP, DSW,
1813 SLN and VCPROJ files).
1815 From Christoph Wiedemann
1817 - SConf now works correctly when the -n and -q options are used.
1821 RELEASE 0.14 - Wed, 21 May 2003 05:16:32 -0500
1825 - Use .dll (not .so) for shared libraries on Cygwin; use -fPIC
1826 when compiling them.
1828 - Use 'rm' to remove files under Cygwin.
1830 - Add a PLATFORM variable to construction environments.
1832 - Remove the "platform" argument from tool specifications.
1834 - Propogate PYTHONPATH when running the regression tests so distutils
1835 can be found in non-standard locations.
1837 - Using MSVC long command-line linking when running Cygwin.
1839 - Portability fixes for a lot of tests.
1841 - Add a Value Node class for dependencies on in-core Python values.
1843 From Allen Bierbaum:
1845 - Pass an Environment to the Options validator method, and
1846 add an Options.Save() method.
1848 From Steve Christensen:
1850 - Add an optional sort function argument to the GenerateHelpText()
1853 - Evaluate the "varlist" variables when computing the signature of a
1858 - Parse the source .java files for class names (including inner class
1859 names) to figure out the target .class files that will be created.
1861 - Make Java support work with Repositories and SConscriptChdir(0).
1863 - Pass Nodes, not strings, to Builder emitter functions.
1865 - Refactor command-line interpolation and signature calculation
1866 so we can use real Node attributes.
1870 - Add Java support (javac, javah, jar and rmic).
1872 - Propagate the external SYSTEMROOT environment variable into ENV on
1873 Win32 systems, so external commands that use sockets will work.
1875 - Add a .posix attribute to PathList expansions.
1877 - Check out CVS source files using POSIX path names (forward slashes
1878 as separators) even on Win32.
1880 - Add Node.clear() and Node.FS.Entry.clear() methods to wipe out a
1881 Node's state, allowing it to be re-evaluated by continuous
1882 integration build interfaces.
1884 - Change the name of the Set{Build,Content}SignatureType() functions
1885 to {Target,Source}Signatures(). Deprecate the old names but support
1886 them for backwards compatibility.
1888 - Add internal SCons.Node.FS.{Dir,File}.Entry() methods.
1890 - Interpolate the null string if an out-of-range subscript is used
1891 for a construction variable.
1893 - Fix the internal Link function so that it properly links or copies
1894 files in subsidiary BuildDir directories.
1896 - Refactor the internal representation of a single execution instance
1897 of an action to eliminate redundant signature calculations.
1899 - Eliminate redundant signature calculations for Nodes.
1901 - Optimize out calling hasattr() before accessing attributes.
1903 - Say "Cleaning targets" (not "Building...") when the -c option is
1908 - Quote the "Entering directory" message like Make.
1910 From Stefan Reichor:
1912 - Add support for using Ghostscript to convert Postscript to PDF files.
1916 - Add a standalone "Alias" function (separate from an Environment).
1918 - Make Export() work for local variables.
1920 - Support passing a dictionary to Export().
1922 - Support Import('*') to import everything that's been Export()ed.
1924 - Fix an undefined exitvalmap on Win32 systems.
1926 - Support new SetOption() and GetOption() functions for setting
1927 various command-line options from with an SConscript file.
1929 - Deprecate the old SetJobs() and GetJobs() functions in favor of
1930 using the new generic {Set,Get}Option() functions.
1932 - Fix a number of tests that searched for a Fortran compiler using the
1933 external PATH instead of what SCons would use.
1935 - Fix the interaction of SideEffect() and BuildDir() so that (for
1936 example) PDB files get put correctly in a BuildDir().
1940 - Contribute the "Autoscons" code for Autoconf-like checking for
1941 the existence of libraries, header files and the like.
1943 - Have the Tool() function add the tool name to the $TOOLS
1944 construction variable.
1948 - Support the C preprocessor #import statement.
1950 - Allow the SharedLibrary() Builder on Win32 systems to be able to
1951 register a newly-built dll using regsvr32.
1953 - Add a Builder for Windows type library (.tlb) files from IDL files.
1955 - Add an IDL scanner.
1957 - Refactor the Fortran, C and IDL scanners to share common logic.
1959 - Add .srcpath and .srcdir attributes to $TARGET and $SOURCE.
1961 From Christoph Wiedemann:
1963 - Integrate David Snopek's "Autoscons" code as the new SConf
1964 configuration subsystem, including caching of values between
1965 runs (using normal SCons dependency mechanisms), tests, and
1970 RELEASE 0.13 - Mon, 31 Mar 2003 20:22:00 -0600
1974 - Fix a bug when BuildDir(duplicate=0) is used and SConscript
1975 files are called from within other SConscript files.
1977 - Support (older) versions of Perforce which don't set the Windows
1982 RELEASE 0.12 - Thu, 27 Mar 2003 23:52:09 -0600
1986 - Added support for the Perforce source code management system.
1988 - Fix str(Node.FS) so that it returns a path relative to the calling
1989 SConscript file's directory, not the top-level directory.
1991 - Added support for a separate src_dir argument to SConscript()
1992 that allows explicit specification of where the source files
1993 for an SConscript file can be found.
1995 - Support more easily re-usable flavors of command generators by
1996 calling callable variables when strings are expanded.
2000 - Added an INSTALL construction variable that can be set to a function
2001 to control how the Install() and InstallAs() Builders install files.
2002 The default INSTALL function now copies, not links, files.
2004 - Remove deprecated features: the "name" argument to Builder objects,
2005 and the Environment.Update() method.
2007 - Add an Environment.SourceCode() method to support fetching files
2008 from source code systems. Add factory methods that create Builders
2009 to support BitKeeper, CVS, RCS, and SCCS. Add support for fetching
2010 files from RCS or SCCS transparently (like GNU Make).
2012 - Make the internal to_String() function more efficient.
2014 - Make the error message the same as other build errors when there's a
2015 problem unlinking a target file in preparation for it being built.
2017 - Make TARGET, TARGETS, SOURCE and SOURCES reserved variable names and
2018 warn if the user tries to set them in a construction environment.
2020 - Add support for Tar and Zip files.
2022 - Better documentation of the different ways to export variables to a
2023 subsidiary SConscript file. Fix documentation bugs in a tools
2024 example, places that still assumed SCons split strings on white
2027 - Support fetching arbitrary files from the TARGETS or SOURCES lists
2028 (e.g. ${SOURCES[2]}) when calculating the build signature of a
2031 - Don't silently swallow exceptions thrown by Scanners (or other
2032 exceptions while finding a node's dependent children).
2034 - Push files to CacheDir() before calling the superclass built()
2035 method (which may clear the build signature as part of clearing
2036 cached implicit dependencies, if the file has a source scanner).
2037 (Bug reported by Jeff Petkau.)
2039 - Raise an internal error if we attempt to push a file to CacheDir()
2040 with a build signature of None.
2042 - Add an explicit Exit() function for terminating early.
2044 - Change the documentation to correctly describe that the -f option
2045 doesn't change to the directory in which the specified file lives.
2047 - Support changing directories locally with SConscript directory
2048 path names relative to any SConstruct file specified with -f.
2049 This allows you to build in another directory by simply changing
2050 there and pointing at the SConstruct file in another directory.
2052 - Change the default SConscriptChdir() behavior to change to the
2053 SConscript directory while it's being read.
2055 - Fix an exception thrown when the -U option was used with no
2056 Default() target specified.
2058 - Fix -u so that it builds things in corresponding build directories
2059 when used in a source directory.
2063 - Add SharedObject() support to the masm tool.
2065 - Fix WhereIs() to return normalized paths.
2069 - Don't copy a built file to a CacheDir() if it's already there.
2071 - Avoid partial copies of built files in a CacheDir() by copying
2072 to a temporary file and renaming.
2076 - Fix incorrect dependency-cycle errors when an Aliased source doesn't
2081 RELEASE 0.11 - Tue, 11 Feb 2003 05:24:33 -0600
2085 - Add support for IRIX and the SGI MIPSPro tool chain.
2087 - Support using the MSVC tool chain when running Cygwin Python.
2091 - Avoid losing signal bits in the exit status from a command,
2092 helping terminate builds on interrupt (CTRL+C).
2096 - Added new AddPreAction() and AddPostAction() functions that support
2097 taking additional actions before or after building specific targets.
2099 - Add support for the PharLap ETS tool chain.
2103 - Allow Python function Actions to specify a list of construction
2104 variables that should be included in the Action's signature.
2106 - Allow libraries in the LIBS variable to explicitly include the prefix
2107 and suffix, even when using the GNU linker.
2108 (Bug reported by Neal Becker.)
2110 - Use DOS-standard CR-LF line endings in the scons.bat file.
2111 (Bug reported by Gary Ruben.)
2113 - Doc changes: Eliminate description of deprecated "name" keyword
2114 argument from Builder definition (reported by Gary Ruben).
2116 - Support using env.Append() on BUILDERS (and other dictionaries).
2117 (Bug reported by Bj=F6rn Bylander.)
2119 - Setting the BUILDERS construction variable now properly clears
2120 the previous Builder attributes from the construction Environment.
2121 (Bug reported by Bj=F6rn Bylander.)
2123 - Fix adding a prefix to a file when the target isn't specified.
2124 (Bug reported by Esa Ilari Vuokko.)
2126 - Clean up error messages from problems duplicating into read-only
2127 BuildDir directories or into read-only files.
2129 - Add a CommandAction.strfunction() method, and add an "env" argument
2130 to the FunctionAction.strfunction() method, so that all Action
2131 objects have strfunction() methods, and the functions for building
2132 and returning a string both take the same arguments.
2134 - Add support for new CacheDir() functionality to share derived files
2135 between builds, with related options --cache-disable, --cache-force,
2138 - Change the default behavior when no targets are specified to build
2139 everything in the current directory and below (like Make). This
2140 can be disabled by specifying Default(None) in an SConscript.
2142 - Revamp SCons installation to fix a case-sensitive installation
2143 on Win32 systems, and to add SCons-specific --standard-lib,
2144 --standalone-lib, and --version-lib options for easier user
2145 control of where the libraries get installed.
2147 - Fix the ability to directly import and use Platform and Tool modules
2148 that have been implicitly imported into an Environment().
2150 - Add support for allowing an embedding interface to annotate a node
2153 - Extend the SConscript() function to accept build_dir and duplicate
2154 keyword arguments that function like a BuildDir() call.
2158 - Fix the output of -c -n when directories are involved, so it
2163 - Use a different shared object suffix (.os) when using gcc so shared
2164 and static objects can exist side-by-side in the same directory.
2166 - Allow the same object files on Win32 to be linked into either
2167 shared or static libraries.
2169 - Cache implicit cache values when using --implicit-cache.
2173 RELEASE 0.10 - Thu, 16 Jan 2003 04:11:46 -0600
2175 From Derrick 'dman' Hudson:
2177 - Support Repositories on other file systems by symlinking or
2178 copying files when hard linking won't work.
2182 - Remove Python bytecode (*.pyc) files from the scons-local packages.
2184 - Have FunctionActions print a description of what they're doing
2185 (a representation of the Python call).
2187 - Fix the Install() method so that, like other actions, it prints
2188 what would have happened when the -n option is used.
2190 - Don't create duplicate source files in a BuildDir when the -n
2193 - Refactor the Scanner interface to eliminate unnecessary Scanner
2194 calls and make it easier to write efficient scanners.
2196 - Added a "recursive" flag to Scanner creation that specifies the
2197 Scanner should be invoked recursively on dependency files returned
2200 - Significant performance improvement from using a more efficient
2201 check, throughout the code, for whether a Node has a Builder.
2203 - Fix specifying only the source file to MultiStepBuilders such as
2204 the Program Builder. (Bug reported by Dean Bair.)
2206 - Fix an exception when building from a file with the same basename as
2207 the subdirectory in which it lives. (Bug reported by Gerard Patel.)
2209 - Fix automatic deduction of a target file name when there are
2210 multiple source files specified; the target is now deduced from just
2211 the first source file in the list.
2213 - Documentation fixes: better initial explanation of SConscript files;
2214 fix a misformatted "table" in the StaticObject explanation.
2216 From Steven Knight and Steve Leblanc:
2218 - Fix the -c option so it will remove symlinks.
2222 - Add a Clean() method to support removing user-specified targets
2223 when using the -c option.
2225 - Add a development script for running SCons through PyChecker.
2227 - Clean up things found by PyChecker (mostly unnecessary imports).
2229 - Add a script to use HappyDoc to create HTML class documentation.
2233 - Make the Environment.get() method return None by default.
2237 - Add SetJobs() and GetJobs() methods to allow configuration of the
2238 number of default jobs (still overridden by -j).
2240 - Convert the .sconsign file format from ASCII to a pickled Python
2243 - Error message cleanups: Made consistent the format of error
2244 messages (now all start with "scons: ***") and warning messages (now
2245 all start with "scons: warning:"). Caught more cases with the "Do
2246 not know how to build" error message.
2248 - Added support for the MinGW tool chain.
2250 - Added a --debug=includes option.
2254 RELEASE 0.09 - Thu, 5 Dec 2002 04:48:25 -0600
2258 - Add a Prepend() method to Environments, to append values to
2259 the beginning of construction variables.
2263 - Add long command-line support to the "lib" Tool (Microsoft library
2268 - Allow $$ in a string to be passed through as $.
2270 - Support file names with odd characters in them.
2272 - Add support for construction variable substition on scanner
2273 directories (in CPPPATH, F77PATH, LIBPATH, etc.).
2275 From Charles Crain and Steven Knight:
2277 - Add Repository() functionality, including the -Y option.
2281 - Fix auto-deduction of target names so that deduced targets end
2282 up in the same subdirectory as the source.
2284 - Don't remove source files specified on the command line!
2286 - Suport the Intel Fortran Compiler (ifl.exe).
2288 - Supply an error message if there are no command-line or
2289 Default() targets specified.
2291 - Fix the ASPPCOM values for the GNU assembler.
2292 (Bug reported by Brett Polivka.)
2294 - Fix an exception thrown when a Default() directory was specified
2295 when using the -U option.
2297 - Issue a warning when -c can't remove a target.
2299 - Eliminate unnecessary Scanner calls by checking for the
2300 existence of a file before scanning it. (This adds a generic
2301 hook to check an arbitrary condition before scanning.)
2303 - Add explicit messages to tell when we're "Reading SConscript files
2304 ...," "done reading SConscript files," "Building targets," and
2305 "done building targets." Add a -Q option to supress these.
2307 - Add separate $SHOBJPREFIX and $SHOBJSUFFIX construction variables
2308 (by default, the same as $OBJPREFIX and $OBJSUFFIX).
2310 - Add Make-like error messages when asked to build a source file,
2311 and before trying to build a file that doesn't have all its source
2312 files (including when an invalid drive letter is used on WIN32).
2314 - Add an scons-local-{version} package (in both .tar.gz and .zip
2315 flavors) to help people who want to ship SCons as a stand-alone
2316 build tool in their software packages.
2318 - Prevent SCons from unlinking files in certain situations when
2319 the -n option is used.
2321 - Change the name of Tool/lib.py to Tool/mslib.py.
2323 From Steven Knight and Anthony Roach:
2325 - Man page: document the fact that Builder calls return Node objects.
2329 - Refactor option processing to use our own version of Greg Ward's
2330 Optik module, modified to run under Python 1.5.2.
2332 - Add a ParseConfig() command to modify an environment based on
2333 parsing output from a *-config command.
2337 - Fix interpretation of '#/../foo' on Win32 systems.
2341 - Fixed use of command lines with spaces in their arguments,
2342 and use of Nodes with spaces in their string representation.
2344 - Make access and modification times of files in a BuildDir match
2345 the source file, even when hard linking isn't available.
2347 - Make -U be case insensitive on Win32 systems.
2349 - Issue a warning and continue when finding a corrupt .sconsign file.
2351 - Fix using an alias as a dependency of a target so that if one of the
2352 alias' dependencies gets rebuilt, the resulting target will, too.
2354 - Fix differently ordered targets causing unnecessary rebuilds
2355 on case insensitive systems.
2357 - Use os.system() to execute external commands whenever the "env"
2358 utility is available, which is much faster than fork()/exec(),
2359 and fixes the -j option on several platforms.
2361 - Fix use of -j with multiple targets.
2363 - Add an Options() object for friendlier accomodation of command-
2366 - Add support for Microsoft VC++ precompiled header (.pch) files,
2367 debugger (.pdb) files, and resource (.rc) files.
2369 - Don't compute the $_CPPINCFLAGS, $_F77INCFLAGS, $_LIBFLAGS and
2370 $_LIBDIRFLAGS variables each time a command is executed, define
2371 them so they're computed only as needed. Add a new _concat
2372 function to the Environment that allows people to define their
2373 own similar variables.
2375 - Fix dependency scans when $LIBS is overridden.
2377 - Add EnsurePythonVersion() and EnsureSConsVersion() functions.
2379 - Fix the overly-verbose stack trace on ListBuilder build errors.
2381 - Add a SetContentSignatureType() function, allowing use of file
2382 timestamps instead of MD5 signatures.
2384 - Make -U and Default('source') fail gracefully.
2386 - Allow the File() and Dir() methods to take a path-name string as
2387 the starting directory, in addition to a Dir object.
2389 - Allow the command handler to be selected via the SPAWN, SHELL
2390 and ESCAPE construction variables.
2392 - Allow construction variables to be overridden when a Builder
2397 - Dynamically check for the existence of utilities with which to
2398 initialize Environments by default.
2402 RELEASE 0.08 - Mon, 15 Jul 2002 12:08:51 -0500
2406 - Fixed a bug with relative CPPPATH dirs when using BuildDir().
2407 (Bug reported by Bob Summerwill.)
2409 - Added a warnings framework and a --warn option to enable or
2412 - Make the C scanner warn users if files referenced by #include
2413 directives cannot be found and --warn=dependency is specified.
2415 - The BUILDERS construction variable should now be a dictionary
2416 that maps builder names to actions. Existing uses of lists,
2417 and the Builder name= keyword argument, generate warnings
2418 about use of deprecated features.
2420 - Removed the "shared" keyword argument from the Object and
2423 - Added separated StaticObject, SharedObject, StaticLibrary and
2424 SharedLibrary builders. Made Object and Library synonyms for
2425 StaticObject and StaticLibrary, respectively.
2427 - Add LIBS and LIBPATH dependencies for shared libraries.
2429 - Removed support for the prefix, suffix and src_suffix arguments
2430 to Builder() to be callable functions.
2432 - Fix handling file names with multiple dots.
2434 - Allow a build directory to be outside of the SConstruct tree.
2436 - Add a FindFile() function that searches for a file node with a
2439 - Add $CPPFLAGS to the shared-object command lines for g++ and gcc.
2441 From Charles Crain and Steven Knight:
2443 - Add a "tools=" keyword argument to Environment instantiation,
2444 and a separate Tools() method, for more flexible specification
2445 of tool-specific environment changes.
2449 - Add a "platform=" keyword argument to Environment instantiation,
2450 and a separate Platform() method, for more flexible specification
2451 of platform-specific environment changes.
2453 - Updated README instructions and setup.py code to catch an
2454 installation failure from not having distutils installed.
2456 - Add descriptions to the -H help text for -D, -u and -U so
2457 people can tell them apart.
2459 - Remove the old feature of automatically splitting strings
2460 of file names on white space.
2462 - Add a dependency Scanner for native Fortran "include" statements,
2463 using a new "F77PATH" construction variable.
2465 - Fix C #include scanning to detect file names with characters like
2468 - Add more specific version / build output to the -v option.
2470 - Add support for the GNU as, Microsoft masm, and nasm assemblers.
2472 - Allow the "target" argument to a Builder call to be omitted, in
2473 which case the target(s) are deduced from the source file(s) and the
2474 Builder's specified suffix.
2476 - Add a tar archive builder.
2478 - Add preliminary support for the OS/2 Platform, including the icc
2483 - Fix --implicit-cache if the scanner returns an empty list.
2487 - Add a "multi" keyword argument to Builder creation that specifies
2488 it's okay to call the builder multiple times for a target.
2490 - Set a "multi" on Aliases so multiple calls will append to an Alias.
2492 - Fix emitter functions' use of path names when using BuildDir or
2495 - Fix --implicit-cache causing redundant rebuilds when the header
2498 - Fix --implicit-cache when a file has no implicit dependencies and
2499 its source is generated.
2501 - Make the drive letters on Windows always be the same case, so that
2502 changes in the case of drive letters don't cause a rebuild.
2504 - Fall back to importing the SCons.TimeStamp module if the SCons.MD5
2505 module can't be imported.
2507 - Fix interrupt handling to guarantee that a single interrupt will
2508 halt SCons both when using -j and not.
2510 - Fix .sconsign signature storage so that output files of one build
2511 can be safely used as input files to another build.
2513 - Added a --debug=time option to print SCons execution times.
2515 - Print an error message if a file can't be unlinked before being
2516 built, rather than just silently terminating the build.
2518 - Add a SideEffect() method that can be used to tell the build
2519 engine that a given file is created as a side effect of building
2520 a target. A file can be specified as a side effect of more than
2521 one build comand, in which case the commands will not be executed
2524 - Significant performance gains from not using our own version of
2525 the inefficient stock os.path.splitext() method, caching source
2526 suffix computation, code cleanup in MultiStepBuilder.__call__(),
2527 and replicating some logic in scons_subst().
2529 - Add --implicit-deps-changed and --implicit-deps-unchanged options.
2531 - Add a GetLaunchDir() function.
2533 - Add a SetBuildSignatureType() function.
2537 - Add an Append() method to Environments, to append values to
2538 construction variables.
2540 - Change the name of Update() to Replace(). Keep Update() as a
2541 deprecated synonym, at least for now.
2543 From Terrel Shumway:
2545 - Use a $PYTHON construction variable, initialized to sys.executable,
2546 when using Python to build parts of the SCons packages.
2548 - Use sys.prefix, not sys.exec_prefix, to find pdb.py.
2552 RELEASE 0.07 - Thu, 2 May 2002 13:37:16 -0500
2556 - Changes to build SCons packages on IRIX (and other *NIces).
2558 - Don't create a directory Node when a file already exists there,
2561 - Add 'dirs' and 'names' keyword arguments to SConscript for
2562 easier specification of subsidiary SConscript files.
2566 - Internal cleanup of environment passing to function Actions.
2568 - Builders can now take arbitrary keyword arguments to create
2569 attributes to be passed to: command generator functions,
2570 FunctionAction functions, Builder emitter functions (below),
2571 and prefix/suffix generator functions (below).
2573 - Command generator functions can now return ANYTHING that can be
2574 converted into an Action (a function, a string, a CommandGenerator
2575 instance, even an ActionBase instance).
2577 - Actions now call get_contents() with the actual target and source
2578 nodes used for the build.
2580 - A new DictCmdGenerator class replaces CompositeBuilder to support
2581 more flexible Builder behavior internally.
2583 - Builders can now take an emitter= keyword argument. An emitter
2584 is a function that takes target, source, and env argument, then
2585 return a 2-tuple of (new sources, new targets). The emitter is
2586 called when the Builder is __call__'ed, allowing a user to modify
2587 source and target lists.
2589 - The prefix, suffix and src_suffix Builder arguments now take a
2590 callable as well a string. The callable is passed the Environment
2591 and any extra Builder keyword arguments and is expected to return
2592 the appropriate prefix or suffix.
2594 - CommandActions can now be a string, a list of command + argument
2595 strings, or a list of commands (strings or lists).
2597 - Added shared library support. The Object and Library Builders now
2598 take a "shared=1" keyword argument to specify that a shared object
2599 or shared library should be built. It is an error to try to build
2600 static objects into a shared library or vice versa.
2602 - Win32 support for .def files has been added. Added the Win32-specific
2603 construction variables $WIN32DEFPREFIX, $WIN32DEFSUFFIX,
2604 $WIN32DLLPREFIX and $WIN32IMPLIBPREFIX. When building a .dll,
2605 the new construction variable $WIN32_INSERT_DEF, controls whether
2606 the appropriately-named .def file is inserted into the target
2607 list (if not already present). A .lib file is always added to
2608 a Library build if not present in the list of targets.
2610 - ListBuilder now passes all targets to the action, not just the first.
2612 - Fix so that -c now deletes generated yacc .h files.
2614 - Builder actions and emitter functions can now be initialized, through
2615 construction variables, to things other than strings.
2617 - Make top-relative '#/dir' lookups work like '#dir'.
2619 - Fix for relative CPPPATH directories in subsidiary SConscript files
2622 - Add a for_signature argument to command generators, so that
2623 generators that need to can return distinct values for the
2624 command signature and for executing the command.
2628 - Create a better scons.bat file from a py2bat.py script on the Python
2629 mailing list two years ago (modeled after pl2bat.pl).
2633 - Fix so that -c -n does *not* remove the targets!
2635 - Man page: Add a hierarchical libraries + Program example.
2637 - Support long MSVC linker command lines through a builder action
2638 that writes to a temporary file and uses the magic MSVC "link @file"
2639 argument syntax if the line is longer than 2K characters.
2641 - Fix F77 command-line options on Win32 (use /Fo instead of -o).
2643 - Use the same action to build from .c (lower case) and .C (upper
2644 case) files on case-insensitive systems like Win32.
2646 - Support building a PDF file directly from a TeX or LaTeX file
2647 using pdftex or pdflatex.
2649 - Add a -x option to runtest.py to specify the script being tested.
2650 A -X option indicates it's an executable, not a script to feed
2651 to the Python interpreter.
2653 - Add a Split() function (identical to SCons.Util.argmunge()) for use
2654 in the next release, when Builders will no longer automatically split
2655 strings on white space.
2659 - Add the SConscriptChdir() method.
2663 - Fix --debug=tree when used with directory targets.
2665 - Significant internal restructuring of Scanners and Taskmaster.
2667 - Added new --debug=dtree option.
2669 - Fixes for --profile option.
2671 - Performance improvement in construction variable substitution.
2673 - Implemented caching of content signatures, plus added --max-drift
2674 option to control caching.
2676 - Implemented caching of dependency signatures, enabled by new
2677 --implicit-cache option.
2679 - Added abspath construction variable modifier.
2681 - Added $SOURCE variable as a synonym for $SOURCES[0].
2683 - Write out .sconsign files on error or interrupt so intermediate
2684 build results are saved.
2686 - Change the -U option to -D. Make a new -U that builds just the
2687 targets from the local SConscript file.
2689 - Fixed use of sys.path so Python modules can be imported from
2690 the SConscript directory.
2692 - Fix for using Aliases with the -u, -U and -D options.
2694 - Fix so that Nodes can be passed to SConscript files.
2698 - Changes for official Debian packaging.
2702 RELEASE 0.06 - Thu, 28 Mar 2002 01:24:29 -0600
2706 - Fix command generators to expand construction variables.
2708 - Make FunctionAction arguments be Nodes, not strings.
2710 From Stephen Kennedy:
2712 - Performance: Use a dictionary, not a list, for a Node's parents.
2716 - Add .zip files to the packages we build.
2718 - Man page: document LIBS, fix a typo, document ARGUMENTS.
2720 - Added RANLIB and RANLIBFLAGS construction variables. Only use them
2721 in ARCOM if there's a "ranlib" program on the system.
2723 - Add a configurable CFILESUFFIX for the Builder of .l and .y files
2726 - Add a CXXFile Builder that turns .ll and .yy files into .cc files
2727 (configurable via a CXXFILESUFFIX construction variable).
2729 - Use the POSIX-standard lex -t flag, not the GNU-specific -o flag.
2730 (Bug reported by Russell Christensen.)
2732 - Fixed an exception when CPPPATH or LIBPATH is a null string.
2733 (Bug reported by Richard Kiss.)
2735 - Add a --profile=FILE option to make profiling SCons easier.
2737 - Modify the new DVI builder to create .dvi files from LaTeX (.ltx
2740 - Add support for Aliases (phony targets).
2742 - Add a WhereIs() method for searching for path names to executables.
2744 - Add PDF and PostScript document builders.
2746 - Add support for compiling Fortran programs from a variety of
2747 suffixes (a la GNU Make): .f, .F, .for, .FOR, .fpp and .FPP
2749 - Support a CPPFLAGS variable on all default commands that use the
2754 - Add support for the -U option.
2756 - Allow CPPPATH, LIBPATH and LIBS to be specified as white-space
2759 - Add a document builder to create .dvi files from TeX (.tex) files.
2763 - Fix: Construction variables with values of 0 were incorrectly
2766 - Support env['VAR'] to fetch construction variable values.
2768 - Man page: document Precious().
2772 RELEASE 0.05 - Thu, 21 Feb 2002 16:50:03 -0600
2776 - Set PROGSUFFIX to .exe under Cygwin.
2780 - Allow a library to specified as a command-line source file, not just
2781 in the LIBS construction variable.
2783 - Compensate for a bug in os.path.normpath() that returns '' for './'
2786 - More performance optimizations: cache #include lines from files,
2787 eliminate unnecessary calls.
2789 - If a prefix or suffix contains white space, treat the resulting
2790 concatenation as separate arguments.
2792 - Fix irregularities in the way we fetch DevStudio information from
2793 the Windows registry, and in our registry error handling.
2797 - Flush stdout after print so it intermixes correctly with stderr
2800 - Allow Scanners to return a list of strings, and document how to
2801 write your own Scanners.
2803 - Look up implicit (scanned) dependencies relative to the directory
2804 of file being scanned.
2806 - Make writing .sconsign files more robust by first trying to write
2807 to a temp file that gets renamed.
2809 - Create all of the directories for a list of targets before trying
2810 to build any of the targets.
2812 - WIN32 portability fixes in tests.
2814 - Allow the list of variables exported to an SConscript file to be
2817 - Document the overlooked LIBPATH construction variable.
2818 (Bug reported by Eicke Godehardt.)
2820 - Fix so that Ignore() ignores indirect, implicit dependencies
2821 (included files), not just direct dependencies.
2823 - Put the man page in the Debian distribution.
2825 - Run HTML docs through tidy to clean up the HTML (for Konqueror).
2827 - Add preliminary support for Unicode strings.
2829 - Efficiency: don't scan dependencies more than once during the
2832 - Fix the -c option so it doesn't stop removing targets if one doesn't
2834 (Bug reported by Paul Connell.)
2836 - Fix the --debug=pdb option when run on Windows NT.
2837 (Bug reported by Paul Connell.)
2839 - Add support for the -q option.
2843 - Add support for the -u option.
2845 - Add .cc and .hh file suffixes to the C Scanner.
2849 - Make the scons script return an error code on failures.
2851 - Add support for using code to generate a command to build a target.
2855 RELEASE 0.04 - Wed, 30 Jan 2002 11:09:42 -0600
2859 - Significant performance improvements in the Node.FS and
2862 - Fix signatures of binary files on Win32 systems.
2864 - Allow LIBS and LIBPATH to be strings, not just arrays.
2866 - Print a traceback if a Python-function builder throws an exception.
2870 - Fix using a directory as a Default(), and allow Default() to
2871 support white space in file names for strings in arrays.
2873 - Man page updates: corrected some mistakes, documented various
2874 missing Environment methods, alphabetized the construction
2875 variables and other functions, defined begin and end macros for
2876 the example sections, regularized white space separation, fixed
2877 the use of Export() in the Multiple Variants example.
2879 - Function action fixes: None is now a successful return value.
2880 Exceptions are now reported. Document function actions.
2882 - Add 'Action' and 'Scanner' to the global keywords so SConscript
2883 files can use them too.
2885 - Removed the Wrapper class between Nodes and Walkers.
2887 - Add examples using Library, LIBS, and LIBPATH.
2889 - The C Scanner now always returns a sorted list of dependencies
2890 so order changes don't cause unnecessary rebuilds.
2892 - Strip $(-$) bracketed text from command lines. Use this to
2893 surround $_INCDIRS and $_LIBDIRS so we don't rebuild in response
2894 to changes to -I or -L options.
2896 - Add the Ignore() method to ignore dependencies.
2898 - Provide an error message when a nonexistent target is specified
2899 on the command line.
2901 - Remove targets before building them, and add an Environment
2902 Precious() method to override that.
2904 - Eliminate redundant calls to the same builder when the target is a
2905 list of targets: Add a ListBuilder class that wraps Builders to
2906 handle lists atomically. Extend the Task class to support building
2907 and updating multiple targets in a single Task. Simplify the
2908 interface between Task and Taskmaster.
2910 - Add a --debug=pdb option to re-run SCons under the Python debugger.
2912 - Only compute a build signature once for each node.
2914 - Changes to our sys.path[] manipulation to support installation into
2915 an arbitrary --prefix value.
2919 - Add var=value command-line arguments.
2923 RELEASE 0.03 - Fri, 11 Jan 2002 01:09:30 -0600
2927 - Performance improvements in the Node.FS and Sig.Calculator classes.
2929 - Add the InstallAs() method.
2931 - Execute commands through an external interpreter (sh, cmd.exe, or
2932 command.com) to handle redirection metacharacters.
2934 - Allow the user to supply a command handler.
2938 - Search both /usr/lib and /usr/local/lib for scons directories by
2939 adding them both to sys.path, with whichever is in sys.prefix first.
2941 - Fix interpreting strings of multiple white-space separated file names
2942 as separate file names, allowing prefixes and suffixes to be appended
2943 to each individually.
2945 - Refactor to move CompositeBuilder initialization logic from the
2946 factory wrapper to the __init__() method, and allow a Builder to
2947 have both an action and a src_builder (or array of them).
2949 - Refactor BuilderBase.__call__() to separate Node creation/lookup
2950 from initialization of the Node's builder information.
2952 - Add a CFile Builder object that supports turning lex (.l) and
2953 yacc (.y) files into .c files.
2955 - Document: variable interpretation attributes; how to propogate
2956 the user's environment variables to executed commands; how to
2957 build variants in multiple BuildDirs.
2959 - Collect String, Dict, and List type-checking in common utility
2960 routines so we can accept User{String,Dict,List}s all over.
2962 - Put the Action factory and classes into their own module.
2964 - Use one CPlusPlusAction in the Object Builder's action dictionary,
2965 instead of letting it create multiple identical instances.
2967 - Document the Install() and InstallAs() methods.
2971 - Require that a Builder be given a name argument, supplying a
2972 useful error message when it isn't.
2976 - Add a "duplicate" keyword argument to BuildDir() that can be set
2977 to prevent linking/copying source files into build directories.
2979 - Add a "--debug=tree" option to print an ASCII dependency tree.
2981 - Fetch the location of the Microsoft Visual C++ compiler(s) from
2982 the Registry, instead of hard-coding the location.
2984 - Made Scanner objects take Nodes, not path names.
2986 - Have the C Scanner cache the #include file names instead of
2987 (re-)scanning the file each time it's called.
2989 - Created a separate class for parent "nodes" of file system roots,
2990 eliminating the need for separate is-parent-null checks everywhere.
2992 - Removed defined __hash__() and __cmp() methods from FS.Entry, in
2993 favor of Python's more efficient built-in identity comparisons.
2997 RELEASE 0.02 - Sun, 23 Dec 2001 19:05:09 -0600
3001 - Added the Install(), BuildDir(), and Export() methods.
3003 - Fix the -C option by delaying setting the top of the FS tree.
3005 - Avoid putting the directory path on the libraries in the LIBS
3006 construction variable.
3008 - Added a GetBuildPath() method to return the full path to the
3009 Node for a specified string.
3011 - Fixed variable substitution in CPPPATH and LIBPATH.
3015 - Fixed the version comment in the scons.bat (the UNIX geek used
3018 - Fix to setup.py so it doesn't require a sys.argv[1] argument.
3020 - Provide make-like warning message for "command not found" and
3023 - Added an EXAMPLES section to the man page.
3025 - Make Default() targets properly relative to their SConscript
3026 file's subdirectory.
3030 - Documented CXXFLAGS, CXXCOM, and CPPPATH.
3032 - Fixed SCONS_LIB_DIR to work as documented.
3034 - Made Default() accept Nodes as arguments.
3036 - Changed Export() to make it easier to use.
3038 - Added the Import() and Return() methods.
3042 RELEASE 0.01 - Thu Dec 13 19:25:23 CST 2001
3044 A brief overview of important functionality available in release 0.01:
3046 - C and C++ compilation on POSIX and Windows NT.
3048 - Automatic scanning of C/C++ source files for #include dependencies.
3050 - Support for building libraries; setting construction variables
3051 allows creation of shared libraries.
3053 - Library and C preprocessor search paths.
3055 - File changes detected using MD5 signatures.
3057 - User-definable Builder objects for building files.
3059 - User-definable Scanner objects for scanning for dependencies.
3061 - Parallel build (-j) support.
3063 - Dependency cycles detected.
3065 - Linux packages available in RPM and Debian format.
3067 - Windows installer available.