2 # __FILE__ __REVISION__ __DATE__ __DEVELOPER__
5 SCons - a software construction tool
15 - Support specifying a list of tools when calling Environment.Copy().
17 - Give a Value Nodes a timestamp of the system time when they're
18 created, so they'll work when using timestamp-based signatures.
20 - Add a DefaultEnvironment() function that only creates a default
21 environment on-demand (for fetching source files, e.g.).
23 - Portability fix for test/M4.py.
27 - Tighten up the scons -H help output.
29 - When the input yacc file ends in .yy and the -d flag is specified,
30 recognize that a .hpp file (not a .h file) will be created.
32 - Make builder prefixes work correctly when deducing a target
33 from a source file name in another directory.
35 - Documentation fixes: typo in the man page.
37 - Use "cvs co -d" instead of "cvs co -p >" when checking out something
38 from CVS with a specified module name. This avoids zero-length
39 files when there is a checkout error.
41 - Add an "sconsign" script to print the contents of .sconsign files.
43 - Speed up maintaining the various lists of Node children by using
44 dictionaries to avoid "x in list" searches.
46 - Cache the computed list of Node children minus those being Ignored
47 so it's only calculated once.
49 - Fix use of the --cache-show option when building a Program()
50 (or using any other arbitrary action) by making sure all Action
51 instances have strfunction() methods.
53 From Gary Oberbrunner:
55 - Report the target being built in error messages when building
56 multiple sources from different extensions, or when the target file
57 extension can't be deduced, or when we don't have an action for a
60 - Provide helpful error messages when the arguments to env.Install()
63 - Fix the value returned by the Node.prevsiginfo() method to conform
64 to a previous change when checking whether a node is current.
68 - When the -debug=pdb option is specified, use pdb.Pdb().runcall() to
69 call pdb directly, don't call Python recursively.
71 From Christoph Wiedemann:
73 - Have the g++ Tool actually use g++ in preference to c++.
75 - Have the gcc Tool actually use gcc in preference to cc.
77 - Add a gnutools.py test of the GNU tool chain.
79 - Be smarter about linking: use $CC by default and $CXX only if we're
80 linking with any C++ objects.
82 - Avoid SCons hanging when a piped command has a lot of output to read.
84 - Add QT support for preprocessing .ui files into .c files.
88 RELEASE 0.90 - Wed, 25 Jun 2003 14:24:52 -0500
92 - Fix the _concat() documentation, and add a test for it.
94 - Portability fixes for non-GNU versions of lex and yacc.
98 - Fix handling of library prefixes when the subdirectory matches
101 From Timothee Bessett:
107 - Use '.lnk' as the suffix on the temporary file for linking long
108 command lines (necessary for the Phar Lap linkloc linker).
110 - Save non-string Options values as their actual type.
112 - Save Options string values that contain a single quote correctly.
114 - Save any Options values that are changed from the default
115 Environment values, not just ones changed on the command line or in
118 - Make closing the Options file descriptor exception-safe.
122 - SCons now enforces (with an error) that construction variables
123 must have the same form as valid Python identifiers.
125 - Fix man page bugs: remove duplicate AddPostAction() description;
126 document no_import_lib; mention that CPPFLAGS does not contain
127 $_CPPINCFLAGS; mention that F77FLAGS does not contain $_F77INCFLAGS;
128 mention that LINKFLAGS and SHLINKFLAGS contains neither $_LIBFLAGS
131 - Eliminate a dependency on the distutils.fancy_getopt module by
132 copying and pasting its wrap_text() function directly.
134 - Make the Script.Options() subclass match the underlying base class
137 - When reporting a target is up to date, quote the target like make
138 (backquote-quote) instead of with double quotes.
140 - Fix handling of ../* targets when using -U, -D or -u.
144 - Don't update the .sconsign files when run with -n.
146 From Gary Oberbrunner:
148 - Add support for the Intel C Compiler (icl.exe).
156 - Fix use of SConf in paths with white space in them.
158 - Add CheckFunc and CheckType functionality to SConf.
160 - Fix use of SConf with Builders that return a list of nodes.
162 From David Snopek and Christoph Wiedemann
164 - Fix use of the SConf subsystem with SConscriptChdir().
168 - Check for the existence of MS Visual Studio on disk before using it,
169 to avoid getting fooled by leftover junk in the registry.
171 - Add support for MSVC++ .NET.
173 - Add support for MS Visual Studio project files (DSP, DSW,
174 SLN and VCPROJ files).
176 From Christoph Wiedemann
178 - SConf now works correctly when the -n and -q options are used.
182 RELEASE 0.14 - Wed, 21 May 2003 05:16:32 -0500
186 - Use .dll (not .so) for shared libraries on Cygwin; use -fPIC
189 - Use 'rm' to remove files under Cygwin.
191 - Add a PLATFORM variable to construction environments.
193 - Remove the "platform" argument from tool specifications.
195 - Propogate PYTHONPATH when running the regression tests so distutils
196 can be found in non-standard locations.
198 - Using MSVC long command-line linking when running Cygwin.
200 - Portability fixes for a lot of tests.
202 - Add a Value Node class for dependencies on in-core Python values.
206 - Pass an Environment to the Options validator method, and
207 add an Options.Save() method.
209 From Steve Christensen:
211 - Add an optional sort function argument to the GenerateHelpText()
214 - Evaluate the "varlist" variables when computing the signature of a
219 - Parse the source .java files for class names (including inner class
220 names) to figure out the target .class files that will be created.
222 - Make Java support work with Repositories and SConscriptChdir(0).
224 - Pass Nodes, not strings, to Builder emitter functions.
226 - Refactor command-line interpolation and signature calculation
227 so we can use real Node attributes.
231 - Add Java support (javac, javah, jar and rmic).
233 - Propagate the external SYSTEMROOT environment variable into ENV on
234 Win32 systems, so external commands that use sockets will work.
236 - Add a .posix attribute to PathList expansions.
238 - Check out CVS source files using POSIX path names (forward slashes
239 as separators) even on Win32.
241 - Add Node.clear() and Node.FS.Entry.clear() methods to wipe out a
242 Node's state, allowing it to be re-evaluated by continuous
243 integration build interfaces.
245 - Change the name of the Set{Build,Content}SignatureType() functions
246 to {Target,Source}Signatures(). Deprecate the old names but support
247 them for backwards compatibility.
249 - Add internal SCons.Node.FS.{Dir,File}.Entry() methods.
251 - Interpolate the null string if an out-of-range subscript is used
252 for a construction variable.
254 - Fix the internal Link function so that it properly links or copies
255 files in subsidiary BuildDir directories.
257 - Refactor the internal representation of a single execution instance
258 of an action to eliminate redundant signature calculations.
260 - Eliminate redundant signature calculations for Nodes.
262 - Optimize out calling hasattr() before accessing attributes.
264 - Say "Cleaning targets" (not "Building...") when the -c option is
269 - Quote the "Entering directory" message like Make.
273 - Add support for using Ghostscript to convert Postscript to PDF files.
277 - Add a standalone "Alias" function (separate from an Environment).
279 - Make Export() work for local variables.
281 - Support passing a dictionary to Export().
283 - Support Import('*') to import everything that's been Export()ed.
285 - Fix an undefined exitvalmap on Win32 systems.
287 - Support new SetOption() and GetOption() functions for setting
288 various command-line options from with an SConscript file.
290 - Deprecate the old SetJobs() and GetJobs() functions in favor of
291 using the new generic {Set,Get}Option() functions.
293 - Fix a number of tests that searched for a Fortran compiler using the
294 external PATH instead of what SCons would use.
296 - Fix the interaction of SideEffect() and BuildDir() so that (for
297 example) PDB files get put correctly in a BuildDir().
301 - Contribute the "Autoscons" code for Autoconf-like checking for
302 the existence of libraries, header files and the like.
304 - Have the Tool() function add the tool name to the $TOOLS
305 construction variable.
309 - Support the C preprocessor #import statement.
311 - Allow the SharedLibrary() Builder on Win32 systems to be able to
312 register a newly-built dll using regsvr32.
314 - Add a Builder for Windows type library (.tlb) files from IDL files.
316 - Add an IDL scanner.
318 - Refactor the Fortran, C and IDL scanners to share common logic.
320 - Add .srcpath and .srcdir attributes to $TARGET and $SOURCE.
322 From Christoph Wiedemann:
324 - Integrate David Snopek's "Autoscons" code as the new SConf
325 configuration subsystem, including caching of values between
326 runs (using normal SCons dependency mechanisms), tests, and
331 RELEASE 0.13 - Mon, 31 Mar 2003 20:22:00 -0600
335 - Fix a bug when BuildDir(duplicate=0) is used and SConscript
336 files are called from within other SConscript files.
338 - Support (older) versions of Perforce which don't set the Windows
343 RELEASE 0.12 - Thu, 27 Mar 2003 23:52:09 -0600
347 - Added support for the Perforce source code management system.
349 - Fix str(Node.FS) so that it returns a path relative to the calling
350 SConscript file's directory, not the top-level directory.
352 - Added support for a separate src_dir argument to SConscript()
353 that allows explicit specification of where the source files
354 for an SConscript file can be found.
356 - Support more easily re-usable flavors of command generators by
357 calling callable variables when strings are expanded.
361 - Added an INSTALL construction variable that can be set to a function
362 to control how the Install() and InstallAs() Builders install files.
363 The default INSTALL function now copies, not links, files.
365 - Remove deprecated features: the "name" argument to Builder objects,
366 and the Environment.Update() method.
368 - Add an Environment.SourceCode() method to support fetching files
369 from source code systems. Add factory methods that create Builders
370 to support BitKeeper, CVS, RCS, and SCCS. Add support for fetching
371 files from RCS or SCCS transparently (like GNU Make).
373 - Make the internal to_String() function more efficient.
375 - Make the error message the same as other build errors when there's a
376 problem unlinking a target file in preparation for it being built.
378 - Make TARGET, TARGETS, SOURCE and SOURCES reserved variable names and
379 warn if the user tries to set them in a construction environment.
381 - Add support for Tar and Zip files.
383 - Better documentation of the different ways to export variables to a
384 subsidiary SConscript file. Fix documentation bugs in a tools
385 example, places that still assumed SCons split strings on white
388 - Support fetching arbitrary files from the TARGETS or SOURCES lists
389 (e.g. ${SOURCES[2]}) when calculating the build signature of a
392 - Don't silently swallow exceptions thrown by Scanners (or other
393 exceptions while finding a node's dependent children).
395 - Push files to CacheDir() before calling the superclass built()
396 method (which may clear the build signature as part of clearing
397 cached implicit dependencies, if the file has a source scanner).
398 (Bug reported by Jeff Petkau.)
400 - Raise an internal error if we attempt to push a file to CacheDir()
401 with a build signature of None.
403 - Add an explicit Exit() function for terminating early.
405 - Change the documentation to correctly describe that the -f option
406 doesn't change to the directory in which the specified file lives.
408 - Support changing directories locally with SConscript directory
409 path names relative to any SConstruct file specified with -f.
410 This allows you to build in another directory by simply changing
411 there and pointing at the SConstruct file in another directory.
413 - Change the default SConscriptChdir() behavior to change to the
414 SConscript directory while it's being read.
416 - Fix an exception thrown when the -U option was used with no
417 Default() target specified.
419 - Fix -u so that it builds things in corresponding build directories
420 when used in a source directory.
424 - Add SharedObject() support to the masm tool.
426 - Fix WhereIs() to return normalized paths.
430 - Don't copy a built file to a CacheDir() if it's already there.
432 - Avoid partial copies of built files in a CacheDir() by copying
433 to a temporary file and renaming.
437 - Fix incorrect dependency-cycle errors when an Aliased source doesn't
442 RELEASE 0.11 - Tue, 11 Feb 2003 05:24:33 -0600
446 - Add support for IRIX and the SGI MIPSPro tool chain.
448 - Support using the MSVC tool chain when running Cygwin Python.
452 - Avoid losing signal bits in the exit status from a command,
453 helping terminate builds on interrupt (CTRL+C).
457 - Added new AddPreAction() and AddPostAction() functions that support
458 taking additional actions before or after building specific targets.
460 - Add support for the PharLap ETS tool chain.
464 - Allow Python function Actions to specify a list of construction
465 variables that should be included in the Action's signature.
467 - Allow libraries in the LIBS variable to explicitly include the prefix
468 and suffix, even when using the GNU linker.
469 (Bug reported by Neal Becker.)
471 - Use DOS-standard CR-LF line endings in the scons.bat file.
472 (Bug reported by Gary Ruben.)
474 - Doc changes: Eliminate description of deprecated "name" keyword
475 argument from Builder definition (reported by Gary Ruben).
477 - Support using env.Append() on BUILDERS (and other dictionaries).
478 (Bug reported by Bj=F6rn Bylander.)
480 - Setting the BUILDERS construction variable now properly clears
481 the previous Builder attributes from the construction Environment.
482 (Bug reported by Bj=F6rn Bylander.)
484 - Fix adding a prefix to a file when the target isn't specified.
485 (Bug reported by Esa Ilari Vuokko.)
487 - Clean up error messages from problems duplicating into read-only
488 BuildDir directories or into read-only files.
490 - Add a CommandAction.strfunction() method, and add an "env" argument
491 to the FunctionAction.strfunction() method, so that all Action
492 objects have strfunction() methods, and the functions for building
493 and returning a string both take the same arguments.
495 - Add support for new CacheDir() functionality to share derived files
496 between builds, with related options --cache-disable, --cache-force,
499 - Change the default behavior when no targets are specified to build
500 everything in the current directory and below (like Make). This
501 can be disabled by specifying Default(None) in an SConscript.
503 - Revamp SCons installation to fix a case-sensitive installation
504 on Win32 systems, and to add SCons-specific --standard-lib,
505 --standalone-lib, and --version-lib options for easier user
506 control of where the libraries get installed.
508 - Fix the ability to directly import and use Platform and Tool modules
509 that have been implicitly imported into an Environment().
511 - Add support for allowing an embedding interface to annotate a node
514 - Extend the SConscript() function to accept build_dir and duplicate
515 keyword arguments that function like a BuildDir() call.
519 - Fix the output of -c -n when directories are involved, so it
524 - Use a different shared object suffix (.os) when using gcc so shared
525 and static objects can exist side-by-side in the same directory.
527 - Allow the same object files on Win32 to be linked into either
528 shared or static libraries.
530 - Cache implicit cache values when using --implicit-cache.
534 RELEASE 0.10 - Thu, 16 Jan 2003 04:11:46 -0600
536 From Derrick 'dman' Hudson:
538 - Support Repositories on other file systems by symlinking or
539 copying files when hard linking won't work.
543 - Remove Python bytecode (*.pyc) files from the scons-local packages.
545 - Have FunctionActions print a description of what they're doing
546 (a representation of the Python call).
548 - Fix the Install() method so that, like other actions, it prints
549 what would have happened when the -n option is used.
551 - Don't create duplicate source files in a BuildDir when the -n
554 - Refactor the Scanner interface to eliminate unnecessary Scanner
555 calls and make it easier to write efficient scanners.
557 - Added a "recursive" flag to Scanner creation that specifies the
558 Scanner should be invoked recursively on dependency files returned
561 - Significant performance improvement from using a more efficient
562 check, throughout the code, for whether a Node has a Builder.
564 - Fix specifying only the source file to MultiStepBuilders such as
565 the Program Builder. (Bug reported by Dean Bair.)
567 - Fix an exception when building from a file with the same basename as
568 the subdirectory in which it lives. (Bug reported by Gerard Patel.)
570 - Fix automatic deduction of a target file name when there are
571 multiple source files specified; the target is now deduced from just
572 the first source file in the list.
574 - Documentation fixes: better initial explanation of SConscript files;
575 fix a misformatted "table" in the StaticObject explanation.
577 From Steven Knight and Steve Leblanc:
579 - Fix the -c option so it will remove symlinks.
583 - Add a Clean() method to support removing user-specified targets
584 when using the -c option.
586 - Add a development script for running SCons through PyChecker.
588 - Clean up things found by PyChecker (mostly unnecessary imports).
590 - Add a script to use HappyDoc to create HTML class documentation.
594 - Make the Environment.get() method return None by default.
598 - Add SetJobs() and GetJobs() methods to allow configuration of the
599 number of default jobs (still overridden by -j).
601 - Convert the .sconsign file format from ASCII to a pickled Python
604 - Error message cleanups: Made consistent the format of error
605 messages (now all start with "scons: ***") and warning messages (now
606 all start with "scons: warning:"). Caught more cases with the "Do
607 not know how to build" error message.
609 - Added support for the MinGW tool chain.
611 - Added a --debug=includes option.
615 RELEASE 0.09 - Thu, 5 Dec 2002 04:48:25 -0600
619 - Add a Prepend() method to Environments, to append values to
620 the beginning of construction variables.
624 - Add long command-line support to the "lib" Tool (Microsoft library
629 - Allow $$ in a string to be passed through as $.
631 - Support file names with odd characters in them.
633 - Add support for construction variable substition on scanner
634 directories (in CPPPATH, F77PATH, LIBPATH, etc.).
636 From Charles Crain and Steven Knight:
638 - Add Repository() functionality, including the -Y option.
642 - Fix auto-deduction of target names so that deduced targets end
643 up in the same subdirectory as the source.
645 - Don't remove source files specified on the command line!
647 - Suport the Intel Fortran Compiler (ifl.exe).
649 - Supply an error message if there are no command-line or
650 Default() targets specified.
652 - Fix the ASPPCOM values for the GNU assembler.
653 (Bug reported by Brett Polivka.)
655 - Fix an exception thrown when a Default() directory was specified
656 when using the -U option.
658 - Issue a warning when -c can't remove a target.
660 - Eliminate unnecessary Scanner calls by checking for the
661 existence of a file before scanning it. (This adds a generic
662 hook to check an arbitrary condition before scanning.)
664 - Add explicit messages to tell when we're "Reading SConscript files
665 ...," "done reading SConscript files," "Building targets," and
666 "done building targets." Add a -Q option to supress these.
668 - Add separate $SHOBJPREFIX and $SHOBJSUFFIX construction variables
669 (by default, the same as $OBJPREFIX and $OBJSUFFIX).
671 - Add Make-like error messages when asked to build a source file,
672 and before trying to build a file that doesn't have all its source
673 files (including when an invalid drive letter is used on WIN32).
675 - Add an scons-local-{version} package (in both .tar.gz and .zip
676 flavors) to help people who want to ship SCons as a stand-alone
677 build tool in their software packages.
679 - Prevent SCons from unlinking files in certain situations when
680 the -n option is used.
682 - Change the name of Tool/lib.py to Tool/mslib.py.
684 From Steven Knight and Anthony Roach:
686 - Man page: document the fact that Builder calls return Node objects.
690 - Refactor option processing to use our own version of Greg Ward's
691 Optik module, modified to run under Python 1.5.2.
693 - Add a ParseConfig() command to modify an environment based on
694 parsing output from a *-config command.
698 - Fix interpretation of '#/../foo' on Win32 systems.
702 - Fixed use of command lines with spaces in their arguments,
703 and use of Nodes with spaces in their string representation.
705 - Make access and modification times of files in a BuildDir match
706 the source file, even when hard linking isn't available.
708 - Make -U be case insensitive on Win32 systems.
710 - Issue a warning and continue when finding a corrupt .sconsign file.
712 - Fix using an alias as a dependency of a target so that if one of the
713 alias' dependencies gets rebuilt, the resulting target will, too.
715 - Fix differently ordered targets causing unnecessary rebuilds
716 on case insensitive systems.
718 - Use os.system() to execute external commands whenever the "env"
719 utility is available, which is much faster than fork()/exec(),
720 and fixes the -j option on several platforms.
722 - Fix use of -j with multiple targets.
724 - Add an Options() object for friendlier accomodation of command-
727 - Add support for Microsoft VC++ precompiled header (.pch) files,
728 debugger (.pdb) files, and resource (.rc) files.
730 - Don't compute the $_CPPINCFLAGS, $_F77INCFLAGS, $_LIBFLAGS and
731 $_LIBDIRFLAGS variables each time a command is executed, define
732 them so they're computed only as needed. Add a new _concat
733 function to the Environment that allows people to define their
734 own similar variables.
736 - Fix dependency scans when $LIBS is overridden.
738 - Add EnsurePythonVersion() and EnsureSConsVersion() functions.
740 - Fix the overly-verbose stack trace on ListBuilder build errors.
742 - Add a SetContentSignatureType() function, allowing use of file
743 timestamps instead of MD5 signatures.
745 - Make -U and Default('source') fail gracefully.
747 - Allow the File() and Dir() methods to take a path-name string as
748 the starting directory, in addition to a Dir object.
750 - Allow the command handler to be selected via the SPAWN, SHELL
751 and ESCAPE construction variables.
753 - Allow construction variables to be overridden when a Builder
758 - Dynamically check for the existence of utilities with which to
759 initialize Environments by default.
763 RELEASE 0.08 - Mon, 15 Jul 2002 12:08:51 -0500
767 - Fixed a bug with relative CPPPATH dirs when using BuildDir().
768 (Bug reported by Bob Summerwill.)
770 - Added a warnings framework and a --warn option to enable or
773 - Make the C scanner warn users if files referenced by #include
774 directives cannot be found and --warn=dependency is specified.
776 - The BUILDERS construction variable should now be a dictionary
777 that maps builder names to actions. Existing uses of lists,
778 and the Builder name= keyword argument, generate warnings
779 about use of deprecated features.
781 - Removed the "shared" keyword argument from the Object and
784 - Added separated StaticObject, SharedObject, StaticLibrary and
785 SharedLibrary builders. Made Object and Library synonyms for
786 StaticObject and StaticLibrary, respectively.
788 - Add LIBS and LIBPATH dependencies for shared libraries.
790 - Removed support for the prefix, suffix and src_suffix arguments
791 to Builder() to be callable functions.
793 - Fix handling file names with multiple dots.
795 - Allow a build directory to be outside of the SConstruct tree.
797 - Add a FindFile() function that searches for a file node with a
800 - Add $CPPFLAGS to the shared-object command lines for g++ and gcc.
802 From Charles Crain and Steven Knight:
804 - Add a "tools=" keyword argument to Environment instantiation,
805 and a separate Tools() method, for more flexible specification
806 of tool-specific environment changes.
810 - Add a "platform=" keyword argument to Environment instantiation,
811 and a separate Platform() method, for more flexible specification
812 of platform-specific environment changes.
814 - Updated README instructions and setup.py code to catch an
815 installation failure from not having distutils installed.
817 - Add descriptions to the -H help text for -D, -u and -U so
818 people can tell them apart.
820 - Remove the old feature of automatically splitting strings
821 of file names on white space.
823 - Add a dependency Scanner for native Fortran "include" statements,
824 using a new "F77PATH" construction variable.
826 - Fix C #include scanning to detect file names with characters like
829 - Add more specific version / build output to the -v option.
831 - Add support for the GNU as, Microsoft masm, and nasm assemblers.
833 - Allow the "target" argument to a Builder call to be omitted, in
834 which case the target(s) are deduced from the source file(s) and the
835 Builder's specified suffix.
837 - Add a tar archive builder.
839 - Add preliminary support for the OS/2 Platform, including the icc
844 - Fix --implicit-cache if the scanner returns an empty list.
848 - Add a "multi" keyword argument to Builder creation that specifies
849 it's okay to call the builder multiple times for a target.
851 - Set a "multi" on Aliases so multiple calls will append to an Alias.
853 - Fix emitter functions' use of path names when using BuildDir or
856 - Fix --implicit-cache causing redundant rebuilds when the header
859 - Fix --implicit-cache when a file has no implicit dependencies and
860 its source is generated.
862 - Make the drive letters on Windows always be the same case, so that
863 changes in the case of drive letters don't cause a rebuild.
865 - Fall back to importing the SCons.TimeStamp module if the SCons.MD5
866 module can't be imported.
868 - Fix interrupt handling to guarantee that a single interrupt will
869 halt SCons both when using -j and not.
871 - Fix .sconsign signature storage so that output files of one build
872 can be safely used as input files to another build.
874 - Added a --debug=time option to print SCons execution times.
876 - Print an error message if a file can't be unlinked before being
877 built, rather than just silently terminating the build.
879 - Add a SideEffect() method that can be used to tell the build
880 engine that a given file is created as a side effect of building
881 a target. A file can be specified as a side effect of more than
882 one build comand, in which case the commands will not be executed
885 - Significant performance gains from not using our own version of
886 the inefficient stock os.path.splitext() method, caching source
887 suffix computation, code cleanup in MultiStepBuilder.__call__(),
888 and replicating some logic in scons_subst().
890 - Add --implicit-deps-changed and --implicit-deps-unchanged options.
892 - Add a GetLaunchDir() function.
894 - Add a SetBuildSignatureType() function.
898 - Add an Append() method to Environments, to append values to
899 construction variables.
901 - Change the name of Update() to Replace(). Keep Update() as a
902 deprecated synonym, at least for now.
906 - Use a $PYTHON construction variable, initialized to sys.executable,
907 when using Python to build parts of the SCons packages.
909 - Use sys.prefix, not sys.exec_prefix, to find pdb.py.
913 RELEASE 0.07 - Thu, 2 May 2002 13:37:16 -0500
917 - Changes to build SCons packages on IRIX (and other *NIces).
919 - Don't create a directory Node when a file already exists there,
922 - Add 'dirs' and 'names' keyword arguments to SConscript for
923 easier specification of subsidiary SConscript files.
927 - Internal cleanup of environment passing to function Actions.
929 - Builders can now take arbitrary keyword arguments to create
930 attributes to be passed to: command generator functions,
931 FunctionAction functions, Builder emitter functions (below),
932 and prefix/suffix generator functions (below).
934 - Command generator functions can now return ANYTHING that can be
935 converted into an Action (a function, a string, a CommandGenerator
936 instance, even an ActionBase instance).
938 - Actions now call get_contents() with the actual target and source
939 nodes used for the build.
941 - A new DictCmdGenerator class replaces CompositeBuilder to support
942 more flexible Builder behavior internally.
944 - Builders can now take an emitter= keyword argument. An emitter
945 is a function that takes target, source, and env argument, then
946 return a 2-tuple of (new sources, new targets). The emitter is
947 called when the Builder is __call__'ed, allowing a user to modify
948 source and target lists.
950 - The prefix, suffix and src_suffix Builder arguments now take a
951 callable as well a string. The callable is passed the Environment
952 and any extra Builder keyword arguments and is expected to return
953 the appropriate prefix or suffix.
955 - CommandActions can now be a string, a list of command + argument
956 strings, or a list of commands (strings or lists).
958 - Added shared library support. The Object and Library Builders now
959 take a "shared=1" keyword argument to specify that a shared object
960 or shared library should be built. It is an error to try to build
961 static objects into a shared library or vice versa.
963 - Win32 support for .def files has been added. Added the Win32-specific
964 construction variables $WIN32DEFPREFIX, $WIN32DEFSUFFIX,
965 $WIN32DLLPREFIX and $WIN32IMPLIBPREFIX. When building a .dll,
966 the new construction variable $WIN32_INSERT_DEF, controls whether
967 the appropriately-named .def file is inserted into the target
968 list (if not already present). A .lib file is always added to
969 a Library build if not present in the list of targets.
971 - ListBuilder now passes all targets to the action, not just the first.
973 - Fix so that -c now deletes generated yacc .h files.
975 - Builder actions and emitter functions can now be initialized, through
976 construction variables, to things other than strings.
978 - Make top-relative '#/dir' lookups work like '#dir'.
980 - Fix for relative CPPPATH directories in subsidiary SConscript files
983 - Add a for_signature argument to command generators, so that
984 generators that need to can return distinct values for the
985 command signature and for executing the command.
989 - Create a better scons.bat file from a py2bat.py script on the Python
990 mailing list two years ago (modeled after pl2bat.pl).
994 - Fix so that -c -n does *not* remove the targets!
996 - Man page: Add a hierarchical libraries + Program example.
998 - Support long MSVC linker command lines through a builder action
999 that writes to a temporary file and uses the magic MSVC "link @file"
1000 argument syntax if the line is longer than 2K characters.
1002 - Fix F77 command-line options on Win32 (use /Fo instead of -o).
1004 - Use the same action to build from .c (lower case) and .C (upper
1005 case) files on case-insensitive systems like Win32.
1007 - Support building a PDF file directly from a TeX or LaTeX file
1008 using pdftex or pdflatex.
1010 - Add a -x option to runtest.py to specify the script being tested.
1011 A -X option indicates it's an executable, not a script to feed
1012 to the Python interpreter.
1014 - Add a Split() function (identical to SCons.Util.argmunge()) for use
1015 in the next release, when Builders will no longer automatically split
1016 strings on white space.
1020 - Add the SConscriptChdir() method.
1024 - Fix --debug=tree when used with directory targets.
1026 - Significant internal restructuring of Scanners and Taskmaster.
1028 - Added new --debug=dtree option.
1030 - Fixes for --profile option.
1032 - Performance improvement in construction variable substitution.
1034 - Implemented caching of content signatures, plus added --max-drift
1035 option to control caching.
1037 - Implemented caching of dependency signatures, enabled by new
1038 --implicit-cache option.
1040 - Added abspath construction variable modifier.
1042 - Added $SOURCE variable as a synonym for $SOURCES[0].
1044 - Write out .sconsign files on error or interrupt so intermediate
1045 build results are saved.
1047 - Change the -U option to -D. Make a new -U that builds just the
1048 targets from the local SConscript file.
1050 - Fixed use of sys.path so Python modules can be imported from
1051 the SConscript directory.
1053 - Fix for using Aliases with the -u, -U and -D options.
1055 - Fix so that Nodes can be passed to SConscript files.
1059 - Changes for official Debian packaging.
1063 RELEASE 0.06 - Thu, 28 Mar 2002 01:24:29 -0600
1067 - Fix command generators to expand construction variables.
1069 - Make FunctionAction arguments be Nodes, not strings.
1071 From Stephen Kennedy:
1073 - Performance: Use a dictionary, not a list, for a Node's parents.
1077 - Add .zip files to the packages we build.
1079 - Man page: document LIBS, fix a typo, document ARGUMENTS.
1081 - Added RANLIB and RANLIBFLAGS construction variables. Only use them
1082 in ARCOM if there's a "ranlib" program on the system.
1084 - Add a configurable CFILESUFFIX for the Builder of .l and .y files
1087 - Add a CXXFile Builder that turns .ll and .yy files into .cc files
1088 (configurable via a CXXFILESUFFIX construction variable).
1090 - Use the POSIX-standard lex -t flag, not the GNU-specific -o flag.
1091 (Bug reported by Russell Christensen.)
1093 - Fixed an exception when CPPPATH or LIBPATH is a null string.
1094 (Bug reported by Richard Kiss.)
1096 - Add a --profile=FILE option to make profiling SCons easier.
1098 - Modify the new DVI builder to create .dvi files from LaTeX (.ltx
1101 - Add support for Aliases (phony targets).
1103 - Add a WhereIs() method for searching for path names to executables.
1105 - Add PDF and PostScript document builders.
1107 - Add support for compiling Fortran programs from a variety of
1108 suffixes (a la GNU Make): .f, .F, .for, .FOR, .fpp and .FPP
1110 - Support a CPPFLAGS variable on all default commands that use the
1115 - Add support for the -U option.
1117 - Allow CPPPATH, LIBPATH and LIBS to be specified as white-space
1120 - Add a document builder to create .dvi files from TeX (.tex) files.
1124 - Fix: Construction variables with values of 0 were incorrectly
1127 - Support env['VAR'] to fetch construction variable values.
1129 - Man page: document Precious().
1133 RELEASE 0.05 - Thu, 21 Feb 2002 16:50:03 -0600
1137 - Set PROGSUFFIX to .exe under Cygwin.
1141 - Allow a library to specified as a command-line source file, not just
1142 in the LIBS construction variable.
1144 - Compensate for a bug in os.path.normpath() that returns '' for './'
1147 - More performance optimizations: cache #include lines from files,
1148 eliminate unnecessary calls.
1150 - If a prefix or suffix contains white space, treat the resulting
1151 concatenation as separate arguments.
1153 - Fix irregularities in the way we fetch DevStudio information from
1154 the Windows registry, and in our registry error handling.
1158 - Flush stdout after print so it intermixes correctly with stderr
1161 - Allow Scanners to return a list of strings, and document how to
1162 write your own Scanners.
1164 - Look up implicit (scanned) dependencies relative to the directory
1165 of file being scanned.
1167 - Make writing .sconsign files more robust by first trying to write
1168 to a temp file that gets renamed.
1170 - Create all of the directories for a list of targets before trying
1171 to build any of the targets.
1173 - WIN32 portability fixes in tests.
1175 - Allow the list of variables exported to an SConscript file to be
1178 - Document the overlooked LIBPATH construction variable.
1179 (Bug reported by Eicke Godehardt.)
1181 - Fix so that Ignore() ignores indirect, implicit dependencies
1182 (included files), not just direct dependencies.
1184 - Put the man page in the Debian distribution.
1186 - Run HTML docs through tidy to clean up the HTML (for Konqueror).
1188 - Add preliminary support for Unicode strings.
1190 - Efficiency: don't scan dependencies more than once during the
1193 - Fix the -c option so it doesn't stop removing targets if one doesn't
1195 (Bug reported by Paul Connell.)
1197 - Fix the --debug=pdb option when run on Windows NT.
1198 (Bug reported by Paul Connell.)
1200 - Add support for the -q option.
1204 - Add support for the -u option.
1206 - Add .cc and .hh file suffixes to the C Scanner.
1210 - Make the scons script return an error code on failures.
1212 - Add support for using code to generate a command to build a target.
1216 RELEASE 0.04 - Wed, 30 Jan 2002 11:09:42 -0600
1220 - Significant performance improvements in the Node.FS and
1223 - Fix signatures of binary files on Win32 systems.
1225 - Allow LIBS and LIBPATH to be strings, not just arrays.
1227 - Print a traceback if a Python-function builder throws an exception.
1231 - Fix using a directory as a Default(), and allow Default() to
1232 support white space in file names for strings in arrays.
1234 - Man page updates: corrected some mistakes, documented various
1235 missing Environment methods, alphabetized the construction
1236 variables and other functions, defined begin and end macros for
1237 the example sections, regularized white space separation, fixed
1238 the use of Export() in the Multiple Variants example.
1240 - Function action fixes: None is now a successful return value.
1241 Exceptions are now reported. Document function actions.
1243 - Add 'Action' and 'Scanner' to the global keywords so SConscript
1244 files can use them too.
1246 - Removed the Wrapper class between Nodes and Walkers.
1248 - Add examples using Library, LIBS, and LIBPATH.
1250 - The C Scanner now always returns a sorted list of dependencies
1251 so order changes don't cause unnecessary rebuilds.
1253 - Strip $(-$) bracketed text from command lines. Use this to
1254 surround $_INCDIRS and $_LIBDIRS so we don't rebuild in response
1255 to changes to -I or -L options.
1257 - Add the Ignore() method to ignore dependencies.
1259 - Provide an error message when a nonexistent target is specified
1260 on the command line.
1262 - Remove targets before building them, and add an Environment
1263 Precious() method to override that.
1265 - Eliminate redundant calls to the same builder when the target is a
1266 list of targets: Add a ListBuilder class that wraps Builders to
1267 handle lists atomically. Extend the Task class to support building
1268 and updating multiple targets in a single Task. Simplify the
1269 interface between Task and Taskmaster.
1271 - Add a --debug=pdb option to re-run SCons under the Python debugger.
1273 - Only compute a build signature once for each node.
1275 - Changes to our sys.path[] manipulation to support installation into
1276 an arbitrary --prefix value.
1280 - Add var=value command-line arguments.
1284 RELEASE 0.03 - Fri, 11 Jan 2002 01:09:30 -0600
1288 - Performance improvements in the Node.FS and Sig.Calculator classes.
1290 - Add the InstallAs() method.
1292 - Execute commands through an external interpreter (sh, cmd.exe, or
1293 command.com) to handle redirection metacharacters.
1295 - Allow the user to supply a command handler.
1299 - Search both /usr/lib and /usr/local/lib for scons directories by
1300 adding them both to sys.path, with whichever is in sys.prefix first.
1302 - Fix interpreting strings of multiple white-space separated file names
1303 as separate file names, allowing prefixes and suffixes to be appended
1304 to each individually.
1306 - Refactor to move CompositeBuilder initialization logic from the
1307 factory wrapper to the __init__() method, and allow a Builder to
1308 have both an action and a src_builder (or array of them).
1310 - Refactor BuilderBase.__call__() to separate Node creation/lookup
1311 from initialization of the Node's builder information.
1313 - Add a CFile Builder object that supports turning lex (.l) and
1314 yacc (.y) files into .c files.
1316 - Document: variable interpretation attributes; how to propogate
1317 the user's environment variables to executed commands; how to
1318 build variants in multiple BuildDirs.
1320 - Collect String, Dict, and List type-checking in common utility
1321 routines so we can accept User{String,Dict,List}s all over.
1323 - Put the Action factory and classes into their own module.
1325 - Use one CPlusPlusAction in the Object Builder's action dictionary,
1326 instead of letting it create multiple identical instances.
1328 - Document the Install() and InstallAs() methods.
1332 - Require that a Builder be given a name argument, supplying a
1333 useful error message when it isn't.
1337 - Add a "duplicate" keyword argument to BuildDir() that can be set
1338 to prevent linking/copying source files into build directories.
1340 - Add a "--debug=tree" option to print an ASCII dependency tree.
1342 - Fetch the location of the Microsoft Visual C++ compiler(s) from
1343 the Registry, instead of hard-coding the location.
1345 - Made Scanner objects take Nodes, not path names.
1347 - Have the C Scanner cache the #include file names instead of
1348 (re-)scanning the file each time it's called.
1350 - Created a separate class for parent "nodes" of file system roots,
1351 eliminating the need for separate is-parent-null checks everywhere.
1353 - Removed defined __hash__() and __cmp() methods from FS.Entry, in
1354 favor of Python's more efficient built-in identity comparisons.
1358 RELEASE 0.02 - Sun, 23 Dec 2001 19:05:09 -0600
1362 - Added the Install(), BuildDir(), and Export() methods.
1364 - Fix the -C option by delaying setting the top of the FS tree.
1366 - Avoid putting the directory path on the libraries in the LIBS
1367 construction variable.
1369 - Added a GetBuildPath() method to return the full path to the
1370 Node for a specified string.
1372 - Fixed variable substitution in CPPPATH and LIBPATH.
1376 - Fixed the version comment in the scons.bat (the UNIX geek used
1379 - Fix to setup.py so it doesn't require a sys.argv[1] argument.
1381 - Provide make-like warning message for "command not found" and
1384 - Added an EXAMPLES section to the man page.
1386 - Make Default() targets properly relative to their SConscript
1387 file's subdirectory.
1391 - Documented CXXFLAGS, CXXCOM, and CPPPATH.
1393 - Fixed SCONS_LIB_DIR to work as documented.
1395 - Made Default() accept Nodes as arguments.
1397 - Changed Export() to make it easier to use.
1399 - Added the Import() and Return() methods.
1403 RELEASE 0.01 - Thu Dec 13 19:25:23 CST 2001
1405 A brief overview of important functionality available in release 0.01:
1407 - C and C++ compilation on POSIX and Windows NT.
1409 - Automatic scanning of C/C++ source files for #include dependencies.
1411 - Support for building libraries; setting construction variables
1412 allows creation of shared libraries.
1414 - Library and C preprocessor search paths.
1416 - File changes detected using MD5 signatures.
1418 - User-definable Builder objects for building files.
1420 - User-definable Scanner objects for scanning for dependencies.
1422 - Parallel build (-j) support.
1424 - Dependency cycles detected.
1426 - Linux packages available in RPM and Debian format.
1428 - Windows installer available.