2 # __FILE__ __REVISION__ __DATE__ __DEVELOPER__
5 SCons - a software construction tool
15 - Add a must_exist flag to Delete() to let the user control whether
16 it's an error if the specified entry doesn't exist. The default
17 behavior is now to silently do nothing if it doesn't exist.
19 - Package up the new Platform/darwin.py, mistakenly left out of 0.96.
21 - Make the scons.bat REM statements into @REM so they aren't printed.
25 - Fix scanning of pre-compiled header (.pch) files for #includes,
30 RELEASE 0.96 - Wed, 18 Aug 2004 13:36:40 +0000
34 - Make the CacheDir() directory if it doesn't already exist.
36 - Allow construction variable substitutions in $LIBS specifications.
38 - Allow the emitter argument to a Builder() to be or expand to a list
39 of emitter functions, which will be called in sequence.
41 - Suppress null values in construction variables like $LIBS that use
42 the internal _concat() function.
44 - Remove .dll files from the construction variables searched for
45 libraries that can be fed to Win32 compilers.
47 From Chad Austin and Christoph Wiedemann:
49 - Add support for a $RPATH variable to supply a list of directories
50 to search for shared libraries when linking a program. Used by
51 the GNU and IRIX linkers (gnulink and sgilink).
55 - Restore the ability to do construction variable substitutions in all
56 kinds of *PATH variables, even when the substitution returns a Node
61 - Allow the Java() Builder to take more than one source directory.
63 From Ralf W. Grosse-Kunstleve:
65 - Have SConsignFile() use, by default, a custom "dblite.py" that we can
66 control and guarantee to work on all Python versions (or nearly so).
70 - Add support for the newer "ifort" versions of the Intel Fortran
75 - Make the new *FLAGS variable type work with copied Environments.
79 - Initialize the name of a Scanner.Classic scanner correctly.
83 - Add support for the .dylib shared library suffix and the -dynamiclib
84 linker option on Mac OS X.
88 - Add an Execute() method for executing actions directly.
90 - Support passing environment override keyword arguments to Command().
92 - Fix use of $MSVS_IGNORE_IDE_PATHS, which was broken when we added
93 support for $MSVS_USE_MFC_DIRS last release.
95 - Make env.Append() and env.Prepend() act like the underlying Python
96 behavior when the variable being appended to is a UserList object.
98 - Fix a regression that prevented the Command() global function in
99 0.95 from working with command-line strings as actions.
101 - Fix checking out a file from a source code management system when
102 the env.SourceCode() method was called with an individual file name
103 or node, not a directory name or node.
105 - Enhance the Task.make_ready() method to create a list of the
106 out-of-date Nodes for the task for use by the wrapping interface.
108 - Allow Scanners to pull the list of suffixes from the construction
109 environment when the "skeys" keyword argument is a string containing
110 a construction variable to be expanded.
112 - Support new $CPPSUFFIXES, $DSUFFIXES $FORTRANSUFFIXES, and
113 $IDLSUFFIXES. construction variables that contain the default list
114 of suffixes to be scanned by a given type of scanner, allowing these
115 suffix lists to be easily added to or overridden.
117 - Speed up Node creation when calling a Builder by comparing whether two
118 Environments are the same object, not if their underlying dictionaries
121 - Add a --debug=explain option that reports the reason(s) why SCons
122 thinks it must rebuild something.
124 - Add support for functions that return platform-independent Actions
125 to Chmod(), Copy(), Delete(), Mkdir(), Move() and Touch() files
126 and/or directories. Like any other Actions, the returned Action
127 object may be executed directly using the Execute() global function
128 or env.Execute() environment method, or may be used as a Builder
129 action or in an env.Command() action list.
131 - Add support for the strfunction argument to all types of Actions:
132 CommandAction, ListAction, and CommandGeneratorAction.
134 - Speed up turning file system Nodes into strings by caching the
135 values after we're finished reading the SConscript files.
137 - Have ParseConfig() recognize and supporting adding the -Wa, -Wl,
138 and -Wp, flags to ASFLAGS, LINKFLAGS and CPPFLAGS, respectively.
140 - Change the .sconsign format and the checks for whether a Node is
141 up-to-date to make dependency checks more efficient and correct.
143 - Add wrapper Actions to SCons.Defaults for $ASCOM, $ASPPCOM, $LINKCOM,
144 $SHLINKCOM, $ARCOM, $LEXCOM and $YACCCOM. This makes it possible
145 to replace the default print behavior with a custom strfunction()
148 - When a Node has been built, don't walk the whole tree back to delete
149 the parents's implicit dependencies, let returning up the normal
150 Taskmaster descent take care of it for us.
152 - Add documented support for separate target_scanner and source_scanner
153 arguments to Builder creation, which allows different scanners to
154 be applied to source files
156 - Don't re-install or (re-generate) .h files when a subsidiary #included
157 .h file changes. This eliminates incorrect circular dependencies
158 with .h files generated from other source files.
160 - Slim down the internal Sig.Calculator class by eliminating methods
161 whose functionality is now covered by Node methods.
163 - Document use of the target_factory and source_factory keyword
164 arguments when creating Builder objects. Enhance Dir Nodes so that
165 they can be created with user-specified Builder objects.
167 - Don't blow up with stack trace when the external $PATH environment
170 - Make Builder calls return lists all the time, even if there's only
171 one target. This keeps things consistent and easier to program to
174 - Add a Flatten() function to make it easier to deal with the Builders
175 all returning lists of targets, not individual targets.
177 - Performance optimizations in Node.FS.__doLookup().
179 - Man page fixes: formatting typos, misspellings, bad example.
181 - User's Guide fixes: Fix the signatures of the various example
182 *Options() calls. Triple-quote properly a multi-line Split example.
184 - User's Guide additions: Chapter describing File and Directory
185 Nodes. Section describing declarative nature of SCons functions in
186 SConscript files. Better organization and clarification of points
187 raised by Robert P. J. Day. Chapter describing SConf (Autoconf-like)
188 functionality. Chapter describing how to install Python and
189 SCons. Chapter describing Java builds.
193 - Add a .win32 attribute to force file names to expand with
194 Windows backslash path separators.
196 - Fix escaping file names on command lines when the expansion is
197 concatenated with another string.
199 - Add support for Fortran 90 and Fortran 95. This adds $FORTRAN*
200 variables that specify a default compiler, command-line, flags,
201 etc. for all Fortran versions, plus separate $F90* and $F95*
202 variables for when different compilers/flags/etc. must be specified
203 for different Fortran versions.
205 - Have individual tools that create libraries override the default
206 $LIBPREFIX and $LIBSUFFIX values set by the platform. This makes
207 it easier to use Microsoft Visual Studio tools on a CygWin platform.
209 From Gary Oberbrunner:
211 - Add a --debug=presub option to print actions prior to substitution.
213 - Add a warning upon use of the override keywords "targets" and
214 "sources" when calling Builders. These are usually mistakes which
215 are otherwise silently (and confusingly) turned into construction
218 - Try to find the ICL license file path name in the external environment
219 and the registry before resorting to the hard-coded path name.
221 - Add support for fetching command-line keyword=value arguments in
222 order from an ARGLIST list.
224 - Avoid stack traces when trying to read dangling symlinks.
226 - Treat file "extensions" that only contain digits as part of the
227 file basename. This supports version numbers as part of shared
228 library names, for example.
230 - Avoid problems when there are null entries (None or '') in tool
233 - Add an example and explanation of how to use "tools = ['default', ..."
234 when creating a construction environment.
236 - Add a section describing File and Directory Nodes and some of their
237 attributes and methods.
239 - Have ParseConfig() add a returned -pthread flag to both $CCFLAGS
242 - Fix some test portability issues on Mac OS X (darwin).
246 - Fix a bug introduced in building shared libraries under MinGW.
250 - Handling SCons exceptions according to Pythonic standards.
252 - Fix test/chained-build.py on systems that execute within one second.
254 - Fix tests on systems where 'ar' warns about archive creation.
258 - Fix use of the --implicit-cache option with timestamp signatures.
260 - If Visual Studio is installed, assume the C/C++ compiler, the linker
261 and the MIDL compiler that comes with it are available, too.
263 - Better error messages when evaluating a construction variable
264 expansion yields a Python syntax error.
266 - Change the generation of PDB files when using Visual Studio from
267 compile time to link time.
271 - Allow SConf.CheckLib() to search a list of libraries, like the
272 Autoconf AC_SEARCH_LIBS macro.
274 - Allow the env.WhereIs() method to take a "reject" argument to
275 let it weed out specific path names.
277 From Christoph Wiedemann:
279 - Add new Moc() and Uic() Builders for more explicit control over
280 Qt builds, plus new construction variables to control them:
281 $QT_AUTOSCAN, $QT_DEBUG, $QT_MOCCXXPREFIX, $QT_MOCCXXSUFFIX,
282 $QT_MOCHPREFIX, $QT_MOCHSUFFIX, $QT_UICDECLPREFIX, $QT_UICDECLSUFFIX,
283 $QT_UICIMPLPREFIX, $QT_UICIMPLSUFFIX and $QT_UISUFFIX.
285 - Add a new single_source keyword argument for Builders that enforces
286 a single source file on calls to the Builder.
290 RELEASE 0.95 - Mon, 08 Mar 2004 06:43:20 -0600
294 - Replace print statements with calls to sys.stdout.write() so output
295 lines stay together when -j is used.
297 - Add portability fixes for a number of tests.
299 - Accomodate the fact that Cygwin's os.path.normcase() lies about
300 the underlying system being case-sensitive.
302 - Fix an incorrect _concat() call in the $RCINCFLAGS definition for
305 - Fix a problem with the msvc tool with Python versions prior to 2.3.
307 - Add support for a "toolpath" Tool() and Environment keyword that
308 allows Tool modules to be found in specified local directories.
310 - Work around Cygwin Python's silly fiction that it's using a
311 case-sensitive file system.
313 - More robust handling of data in VCComponents.dat.
315 - If the "env" command is available, spawn commands with the more
316 general "env -" instead of "env -i".
320 - Fix a typo in a msvc.py's registry lookup: "VCComponents.dat", not
325 - Fix the ability to save/restore a PackageOption to a file.
327 From Steve Christensen:
329 - Update the MSVS .NET and MSVC 6.0/7.0 path detection.
333 - Make the Fortran scanner case-insensitive for the INCLUDE string.
337 - If no version of MSVC is detected but the tool is specified,
338 use the MSVC 6.0 paths by default.
340 - Ignore any "6.1" version of MSVC found in the registry; this is a
341 phony version number (created by later service packs?) and would
342 throw off the logic if the user had any non-default paths configure.
344 - Correctly detect if the user has independently configured the MSVC
345 "include," "lib" or "path" in the registry and use the appropriate
346 values. Previously, SCons would only use the values if all three
347 were set in the registry.
349 - Make sure side-effect nodes are prepare()d before building their
350 corresponding target.
352 - Preserve the ability to call BuildDir() multiple times with the
353 same target and source directory arguments.
357 - Add support for the Digital Mars "D" programming language.
359 From Scott Lystig Fritchie:
361 - Fix the ability to use a custom _concat() function in the
362 construction environment when calling _stripixes().
364 - Make the message about ignoring a missing SConscript file into a
365 suppressable Warning, not a hard-coded sys.stderr.write().
367 - If a builder can be called multiple times for a target (because
368 the sources and overrides are identical, or it's a builder with the
369 "multi" flag set), allow the builder to be called through multiple
370 environments so long as the builders have the same signature for
371 the environments in questions (that is, they're the same action).
375 - When multiple targets are built by a single action, retrieve all
376 of them from cache, not just the first target, and exec the build
377 command if any of the targets isn't present in the cache.
381 - Fix command-line ARGUMENTS with multiple = in them.
385 - Fix EnsureSConsVersion() so it checks against the SCons version,
386 not the Python version, on Pythons with sys.version_info.
388 - Don't swallow the AttributeError when someone uses an expansion like
389 $TARGET.bak, so we can supply a more informative error message.
391 - Fix an odd double-quote escape sequence in the man page.
393 - Fix looking up a naked drive letter as a directory (Dir('C:')).
395 - Support using File nodes in the LIBS construction variable.
397 - Allow the LIBS construction variable to be a single string or File
398 node, not a list, when only one library is needed.
400 - Fix typos in the man page: JAVACHDIR => JARCHDIR; add "for_signature"
401 to the __call__() example in the "Variable Substitution" section.
403 - Correct error message spellings of "non-existant" to "non-existent."
405 - When scanning for libraries to link with, don't append $LIBPREFIXES
406 or $LIBSUFFIXES values to the $LIBS values if they're already present.
408 - Add a ZIPCOMPRESSION construction variable to control whether the
409 internal Python action for the Zip Builder compresses the file or
410 not. The default value is zipfile.ZIP_DEFLATED, which generates
413 - Refactor construction variable expansion to support recursive
414 expansion of variables (e.g. CCFLAGS = "$CCFLAGS -g") without going
415 into an infinite loop. Support this in all construction variable
416 overrides, as well as when copying Environments.
418 - Fix calling Configure() from more than one subsidiary SConscript file.
420 - Fix the env.Action() method so it returns the correct type of
421 Action for its argument(s).
423 - Fix specifying .class files as input to JavaH with the .class suffix
424 when they weren't generated using the Java Builder.
426 - Make the check for whether all of the objects going into a
427 SharedLibrary() are shared work even if the object was built in a
430 - Supply meaningful error messages, not stack traces, if we try to add
431 a non-Node as a source, dependency, or ignored dependency of a Node.
433 - Generate MSVS Project files that re-invoke SCons properly regardless
434 of whether the file was built via scons.bat or scons.py.
435 (Thanks to Niall Douglas for contributing code and testing.)
437 - Fix TestCmd.py, runtest.py and specific tests to accomodate being
438 run from directories whose paths include white space.
440 - Provide a more useful error message if a construction variable
441 expansion contains a syntax error during evaluation.
443 - Fix transparent checkout of implicit dependency files from SCCS
446 - Added new --debug=count, --debug=memory and --debug=objects options.
447 --debug=count and --debug=objects only print anything when run
448 under Python 2.1 or later.
450 - Deprecate the "overrides" keyword argument to Builder() creation
451 in favor of using keyword argument values directly (like we do
452 for builder execution and the like).
454 - Always use the Builder overrides in substitutions, not just if
455 there isn't a target-specific environment.
457 - Add new "rsrcpath" and "rsrcdir" and attributes to $TARGET/$SOURCE,
458 so Builder command lines can find things in Repository source
459 directories when using BuildDir.
461 - Fix the M4 Builder so that it chdirs to the Repository directory
462 when the input file is in the source directory of a BuildDir.
464 - Save memory at build time by allowing Nodes to delete their build
465 environments after they've been built.
467 - Add AppendUnique() and PrependUnique() Environment methods, which
468 add values to construction variables like Append() and Prepend()
469 do, but suppress any duplicate elements in the list.
471 - Allow the 'qt' tool to still be used successfully from a copied
472 Environment. The include and library directories previously ended up
473 having the same string re-appended to the end, yielding an incorrect
476 - Supply a more descriptive error message when the source for a target
479 - Initialize all *FLAGS variables with objects do the right thing with
480 appending flags as strings or lists.
482 - Make things like ${TARGET.dir} work in *PATH construction variables.
484 - Allow a $MSVS_USE_MFC_DIRS construction variable to control whether
485 ATL and MFC directories are included in the default INCLUDE and
488 - Document the dbm_module argument to the SConsignFile() function.
492 - Add support for the bcc32, ilink32 and tlib Borland tools.
496 - Supply an error message if the user tries to configure a BuildDir
497 for a directory that already has one.
499 - Remove documentation of the still-unimplemented -e option.
501 - Add -H help text listing the legal --debug values.
503 - Don't choke if a construction variable is a non-string value.
505 - Build Type Libraries in the target directory, not the source
508 - Add an appendix to the User's Guide showing how to accomplish
509 various common tasks in Python.
513 - Add support for Microsoft Visual Studio 2003 (version 7.1).
515 - Evaluate $MSVSPROJECTSUFFIX and $MSVSSOLUTIONSUFFIX when the Builder
516 is invoked, not when the tool is initialized.
518 From Christoph Wiedemann:
520 - When compiling Qt, make sure the moc_*.cc files are compiled using
521 the flags from the environment used to specify the target, not
522 the environment that first has the Qt Builders attached.
526 RELEASE 0.94 - Fri, 07 Nov 2003 05:29:48 -0600
530 - Add several new types of canned functions to help create options:
531 BoolOption(), EnumOption(), ListOption(), PackageOption(),
536 - Fix use of CPPDEFINES with C++ source files.
538 - Fix env.Append() when the operand is an object with a __cmp__()
539 method (like a Scanner instance).
541 - Fix subclassing the Environment and Scanner classes.
543 - Add BUILD_TARGETS, COMMAND_LINE_TARGETS and DEFAULT_TARGETS variables.
547 - SGI fixes: Fix C++ compilation, add a separate Tool/sgic++.py module.
549 From Gary Oberbrunner:
551 - Fix how the man page un-indents after examples in some browsers.
555 - Fix the C and C++ tool specifications for AIX.
559 RELEASE 0.93 - Thu, 23 Oct 2003 07:26:55 -0500
563 - On POSIX, execute commands with the more modern os.spawnvpe()
564 function, if it's available.
566 - Scan .S, .spp and .SPP files for C preprocessor dependencies.
568 - Refactor the Job.Parallel() class to use a thread pool without a
569 condition variable. This improves parallel build performance and
570 handles keyboard interrupts properly when -j is used.
574 - Add support for a JARCHDIR variable to control changing to a
575 directory using the jar -C option.
577 - Add support for detecting Java manifest files when using jar,
578 and specifying them using the jar m flag.
580 - Fix some Python 2.2 specific things in various tool modules.
582 - Support directories as build sources, so that a rebuild of a target
583 can be triggered if anything underneath the directory changes.
585 - Have the scons.bat and scons.py files look for the SCons modules
586 in site-packages as well.
588 From Christian Engel:
590 - Support more flexible inclusion of separate C and C++ compilers.
592 - Use package management tools on AIX and Solaris to find where
593 the comilers are installed, and what version they are.
595 - Add support for CCVERSION and CXXVERSION variables for a number
596 of C and C++ compilers.
600 - Add test cases for the new capabilities to run bibtex and to rerun
603 From Ralf W. Grosse-Kunstleve:
605 - Accomodate anydbm modules that don't have a sync() method.
607 - Allow SConsignFile() to take an argument specifying the DBM
610 From Stephen Kennedy:
612 - Add support for a configurable global .sconsign.dbm file which
613 can be used to avoid cluttering each directory with an individual
618 - Fix (re-)scanning of dependencies in generated or installed
623 - The -Q option suppressed too many messages; fix it so that it only
624 suppresses the Reading/Building messages.
626 - Support #include when there's no space before the opening quote
629 - Accomodate alphanumeric version strings in EnsurePythonVersion().
631 - Support arbitrary expansion of construction variables within
632 file and directory arguments to Builder calls and Environment methods.
634 - Add Environment-method versions of the following global functions:
635 Action(), AddPostAction(), AddPreAction(), Alias(), Builder(),
636 BuildDir(), CacheDir(), Clean(), Configure(), Default(),
637 EnsurePythonVersion(), EnsureSConsVersion(), Environment(),
638 Exit(), Export(), FindFile(), GetBuildPath(), GetOption(), Help(),
639 Import(), Literal(), Local(), Platform(), Repository(), Scanner(),
640 SConscriptChdir(), SConsignFile(), SetOption(), SourceSignatures(),
641 Split(), TargetSignatures(), Tool(), Value().
643 - Add the following global functions that correspond to the same-named
644 Environment methods: AlwaysBuild(), Command(), Depends(), Ignore(),
645 Install(), InstallAs(), Precious(), SideEffect() and SourceCode().
647 - Add the following global functions that correspond to the default
648 Builder methods supported by SCons: CFile(), CXXFile(), DVI(), Jar(),
649 Java(), JavaH(), Library(), M4(), MSVSProject(), Object(), PCH(),
650 PDF(), PostScript(), Program(), RES(), RMIC(), SharedLibrary(),
651 SharedObject(), StaticLibrary(), StaticObject(), Tar(), TypeLibrary()
654 - Rearrange the man page to show construction environment methods and
655 global functions in the same list, and to explain the difference.
657 - Alphabetize the explanations of the builder methods in the man page.
659 - Rename the Environment.Environment class to Enviroment.Base.
660 Allow the wrapping interface to extend an Environment by using its own
661 subclass of Environment.Base and setting a new Environment.Environment
662 variable as the calling entry point.
664 - Deprecate the ParseConfig() global function in favor of a same-named
665 construction environment method.
667 - Allow the Environment.WhereIs() method to take explicit path and
668 pathext arguments (like the underlying SCons.Util.WhereIs() function).
670 - Remove the long-obsolete {Get,Set}CommandHandler() functions.
672 - Enhance env.Append() to suppress null values when appropriate.
674 - Fix ParseConfig() so it works regardless of initial construction
677 Extend CheckHeader(), CheckCHeader(), CheckCXXHeader() and
678 CheckLibWithHeader() to accept a list of header files that will be
679 #included in the test. The last one in the list is assumed to be
680 the one being checked for. (Prototype code contributed by Gerard
681 Patel and Niall Douglas).
683 - Supply a warning when -j is used and threading isn't built in to
684 the current version of Python.
686 - First release of the User's Guide (finally, and despite a lot
687 of things still missing from it...).
691 - Generalize the action for .tex files so that it will decide whether
692 a file is TeX or LaTeX, check the .aux output to decide if it should
693 run bibtex, and check the .log output to re-run LaTeX if needed.
697 - Split the non-SCons-specific functionality from SConf.py to a new,
698 re-usable Conftest.py module.
700 From Gary Oberbrunner:
702 - Allow a directory to be the target or source or dependency of a
703 Depends(), Ignore(), Precious() or SideEffect() call.
707 - Use the %{_mandir} macro when building our RPM package.
711 - Have the closing message say "...terminated because of errors" if
716 - On Win32 systems, only use "rm" to delete files if Cygwin is being
717 used. ("rm" doesn't understand Win32-format path names.)
719 From Christoph Wiedemann:
721 - Fix test/SWIG.py to find the Python include directory in all cases.
723 - Fix a bug in detection of Qt installed on the local system.
725 - Support returning Python 2.3 BooleanType values from Configure checks.
727 - Provide an error message if someone mistakenly tries to call a
728 Configure check from within a Builder function.
730 - Support calling a Builder when a Configure context is still open.
732 - Handle interrupts better by eliminating all try:-except: blocks
733 which caught any and all exceptions, including KeyboardInterrupt.
735 - Add a --duplicate= option to control how files are duplicated.
739 RELEASE 0.92 - Wed, 20 Aug 2003 03:45:28 -0500
741 From Charles Crain and Gary Oberbrunner:
743 - Fix Tool import problems with the Intel and PharLap linkers.
747 - Refactor the DictCmdGenerator class to be a Selector subclass.
749 - Allow the DefaultEnvironment() function to take arguments and pass
750 them to instantiation of the default construction environment.
752 - Update the Debian package so it uses Python 2.2 and more closely
753 resembles the currently official Debian packaging info.
757 - When the yacc -d flag is used, take the .h file base name from the
758 target .c file, not the source (matching what yacc does).
762 RELEASE 0.91 - Thu, 14 Aug 2003 13:00:44 -0500
766 - Support specifying a list of tools when calling Environment.Copy().
768 - Give a Value Nodes a timestamp of the system time when they're
769 created, so they'll work when using timestamp-based signatures.
771 - Add a DefaultEnvironment() function that only creates a default
772 environment on-demand (for fetching source files, e.g.).
774 - Portability fix for test/M4.py.
778 - Tighten up the scons -H help output.
780 - When the input yacc file ends in .yy and the -d flag is specified,
781 recognize that a .hpp file (not a .h file) will be created.
783 - Make builder prefixes work correctly when deducing a target
784 from a source file name in another directory.
786 - Documentation fixes: typo in the man page; explain up-front about
787 not propagating the external environment.
789 - Use "cvs co -d" instead of "cvs co -p >" when checking out something
790 from CVS with a specified module name. This avoids zero-length
791 files when there is a checkout error.
793 - Add an "sconsign" script to print the contents of .sconsign files.
795 - Speed up maintaining the various lists of Node children by using
796 dictionaries to avoid "x in list" searches.
798 - Cache the computed list of Node children minus those being Ignored
799 so it's only calculated once.
801 - Fix use of the --cache-show option when building a Program()
802 (or using any other arbitrary action) by making sure all Action
803 instances have strfunction() methods.
805 - Allow the source of Command() to be a directory.
807 - Better error handling of things like raw TypeErrors in SConscripts.
809 - When installing using "setup.py install --prefix=", suppress the
810 distutils warning message about adding the (incorrect) library
811 directory to your search path.
813 - Correct the spelling of the "validater" option to "validator."
814 Add a DeprecatedWarning when the old spelling is used.
816 - Allow a Builder's emitter to be a dictionary that maps source file
817 suffixes to emitter functions, using the suffix of the first file
818 in the source list to pick the right one.
820 - Refactor the creation of the Program, *Object and *Library Builders
821 so that they're moved out of SCons.Defaults and created on demand.
823 - Don't split SConscript file names on white space.
825 - Document the SConscript function's "dirs" and "name" keywords.
827 - Remove the internal (and superfluous) SCons.Util.argmunge() function.
829 - Add /TP to the default CXXFLAGS for msvc, so it can compile all
830 of the suffixes we use as C++ files.
832 - Allow the "prefix" and "suffix" attributes of a Builder to be
833 callable objects that return generated strings, or dictionaries
834 that map a source file suffix to the right prefix/suffix.
836 - Support a MAXLINELINELENGTH construction variable on Win32 systems
837 to control when a temporary file is used for long command lines.
839 - Make how we build .rpm packages not depend on the installation
840 locations from the distutils being used.
842 - When deducing a target Node, create it directly from the first
843 source Node, not by trying to create the right string to pass to
846 - Add support for SWIG.
850 - Test portability fixes for FreeBSD.
852 From Gary Oberbrunner:
854 - Report the target being built in error messages when building
855 multiple sources from different extensions, or when the target file
856 extension can't be deduced, or when we don't have an action for a
859 - Provide helpful error messages when the arguments to env.Install()
862 - Fix the value returned by the Node.prevsiginfo() method to conform
863 to a previous change when checking whether a node is current.
865 - Supply a stack trace if the Taskmaster catches an exception.
867 - When using a temporary file for a long link line on Win32 systems,
868 (also) print the command line that is being executed through the
871 - Initialize the LIB environment variable when using the Intel
874 - Documentation fixes: better explain the AlwaysBuild() function.
878 - When the -debug=pdb option is specified, use pdb.Pdb().runcall() to
879 call pdb directly, don't call Python recursively.
883 - Add support for a platform-independent CPPDEFINES variable.
885 From Christoph Wiedemann:
887 - Have the g++ Tool actually use g++ in preference to c++.
889 - Have the gcc Tool actually use gcc in preference to cc.
891 - Add a gnutools.py test of the GNU tool chain.
893 - Be smarter about linking: use $CC by default and $CXX only if we're
894 linking with any C++ objects.
896 - Avoid SCons hanging when a piped command has a lot of output to read.
898 - Add QT support for preprocessing .ui files into .c files.
902 RELEASE 0.90 - Wed, 25 Jun 2003 14:24:52 -0500
906 - Fix the _concat() documentation, and add a test for it.
908 - Portability fixes for non-GNU versions of lex and yacc.
912 - Fix handling of library prefixes when the subdirectory matches
915 From Timothee Bessett:
921 - Use '.lnk' as the suffix on the temporary file for linking long
922 command lines (necessary for the Phar Lap linkloc linker).
924 - Save non-string Options values as their actual type.
926 - Save Options string values that contain a single quote correctly.
928 - Save any Options values that are changed from the default
929 Environment values, not just ones changed on the command line or in
932 - Make closing the Options file descriptor exception-safe.
936 - SCons now enforces (with an error) that construction variables
937 must have the same form as valid Python identifiers.
939 - Fix man page bugs: remove duplicate AddPostAction() description;
940 document no_import_lib; mention that CPPFLAGS does not contain
941 $_CPPINCFLAGS; mention that F77FLAGS does not contain $_F77INCFLAGS;
942 mention that LINKFLAGS and SHLINKFLAGS contains neither $_LIBFLAGS
945 - Eliminate a dependency on the distutils.fancy_getopt module by
946 copying and pasting its wrap_text() function directly.
948 - Make the Script.Options() subclass match the underlying base class
951 - When reporting a target is up to date, quote the target like make
952 (backquote-quote) instead of with double quotes.
954 - Fix handling of ../* targets when using -U, -D or -u.
958 - Don't update the .sconsign files when run with -n.
960 From Gary Oberbrunner:
962 - Add support for the Intel C Compiler (icl.exe).
970 - Fix use of SConf in paths with white space in them.
972 - Add CheckFunc and CheckType functionality to SConf.
974 - Fix use of SConf with Builders that return a list of nodes.
976 From David Snopek and Christoph Wiedemann
978 - Fix use of the SConf subsystem with SConscriptChdir().
982 - Check for the existence of MS Visual Studio on disk before using it,
983 to avoid getting fooled by leftover junk in the registry.
985 - Add support for MSVC++ .NET.
987 - Add support for MS Visual Studio project files (DSP, DSW,
988 SLN and VCPROJ files).
990 From Christoph Wiedemann
992 - SConf now works correctly when the -n and -q options are used.
996 RELEASE 0.14 - Wed, 21 May 2003 05:16:32 -0500
1000 - Use .dll (not .so) for shared libraries on Cygwin; use -fPIC
1001 when compiling them.
1003 - Use 'rm' to remove files under Cygwin.
1005 - Add a PLATFORM variable to construction environments.
1007 - Remove the "platform" argument from tool specifications.
1009 - Propogate PYTHONPATH when running the regression tests so distutils
1010 can be found in non-standard locations.
1012 - Using MSVC long command-line linking when running Cygwin.
1014 - Portability fixes for a lot of tests.
1016 - Add a Value Node class for dependencies on in-core Python values.
1018 From Allen Bierbaum:
1020 - Pass an Environment to the Options validator method, and
1021 add an Options.Save() method.
1023 From Steve Christensen:
1025 - Add an optional sort function argument to the GenerateHelpText()
1028 - Evaluate the "varlist" variables when computing the signature of a
1033 - Parse the source .java files for class names (including inner class
1034 names) to figure out the target .class files that will be created.
1036 - Make Java support work with Repositories and SConscriptChdir(0).
1038 - Pass Nodes, not strings, to Builder emitter functions.
1040 - Refactor command-line interpolation and signature calculation
1041 so we can use real Node attributes.
1045 - Add Java support (javac, javah, jar and rmic).
1047 - Propagate the external SYSTEMROOT environment variable into ENV on
1048 Win32 systems, so external commands that use sockets will work.
1050 - Add a .posix attribute to PathList expansions.
1052 - Check out CVS source files using POSIX path names (forward slashes
1053 as separators) even on Win32.
1055 - Add Node.clear() and Node.FS.Entry.clear() methods to wipe out a
1056 Node's state, allowing it to be re-evaluated by continuous
1057 integration build interfaces.
1059 - Change the name of the Set{Build,Content}SignatureType() functions
1060 to {Target,Source}Signatures(). Deprecate the old names but support
1061 them for backwards compatibility.
1063 - Add internal SCons.Node.FS.{Dir,File}.Entry() methods.
1065 - Interpolate the null string if an out-of-range subscript is used
1066 for a construction variable.
1068 - Fix the internal Link function so that it properly links or copies
1069 files in subsidiary BuildDir directories.
1071 - Refactor the internal representation of a single execution instance
1072 of an action to eliminate redundant signature calculations.
1074 - Eliminate redundant signature calculations for Nodes.
1076 - Optimize out calling hasattr() before accessing attributes.
1078 - Say "Cleaning targets" (not "Building...") when the -c option is
1083 - Quote the "Entering directory" message like Make.
1085 From Stefan Reichor:
1087 - Add support for using Ghostscript to convert Postscript to PDF files.
1091 - Add a standalone "Alias" function (separate from an Environment).
1093 - Make Export() work for local variables.
1095 - Support passing a dictionary to Export().
1097 - Support Import('*') to import everything that's been Export()ed.
1099 - Fix an undefined exitvalmap on Win32 systems.
1101 - Support new SetOption() and GetOption() functions for setting
1102 various command-line options from with an SConscript file.
1104 - Deprecate the old SetJobs() and GetJobs() functions in favor of
1105 using the new generic {Set,Get}Option() functions.
1107 - Fix a number of tests that searched for a Fortran compiler using the
1108 external PATH instead of what SCons would use.
1110 - Fix the interaction of SideEffect() and BuildDir() so that (for
1111 example) PDB files get put correctly in a BuildDir().
1115 - Contribute the "Autoscons" code for Autoconf-like checking for
1116 the existence of libraries, header files and the like.
1118 - Have the Tool() function add the tool name to the $TOOLS
1119 construction variable.
1123 - Support the C preprocessor #import statement.
1125 - Allow the SharedLibrary() Builder on Win32 systems to be able to
1126 register a newly-built dll using regsvr32.
1128 - Add a Builder for Windows type library (.tlb) files from IDL files.
1130 - Add an IDL scanner.
1132 - Refactor the Fortran, C and IDL scanners to share common logic.
1134 - Add .srcpath and .srcdir attributes to $TARGET and $SOURCE.
1136 From Christoph Wiedemann:
1138 - Integrate David Snopek's "Autoscons" code as the new SConf
1139 configuration subsystem, including caching of values between
1140 runs (using normal SCons dependency mechanisms), tests, and
1145 RELEASE 0.13 - Mon, 31 Mar 2003 20:22:00 -0600
1149 - Fix a bug when BuildDir(duplicate=0) is used and SConscript
1150 files are called from within other SConscript files.
1152 - Support (older) versions of Perforce which don't set the Windows
1157 RELEASE 0.12 - Thu, 27 Mar 2003 23:52:09 -0600
1161 - Added support for the Perforce source code management system.
1163 - Fix str(Node.FS) so that it returns a path relative to the calling
1164 SConscript file's directory, not the top-level directory.
1166 - Added support for a separate src_dir argument to SConscript()
1167 that allows explicit specification of where the source files
1168 for an SConscript file can be found.
1170 - Support more easily re-usable flavors of command generators by
1171 calling callable variables when strings are expanded.
1175 - Added an INSTALL construction variable that can be set to a function
1176 to control how the Install() and InstallAs() Builders install files.
1177 The default INSTALL function now copies, not links, files.
1179 - Remove deprecated features: the "name" argument to Builder objects,
1180 and the Environment.Update() method.
1182 - Add an Environment.SourceCode() method to support fetching files
1183 from source code systems. Add factory methods that create Builders
1184 to support BitKeeper, CVS, RCS, and SCCS. Add support for fetching
1185 files from RCS or SCCS transparently (like GNU Make).
1187 - Make the internal to_String() function more efficient.
1189 - Make the error message the same as other build errors when there's a
1190 problem unlinking a target file in preparation for it being built.
1192 - Make TARGET, TARGETS, SOURCE and SOURCES reserved variable names and
1193 warn if the user tries to set them in a construction environment.
1195 - Add support for Tar and Zip files.
1197 - Better documentation of the different ways to export variables to a
1198 subsidiary SConscript file. Fix documentation bugs in a tools
1199 example, places that still assumed SCons split strings on white
1202 - Support fetching arbitrary files from the TARGETS or SOURCES lists
1203 (e.g. ${SOURCES[2]}) when calculating the build signature of a
1206 - Don't silently swallow exceptions thrown by Scanners (or other
1207 exceptions while finding a node's dependent children).
1209 - Push files to CacheDir() before calling the superclass built()
1210 method (which may clear the build signature as part of clearing
1211 cached implicit dependencies, if the file has a source scanner).
1212 (Bug reported by Jeff Petkau.)
1214 - Raise an internal error if we attempt to push a file to CacheDir()
1215 with a build signature of None.
1217 - Add an explicit Exit() function for terminating early.
1219 - Change the documentation to correctly describe that the -f option
1220 doesn't change to the directory in which the specified file lives.
1222 - Support changing directories locally with SConscript directory
1223 path names relative to any SConstruct file specified with -f.
1224 This allows you to build in another directory by simply changing
1225 there and pointing at the SConstruct file in another directory.
1227 - Change the default SConscriptChdir() behavior to change to the
1228 SConscript directory while it's being read.
1230 - Fix an exception thrown when the -U option was used with no
1231 Default() target specified.
1233 - Fix -u so that it builds things in corresponding build directories
1234 when used in a source directory.
1238 - Add SharedObject() support to the masm tool.
1240 - Fix WhereIs() to return normalized paths.
1244 - Don't copy a built file to a CacheDir() if it's already there.
1246 - Avoid partial copies of built files in a CacheDir() by copying
1247 to a temporary file and renaming.
1251 - Fix incorrect dependency-cycle errors when an Aliased source doesn't
1256 RELEASE 0.11 - Tue, 11 Feb 2003 05:24:33 -0600
1260 - Add support for IRIX and the SGI MIPSPro tool chain.
1262 - Support using the MSVC tool chain when running Cygwin Python.
1266 - Avoid losing signal bits in the exit status from a command,
1267 helping terminate builds on interrupt (CTRL+C).
1271 - Added new AddPreAction() and AddPostAction() functions that support
1272 taking additional actions before or after building specific targets.
1274 - Add support for the PharLap ETS tool chain.
1278 - Allow Python function Actions to specify a list of construction
1279 variables that should be included in the Action's signature.
1281 - Allow libraries in the LIBS variable to explicitly include the prefix
1282 and suffix, even when using the GNU linker.
1283 (Bug reported by Neal Becker.)
1285 - Use DOS-standard CR-LF line endings in the scons.bat file.
1286 (Bug reported by Gary Ruben.)
1288 - Doc changes: Eliminate description of deprecated "name" keyword
1289 argument from Builder definition (reported by Gary Ruben).
1291 - Support using env.Append() on BUILDERS (and other dictionaries).
1292 (Bug reported by Bj=F6rn Bylander.)
1294 - Setting the BUILDERS construction variable now properly clears
1295 the previous Builder attributes from the construction Environment.
1296 (Bug reported by Bj=F6rn Bylander.)
1298 - Fix adding a prefix to a file when the target isn't specified.
1299 (Bug reported by Esa Ilari Vuokko.)
1301 - Clean up error messages from problems duplicating into read-only
1302 BuildDir directories or into read-only files.
1304 - Add a CommandAction.strfunction() method, and add an "env" argument
1305 to the FunctionAction.strfunction() method, so that all Action
1306 objects have strfunction() methods, and the functions for building
1307 and returning a string both take the same arguments.
1309 - Add support for new CacheDir() functionality to share derived files
1310 between builds, with related options --cache-disable, --cache-force,
1313 - Change the default behavior when no targets are specified to build
1314 everything in the current directory and below (like Make). This
1315 can be disabled by specifying Default(None) in an SConscript.
1317 - Revamp SCons installation to fix a case-sensitive installation
1318 on Win32 systems, and to add SCons-specific --standard-lib,
1319 --standalone-lib, and --version-lib options for easier user
1320 control of where the libraries get installed.
1322 - Fix the ability to directly import and use Platform and Tool modules
1323 that have been implicitly imported into an Environment().
1325 - Add support for allowing an embedding interface to annotate a node
1328 - Extend the SConscript() function to accept build_dir and duplicate
1329 keyword arguments that function like a BuildDir() call.
1333 - Fix the output of -c -n when directories are involved, so it
1338 - Use a different shared object suffix (.os) when using gcc so shared
1339 and static objects can exist side-by-side in the same directory.
1341 - Allow the same object files on Win32 to be linked into either
1342 shared or static libraries.
1344 - Cache implicit cache values when using --implicit-cache.
1348 RELEASE 0.10 - Thu, 16 Jan 2003 04:11:46 -0600
1350 From Derrick 'dman' Hudson:
1352 - Support Repositories on other file systems by symlinking or
1353 copying files when hard linking won't work.
1357 - Remove Python bytecode (*.pyc) files from the scons-local packages.
1359 - Have FunctionActions print a description of what they're doing
1360 (a representation of the Python call).
1362 - Fix the Install() method so that, like other actions, it prints
1363 what would have happened when the -n option is used.
1365 - Don't create duplicate source files in a BuildDir when the -n
1368 - Refactor the Scanner interface to eliminate unnecessary Scanner
1369 calls and make it easier to write efficient scanners.
1371 - Added a "recursive" flag to Scanner creation that specifies the
1372 Scanner should be invoked recursively on dependency files returned
1375 - Significant performance improvement from using a more efficient
1376 check, throughout the code, for whether a Node has a Builder.
1378 - Fix specifying only the source file to MultiStepBuilders such as
1379 the Program Builder. (Bug reported by Dean Bair.)
1381 - Fix an exception when building from a file with the same basename as
1382 the subdirectory in which it lives. (Bug reported by Gerard Patel.)
1384 - Fix automatic deduction of a target file name when there are
1385 multiple source files specified; the target is now deduced from just
1386 the first source file in the list.
1388 - Documentation fixes: better initial explanation of SConscript files;
1389 fix a misformatted "table" in the StaticObject explanation.
1391 From Steven Knight and Steve Leblanc:
1393 - Fix the -c option so it will remove symlinks.
1397 - Add a Clean() method to support removing user-specified targets
1398 when using the -c option.
1400 - Add a development script for running SCons through PyChecker.
1402 - Clean up things found by PyChecker (mostly unnecessary imports).
1404 - Add a script to use HappyDoc to create HTML class documentation.
1408 - Make the Environment.get() method return None by default.
1412 - Add SetJobs() and GetJobs() methods to allow configuration of the
1413 number of default jobs (still overridden by -j).
1415 - Convert the .sconsign file format from ASCII to a pickled Python
1418 - Error message cleanups: Made consistent the format of error
1419 messages (now all start with "scons: ***") and warning messages (now
1420 all start with "scons: warning:"). Caught more cases with the "Do
1421 not know how to build" error message.
1423 - Added support for the MinGW tool chain.
1425 - Added a --debug=includes option.
1429 RELEASE 0.09 - Thu, 5 Dec 2002 04:48:25 -0600
1433 - Add a Prepend() method to Environments, to append values to
1434 the beginning of construction variables.
1438 - Add long command-line support to the "lib" Tool (Microsoft library
1443 - Allow $$ in a string to be passed through as $.
1445 - Support file names with odd characters in them.
1447 - Add support for construction variable substition on scanner
1448 directories (in CPPPATH, F77PATH, LIBPATH, etc.).
1450 From Charles Crain and Steven Knight:
1452 - Add Repository() functionality, including the -Y option.
1456 - Fix auto-deduction of target names so that deduced targets end
1457 up in the same subdirectory as the source.
1459 - Don't remove source files specified on the command line!
1461 - Suport the Intel Fortran Compiler (ifl.exe).
1463 - Supply an error message if there are no command-line or
1464 Default() targets specified.
1466 - Fix the ASPPCOM values for the GNU assembler.
1467 (Bug reported by Brett Polivka.)
1469 - Fix an exception thrown when a Default() directory was specified
1470 when using the -U option.
1472 - Issue a warning when -c can't remove a target.
1474 - Eliminate unnecessary Scanner calls by checking for the
1475 existence of a file before scanning it. (This adds a generic
1476 hook to check an arbitrary condition before scanning.)
1478 - Add explicit messages to tell when we're "Reading SConscript files
1479 ...," "done reading SConscript files," "Building targets," and
1480 "done building targets." Add a -Q option to supress these.
1482 - Add separate $SHOBJPREFIX and $SHOBJSUFFIX construction variables
1483 (by default, the same as $OBJPREFIX and $OBJSUFFIX).
1485 - Add Make-like error messages when asked to build a source file,
1486 and before trying to build a file that doesn't have all its source
1487 files (including when an invalid drive letter is used on WIN32).
1489 - Add an scons-local-{version} package (in both .tar.gz and .zip
1490 flavors) to help people who want to ship SCons as a stand-alone
1491 build tool in their software packages.
1493 - Prevent SCons from unlinking files in certain situations when
1494 the -n option is used.
1496 - Change the name of Tool/lib.py to Tool/mslib.py.
1498 From Steven Knight and Anthony Roach:
1500 - Man page: document the fact that Builder calls return Node objects.
1504 - Refactor option processing to use our own version of Greg Ward's
1505 Optik module, modified to run under Python 1.5.2.
1507 - Add a ParseConfig() command to modify an environment based on
1508 parsing output from a *-config command.
1512 - Fix interpretation of '#/../foo' on Win32 systems.
1516 - Fixed use of command lines with spaces in their arguments,
1517 and use of Nodes with spaces in their string representation.
1519 - Make access and modification times of files in a BuildDir match
1520 the source file, even when hard linking isn't available.
1522 - Make -U be case insensitive on Win32 systems.
1524 - Issue a warning and continue when finding a corrupt .sconsign file.
1526 - Fix using an alias as a dependency of a target so that if one of the
1527 alias' dependencies gets rebuilt, the resulting target will, too.
1529 - Fix differently ordered targets causing unnecessary rebuilds
1530 on case insensitive systems.
1532 - Use os.system() to execute external commands whenever the "env"
1533 utility is available, which is much faster than fork()/exec(),
1534 and fixes the -j option on several platforms.
1536 - Fix use of -j with multiple targets.
1538 - Add an Options() object for friendlier accomodation of command-
1541 - Add support for Microsoft VC++ precompiled header (.pch) files,
1542 debugger (.pdb) files, and resource (.rc) files.
1544 - Don't compute the $_CPPINCFLAGS, $_F77INCFLAGS, $_LIBFLAGS and
1545 $_LIBDIRFLAGS variables each time a command is executed, define
1546 them so they're computed only as needed. Add a new _concat
1547 function to the Environment that allows people to define their
1548 own similar variables.
1550 - Fix dependency scans when $LIBS is overridden.
1552 - Add EnsurePythonVersion() and EnsureSConsVersion() functions.
1554 - Fix the overly-verbose stack trace on ListBuilder build errors.
1556 - Add a SetContentSignatureType() function, allowing use of file
1557 timestamps instead of MD5 signatures.
1559 - Make -U and Default('source') fail gracefully.
1561 - Allow the File() and Dir() methods to take a path-name string as
1562 the starting directory, in addition to a Dir object.
1564 - Allow the command handler to be selected via the SPAWN, SHELL
1565 and ESCAPE construction variables.
1567 - Allow construction variables to be overridden when a Builder
1572 - Dynamically check for the existence of utilities with which to
1573 initialize Environments by default.
1577 RELEASE 0.08 - Mon, 15 Jul 2002 12:08:51 -0500
1581 - Fixed a bug with relative CPPPATH dirs when using BuildDir().
1582 (Bug reported by Bob Summerwill.)
1584 - Added a warnings framework and a --warn option to enable or
1587 - Make the C scanner warn users if files referenced by #include
1588 directives cannot be found and --warn=dependency is specified.
1590 - The BUILDERS construction variable should now be a dictionary
1591 that maps builder names to actions. Existing uses of lists,
1592 and the Builder name= keyword argument, generate warnings
1593 about use of deprecated features.
1595 - Removed the "shared" keyword argument from the Object and
1598 - Added separated StaticObject, SharedObject, StaticLibrary and
1599 SharedLibrary builders. Made Object and Library synonyms for
1600 StaticObject and StaticLibrary, respectively.
1602 - Add LIBS and LIBPATH dependencies for shared libraries.
1604 - Removed support for the prefix, suffix and src_suffix arguments
1605 to Builder() to be callable functions.
1607 - Fix handling file names with multiple dots.
1609 - Allow a build directory to be outside of the SConstruct tree.
1611 - Add a FindFile() function that searches for a file node with a
1614 - Add $CPPFLAGS to the shared-object command lines for g++ and gcc.
1616 From Charles Crain and Steven Knight:
1618 - Add a "tools=" keyword argument to Environment instantiation,
1619 and a separate Tools() method, for more flexible specification
1620 of tool-specific environment changes.
1624 - Add a "platform=" keyword argument to Environment instantiation,
1625 and a separate Platform() method, for more flexible specification
1626 of platform-specific environment changes.
1628 - Updated README instructions and setup.py code to catch an
1629 installation failure from not having distutils installed.
1631 - Add descriptions to the -H help text for -D, -u and -U so
1632 people can tell them apart.
1634 - Remove the old feature of automatically splitting strings
1635 of file names on white space.
1637 - Add a dependency Scanner for native Fortran "include" statements,
1638 using a new "F77PATH" construction variable.
1640 - Fix C #include scanning to detect file names with characters like
1643 - Add more specific version / build output to the -v option.
1645 - Add support for the GNU as, Microsoft masm, and nasm assemblers.
1647 - Allow the "target" argument to a Builder call to be omitted, in
1648 which case the target(s) are deduced from the source file(s) and the
1649 Builder's specified suffix.
1651 - Add a tar archive builder.
1653 - Add preliminary support for the OS/2 Platform, including the icc
1658 - Fix --implicit-cache if the scanner returns an empty list.
1662 - Add a "multi" keyword argument to Builder creation that specifies
1663 it's okay to call the builder multiple times for a target.
1665 - Set a "multi" on Aliases so multiple calls will append to an Alias.
1667 - Fix emitter functions' use of path names when using BuildDir or
1670 - Fix --implicit-cache causing redundant rebuilds when the header
1673 - Fix --implicit-cache when a file has no implicit dependencies and
1674 its source is generated.
1676 - Make the drive letters on Windows always be the same case, so that
1677 changes in the case of drive letters don't cause a rebuild.
1679 - Fall back to importing the SCons.TimeStamp module if the SCons.MD5
1680 module can't be imported.
1682 - Fix interrupt handling to guarantee that a single interrupt will
1683 halt SCons both when using -j and not.
1685 - Fix .sconsign signature storage so that output files of one build
1686 can be safely used as input files to another build.
1688 - Added a --debug=time option to print SCons execution times.
1690 - Print an error message if a file can't be unlinked before being
1691 built, rather than just silently terminating the build.
1693 - Add a SideEffect() method that can be used to tell the build
1694 engine that a given file is created as a side effect of building
1695 a target. A file can be specified as a side effect of more than
1696 one build comand, in which case the commands will not be executed
1699 - Significant performance gains from not using our own version of
1700 the inefficient stock os.path.splitext() method, caching source
1701 suffix computation, code cleanup in MultiStepBuilder.__call__(),
1702 and replicating some logic in scons_subst().
1704 - Add --implicit-deps-changed and --implicit-deps-unchanged options.
1706 - Add a GetLaunchDir() function.
1708 - Add a SetBuildSignatureType() function.
1712 - Add an Append() method to Environments, to append values to
1713 construction variables.
1715 - Change the name of Update() to Replace(). Keep Update() as a
1716 deprecated synonym, at least for now.
1718 From Terrel Shumway:
1720 - Use a $PYTHON construction variable, initialized to sys.executable,
1721 when using Python to build parts of the SCons packages.
1723 - Use sys.prefix, not sys.exec_prefix, to find pdb.py.
1727 RELEASE 0.07 - Thu, 2 May 2002 13:37:16 -0500
1731 - Changes to build SCons packages on IRIX (and other *NIces).
1733 - Don't create a directory Node when a file already exists there,
1736 - Add 'dirs' and 'names' keyword arguments to SConscript for
1737 easier specification of subsidiary SConscript files.
1741 - Internal cleanup of environment passing to function Actions.
1743 - Builders can now take arbitrary keyword arguments to create
1744 attributes to be passed to: command generator functions,
1745 FunctionAction functions, Builder emitter functions (below),
1746 and prefix/suffix generator functions (below).
1748 - Command generator functions can now return ANYTHING that can be
1749 converted into an Action (a function, a string, a CommandGenerator
1750 instance, even an ActionBase instance).
1752 - Actions now call get_contents() with the actual target and source
1753 nodes used for the build.
1755 - A new DictCmdGenerator class replaces CompositeBuilder to support
1756 more flexible Builder behavior internally.
1758 - Builders can now take an emitter= keyword argument. An emitter
1759 is a function that takes target, source, and env argument, then
1760 return a 2-tuple of (new sources, new targets). The emitter is
1761 called when the Builder is __call__'ed, allowing a user to modify
1762 source and target lists.
1764 - The prefix, suffix and src_suffix Builder arguments now take a
1765 callable as well a string. The callable is passed the Environment
1766 and any extra Builder keyword arguments and is expected to return
1767 the appropriate prefix or suffix.
1769 - CommandActions can now be a string, a list of command + argument
1770 strings, or a list of commands (strings or lists).
1772 - Added shared library support. The Object and Library Builders now
1773 take a "shared=1" keyword argument to specify that a shared object
1774 or shared library should be built. It is an error to try to build
1775 static objects into a shared library or vice versa.
1777 - Win32 support for .def files has been added. Added the Win32-specific
1778 construction variables $WIN32DEFPREFIX, $WIN32DEFSUFFIX,
1779 $WIN32DLLPREFIX and $WIN32IMPLIBPREFIX. When building a .dll,
1780 the new construction variable $WIN32_INSERT_DEF, controls whether
1781 the appropriately-named .def file is inserted into the target
1782 list (if not already present). A .lib file is always added to
1783 a Library build if not present in the list of targets.
1785 - ListBuilder now passes all targets to the action, not just the first.
1787 - Fix so that -c now deletes generated yacc .h files.
1789 - Builder actions and emitter functions can now be initialized, through
1790 construction variables, to things other than strings.
1792 - Make top-relative '#/dir' lookups work like '#dir'.
1794 - Fix for relative CPPPATH directories in subsidiary SConscript files
1797 - Add a for_signature argument to command generators, so that
1798 generators that need to can return distinct values for the
1799 command signature and for executing the command.
1803 - Create a better scons.bat file from a py2bat.py script on the Python
1804 mailing list two years ago (modeled after pl2bat.pl).
1808 - Fix so that -c -n does *not* remove the targets!
1810 - Man page: Add a hierarchical libraries + Program example.
1812 - Support long MSVC linker command lines through a builder action
1813 that writes to a temporary file and uses the magic MSVC "link @file"
1814 argument syntax if the line is longer than 2K characters.
1816 - Fix F77 command-line options on Win32 (use /Fo instead of -o).
1818 - Use the same action to build from .c (lower case) and .C (upper
1819 case) files on case-insensitive systems like Win32.
1821 - Support building a PDF file directly from a TeX or LaTeX file
1822 using pdftex or pdflatex.
1824 - Add a -x option to runtest.py to specify the script being tested.
1825 A -X option indicates it's an executable, not a script to feed
1826 to the Python interpreter.
1828 - Add a Split() function (identical to SCons.Util.argmunge()) for use
1829 in the next release, when Builders will no longer automatically split
1830 strings on white space.
1834 - Add the SConscriptChdir() method.
1838 - Fix --debug=tree when used with directory targets.
1840 - Significant internal restructuring of Scanners and Taskmaster.
1842 - Added new --debug=dtree option.
1844 - Fixes for --profile option.
1846 - Performance improvement in construction variable substitution.
1848 - Implemented caching of content signatures, plus added --max-drift
1849 option to control caching.
1851 - Implemented caching of dependency signatures, enabled by new
1852 --implicit-cache option.
1854 - Added abspath construction variable modifier.
1856 - Added $SOURCE variable as a synonym for $SOURCES[0].
1858 - Write out .sconsign files on error or interrupt so intermediate
1859 build results are saved.
1861 - Change the -U option to -D. Make a new -U that builds just the
1862 targets from the local SConscript file.
1864 - Fixed use of sys.path so Python modules can be imported from
1865 the SConscript directory.
1867 - Fix for using Aliases with the -u, -U and -D options.
1869 - Fix so that Nodes can be passed to SConscript files.
1873 - Changes for official Debian packaging.
1877 RELEASE 0.06 - Thu, 28 Mar 2002 01:24:29 -0600
1881 - Fix command generators to expand construction variables.
1883 - Make FunctionAction arguments be Nodes, not strings.
1885 From Stephen Kennedy:
1887 - Performance: Use a dictionary, not a list, for a Node's parents.
1891 - Add .zip files to the packages we build.
1893 - Man page: document LIBS, fix a typo, document ARGUMENTS.
1895 - Added RANLIB and RANLIBFLAGS construction variables. Only use them
1896 in ARCOM if there's a "ranlib" program on the system.
1898 - Add a configurable CFILESUFFIX for the Builder of .l and .y files
1901 - Add a CXXFile Builder that turns .ll and .yy files into .cc files
1902 (configurable via a CXXFILESUFFIX construction variable).
1904 - Use the POSIX-standard lex -t flag, not the GNU-specific -o flag.
1905 (Bug reported by Russell Christensen.)
1907 - Fixed an exception when CPPPATH or LIBPATH is a null string.
1908 (Bug reported by Richard Kiss.)
1910 - Add a --profile=FILE option to make profiling SCons easier.
1912 - Modify the new DVI builder to create .dvi files from LaTeX (.ltx
1915 - Add support for Aliases (phony targets).
1917 - Add a WhereIs() method for searching for path names to executables.
1919 - Add PDF and PostScript document builders.
1921 - Add support for compiling Fortran programs from a variety of
1922 suffixes (a la GNU Make): .f, .F, .for, .FOR, .fpp and .FPP
1924 - Support a CPPFLAGS variable on all default commands that use the
1929 - Add support for the -U option.
1931 - Allow CPPPATH, LIBPATH and LIBS to be specified as white-space
1934 - Add a document builder to create .dvi files from TeX (.tex) files.
1938 - Fix: Construction variables with values of 0 were incorrectly
1941 - Support env['VAR'] to fetch construction variable values.
1943 - Man page: document Precious().
1947 RELEASE 0.05 - Thu, 21 Feb 2002 16:50:03 -0600
1951 - Set PROGSUFFIX to .exe under Cygwin.
1955 - Allow a library to specified as a command-line source file, not just
1956 in the LIBS construction variable.
1958 - Compensate for a bug in os.path.normpath() that returns '' for './'
1961 - More performance optimizations: cache #include lines from files,
1962 eliminate unnecessary calls.
1964 - If a prefix or suffix contains white space, treat the resulting
1965 concatenation as separate arguments.
1967 - Fix irregularities in the way we fetch DevStudio information from
1968 the Windows registry, and in our registry error handling.
1972 - Flush stdout after print so it intermixes correctly with stderr
1975 - Allow Scanners to return a list of strings, and document how to
1976 write your own Scanners.
1978 - Look up implicit (scanned) dependencies relative to the directory
1979 of file being scanned.
1981 - Make writing .sconsign files more robust by first trying to write
1982 to a temp file that gets renamed.
1984 - Create all of the directories for a list of targets before trying
1985 to build any of the targets.
1987 - WIN32 portability fixes in tests.
1989 - Allow the list of variables exported to an SConscript file to be
1992 - Document the overlooked LIBPATH construction variable.
1993 (Bug reported by Eicke Godehardt.)
1995 - Fix so that Ignore() ignores indirect, implicit dependencies
1996 (included files), not just direct dependencies.
1998 - Put the man page in the Debian distribution.
2000 - Run HTML docs through tidy to clean up the HTML (for Konqueror).
2002 - Add preliminary support for Unicode strings.
2004 - Efficiency: don't scan dependencies more than once during the
2007 - Fix the -c option so it doesn't stop removing targets if one doesn't
2009 (Bug reported by Paul Connell.)
2011 - Fix the --debug=pdb option when run on Windows NT.
2012 (Bug reported by Paul Connell.)
2014 - Add support for the -q option.
2018 - Add support for the -u option.
2020 - Add .cc and .hh file suffixes to the C Scanner.
2024 - Make the scons script return an error code on failures.
2026 - Add support for using code to generate a command to build a target.
2030 RELEASE 0.04 - Wed, 30 Jan 2002 11:09:42 -0600
2034 - Significant performance improvements in the Node.FS and
2037 - Fix signatures of binary files on Win32 systems.
2039 - Allow LIBS and LIBPATH to be strings, not just arrays.
2041 - Print a traceback if a Python-function builder throws an exception.
2045 - Fix using a directory as a Default(), and allow Default() to
2046 support white space in file names for strings in arrays.
2048 - Man page updates: corrected some mistakes, documented various
2049 missing Environment methods, alphabetized the construction
2050 variables and other functions, defined begin and end macros for
2051 the example sections, regularized white space separation, fixed
2052 the use of Export() in the Multiple Variants example.
2054 - Function action fixes: None is now a successful return value.
2055 Exceptions are now reported. Document function actions.
2057 - Add 'Action' and 'Scanner' to the global keywords so SConscript
2058 files can use them too.
2060 - Removed the Wrapper class between Nodes and Walkers.
2062 - Add examples using Library, LIBS, and LIBPATH.
2064 - The C Scanner now always returns a sorted list of dependencies
2065 so order changes don't cause unnecessary rebuilds.
2067 - Strip $(-$) bracketed text from command lines. Use this to
2068 surround $_INCDIRS and $_LIBDIRS so we don't rebuild in response
2069 to changes to -I or -L options.
2071 - Add the Ignore() method to ignore dependencies.
2073 - Provide an error message when a nonexistent target is specified
2074 on the command line.
2076 - Remove targets before building them, and add an Environment
2077 Precious() method to override that.
2079 - Eliminate redundant calls to the same builder when the target is a
2080 list of targets: Add a ListBuilder class that wraps Builders to
2081 handle lists atomically. Extend the Task class to support building
2082 and updating multiple targets in a single Task. Simplify the
2083 interface between Task and Taskmaster.
2085 - Add a --debug=pdb option to re-run SCons under the Python debugger.
2087 - Only compute a build signature once for each node.
2089 - Changes to our sys.path[] manipulation to support installation into
2090 an arbitrary --prefix value.
2094 - Add var=value command-line arguments.
2098 RELEASE 0.03 - Fri, 11 Jan 2002 01:09:30 -0600
2102 - Performance improvements in the Node.FS and Sig.Calculator classes.
2104 - Add the InstallAs() method.
2106 - Execute commands through an external interpreter (sh, cmd.exe, or
2107 command.com) to handle redirection metacharacters.
2109 - Allow the user to supply a command handler.
2113 - Search both /usr/lib and /usr/local/lib for scons directories by
2114 adding them both to sys.path, with whichever is in sys.prefix first.
2116 - Fix interpreting strings of multiple white-space separated file names
2117 as separate file names, allowing prefixes and suffixes to be appended
2118 to each individually.
2120 - Refactor to move CompositeBuilder initialization logic from the
2121 factory wrapper to the __init__() method, and allow a Builder to
2122 have both an action and a src_builder (or array of them).
2124 - Refactor BuilderBase.__call__() to separate Node creation/lookup
2125 from initialization of the Node's builder information.
2127 - Add a CFile Builder object that supports turning lex (.l) and
2128 yacc (.y) files into .c files.
2130 - Document: variable interpretation attributes; how to propogate
2131 the user's environment variables to executed commands; how to
2132 build variants in multiple BuildDirs.
2134 - Collect String, Dict, and List type-checking in common utility
2135 routines so we can accept User{String,Dict,List}s all over.
2137 - Put the Action factory and classes into their own module.
2139 - Use one CPlusPlusAction in the Object Builder's action dictionary,
2140 instead of letting it create multiple identical instances.
2142 - Document the Install() and InstallAs() methods.
2146 - Require that a Builder be given a name argument, supplying a
2147 useful error message when it isn't.
2151 - Add a "duplicate" keyword argument to BuildDir() that can be set
2152 to prevent linking/copying source files into build directories.
2154 - Add a "--debug=tree" option to print an ASCII dependency tree.
2156 - Fetch the location of the Microsoft Visual C++ compiler(s) from
2157 the Registry, instead of hard-coding the location.
2159 - Made Scanner objects take Nodes, not path names.
2161 - Have the C Scanner cache the #include file names instead of
2162 (re-)scanning the file each time it's called.
2164 - Created a separate class for parent "nodes" of file system roots,
2165 eliminating the need for separate is-parent-null checks everywhere.
2167 - Removed defined __hash__() and __cmp() methods from FS.Entry, in
2168 favor of Python's more efficient built-in identity comparisons.
2172 RELEASE 0.02 - Sun, 23 Dec 2001 19:05:09 -0600
2176 - Added the Install(), BuildDir(), and Export() methods.
2178 - Fix the -C option by delaying setting the top of the FS tree.
2180 - Avoid putting the directory path on the libraries in the LIBS
2181 construction variable.
2183 - Added a GetBuildPath() method to return the full path to the
2184 Node for a specified string.
2186 - Fixed variable substitution in CPPPATH and LIBPATH.
2190 - Fixed the version comment in the scons.bat (the UNIX geek used
2193 - Fix to setup.py so it doesn't require a sys.argv[1] argument.
2195 - Provide make-like warning message for "command not found" and
2198 - Added an EXAMPLES section to the man page.
2200 - Make Default() targets properly relative to their SConscript
2201 file's subdirectory.
2205 - Documented CXXFLAGS, CXXCOM, and CPPPATH.
2207 - Fixed SCONS_LIB_DIR to work as documented.
2209 - Made Default() accept Nodes as arguments.
2211 - Changed Export() to make it easier to use.
2213 - Added the Import() and Return() methods.
2217 RELEASE 0.01 - Thu Dec 13 19:25:23 CST 2001
2219 A brief overview of important functionality available in release 0.01:
2221 - C and C++ compilation on POSIX and Windows NT.
2223 - Automatic scanning of C/C++ source files for #include dependencies.
2225 - Support for building libraries; setting construction variables
2226 allows creation of shared libraries.
2228 - Library and C preprocessor search paths.
2230 - File changes detected using MD5 signatures.
2232 - User-definable Builder objects for building files.
2234 - User-definable Scanner objects for scanning for dependencies.
2236 - Parallel build (-j) support.
2238 - Dependency cycles detected.
2240 - Linux packages available in RPM and Debian format.
2242 - Windows installer available.