1 # Copyright (c) 2001, 2002 Steven Knight
2 # __FILE__ __REVISION__ __DATE__ __DEVELOPER__
5 SCons - a software construction tool
15 - Fixed a bug with relative CPPPATH dirs when using BuildDir().
16 (Bug reported by Bob Summerwill.)
18 - Added a warnings framework and a --warn option to enable or
21 - Make the C scanner warn users if files referenced by #include
22 directives cannot be found and --warn=dependency is specified.
24 - The BUILDERS construction variable should now be a dictionary
25 that maps builder names to actions. Existing uses of lists,
26 and the Builder name= keyword argument, generate warnings
27 about use of deprecated features.
29 - Removed the "shared" keyword argument from the Object and
32 - Added separated StaticObject, SharedObject, StaticLibrary and
33 SharedLibrary builders. Made Object and Library synonyms for
34 StaticObject and StaticLibrary, respectively.
36 - Add LIBS and LIBPATH dependencies for shared libraries.
38 - Removed support for the prefix, suffix and src_suffix arguments
39 to Builder() to be callable functions.
43 - Add a "platform=" keyword argument to Environment instantiation,
44 and a separate Platform() method, for more flexible specification
45 of platform-specific environment changes.
47 - Updated README instructions and setup.py code to catch an
48 installation failure from not having distutils installed.
50 - Add descriptions to the -H help text for -D, -u and -U so
51 people can tell them apart.
53 - Remove the old feature of automatically splitting strings
54 of file names on white space.
56 - Add a dependency Scanner for native Fortran "include" statements,
57 using a new "F77PATH" construction variable.
59 - Fix C #include scanning to detect file names with characters like
64 - Fix --implicit-cache if the scanner returns an empty list.
68 - Add a "multi" keyword argument to Builder creation that specifies
69 it's okay to call the builder multiple times for a target.
71 - Set a "multi" on Aliases so multiple calls will append to an Alias.
73 - Fix emitter functions' use of path names when using BuildDir or
76 - Fix --implicit-cache causing redundant rebuilds when the header
79 - Fix --implicit-cache when a file has no implicit dependencies and
80 its source is generated.
82 - Make the drive letters on Windows always be the same case, so that
83 changes in the case of drive letters don't cause a rebuild.
85 - Fall back to importing the SCons.TimeStamp module if the SCons.MD5
86 module can't be imported.
88 - Fix interrupt handling to guarantee that a single interrupt will
89 halt SCons both when using -j and not.
91 - Fix .sconsign signature storage so that output files of one build
92 can be safely used as input files to another build.
94 - Added a --debug=time option to print SCons execution times.
96 - Print an error message if a file can't be unlinked before being
97 built, rather than just silently terminating the build.
101 - Add an Append() method to Environments, to append values to
102 construction variables.
104 - Change the name of Update() to Replace(). Keep Update() as a
105 deprecated synonym, at least for now.
109 RELEASE 0.07 - Thu, 2 May 2002 13:37:16 -0500
113 - Changes to build SCons packages on IRIX (and other *NIces).
115 - Don't create a directory Node when a file already exists there,
118 - Add 'dirs' and 'names' keyword arguments to SConscript for
119 easier specification of subsidiary SConscript files.
123 - Internal cleanup of environment passing to function Actions.
125 - Builders can now take arbitrary keyword arguments to create
126 attributes to be passed to: command generator functions,
127 FunctionAction functions, Builder emitter functions (below),
128 and prefix/suffix generator functions (below).
130 - Command generator functions can now return ANYTHING that can be
131 converted into an Action (a function, a string, a CommandGenerator
132 instance, even an ActionBase instance).
134 - Actions now call get_contents() with the actual target and source
135 nodes used for the build.
137 - A new DictCmdGenerator class replaces CompositeBuilder to support
138 more flexible Builder behavior internally.
140 - Builders can now take an emitter= keyword argument. An emitter
141 is a function that takes target, source, and env argument, then
142 return a 2-tuple of (new sources, new targets). The emitter is
143 called when the Builder is __call__'ed, allowing a user to modify
144 source and target lists.
146 - The prefix, suffix and src_suffix Builder arguments now take a
147 callable as well a string. The callable is passed the Environment
148 and any extra Builder keyword arguments and is expected to return
149 the appropriate prefix or suffix.
151 - CommandActions can now be a string, a list of command + argument
152 strings, or a list of commands (strings or lists).
154 - Added shared library support. The Object and Library Builders now
155 take a "shared=1" keyword argument to specify that a shared object
156 or shared library should be built. It is an error to try to build
157 static objects into a shared library or vice versa.
159 - Win32 support for .def files has been added. Added the Win32-specific
160 construction variables $WIN32DEFPREFIX, $WIN32DEFSUFFIX,
161 $WIN32DLLPREFIX and $WIN32IMPLIBPREFIX. When building a .dll,
162 the new construction variable $WIN32_INSERT_DEF, controls whether
163 the appropriately-named .def file is inserted into the target
164 list (if not already present). A .lib file is always added to
165 a Library build if not present in the list of targets.
167 - ListBuilder now passes all targets to the action, not just the first.
169 - Fix so that -c now deletes generated yacc .h files.
171 - Builder actions and emitter functions can now be initialized, through
172 construction variables, to things other than strings.
174 - Make top-relative '#/dir' lookups work like '#dir'.
176 - Fix for relative CPPPATH directories in subsidiary SConscript files
179 - Add a for_signature argument to command generators, so that
180 generators that need to can return distinct values for the
181 command signature and for executing the command.
185 - Create a better scons.bat file from a py2bat.py script on the Python
186 mailing list two years ago (modeled after pl2bat.pl).
190 - Fix so that -c -n does *not* remove the targets!
192 - Man page: Add a hierarchical libraries + Program example.
194 - Support long MSVC linker command lines through a builder action
195 that writes to a temporary file and uses the magic MSVC "link @file"
196 argument syntax if the line is longer than 2K characters.
198 - Fix F77 command-line options on Win32 (use /Fo instead of -o).
200 - Use the same action to build from .c (lower case) and .C (upper
201 case) files on case-insensitive systems like Win32.
203 - Support building a PDF file directly from a TeX or LaTeX file
204 using pdftex or pdflatex.
206 - Add a -x option to runtest.py to specify the script being tested.
207 A -X option indicates it's an executable, not a script to feed
208 to the Python interpreter.
210 - Add a Split() function (identical to SCons.Util.argmunge()) for use
211 in the next release, when Builders will no longer automatically split
212 strings on white space.
216 - Add the SConscriptChdir() method.
220 - Fix --debug=tree when used with directory targets.
222 - Significant internal restructuring of Scanners and Taskmaster.
224 - Added new --debug=dtree option.
226 - Fixes for --profile option.
228 - Performance improvement in construction variable substitution.
230 - Implemented caching of content signatures, plus added --max-drift
231 option to control caching.
233 - Implemented caching of dependency signatures, enabled by new
234 --implicit-cache option.
236 - Added abspath construction variable modifier.
238 - Added $SOURCE variable as a synonym for $SOURCES[0].
240 - Write out .sconsign files on error or interrupt so intermediate
241 build results are saved.
243 - Change the -U option to -D. Make a new -U that builds just the
244 targets from the local SConscript file.
246 - Fixed use of sys.path so Python modules can be imported from
247 the SConscript directory.
249 - Fix for using Aliases with the -u, -U and -D options.
251 - Fix so that Nodes can be passed to SConscript files.
255 - Changes for official Debian packaging.
259 RELEASE 0.06 - Thu, 28 Mar 2002 01:24:29 -0600
263 - Fix command generators to expand construction variables.
265 - Make FunctionAction arguments be Nodes, not strings.
267 From Stephen Kennedy:
269 - Performance: Use a dictionary, not a list, for a Node's parents.
273 - Add .zip files to the packages we build.
275 - Man page: document LIBS, fix a typo, document ARGUMENTS.
277 - Added RANLIB and RANLIBFLAGS construction variables. Only use them
278 in ARCOM if there's a "ranlib" program on the system.
280 - Add a configurable CFILESUFFIX for the Builder of .l and .y files
283 - Add a CXXFile Builder that turns .ll and .yy files into .cc files
284 (configurable via a CXXFILESUFFIX construction variable).
286 - Use the POSIX-standard lex -t flag, not the GNU-specific -o flag.
287 (Bug reported by Russell Christensen.)
289 - Fixed an exception when CPPPATH or LIBPATH is a null string.
290 (Bug reported by Richard Kiss.)
292 - Add a --profile=FILE option to make profiling SCons easier.
294 - Modify the new DVI builder to create .dvi files from LaTeX (.ltx
297 - Add support for Aliases (phony targets).
299 - Add a WhereIs() method for searching for path names to executables.
301 - Add PDF and PostScript document builders.
303 - Add support for compiling Fortran programs from a variety of
304 suffixes (a la GNU Make): .f, .F, .for, .FOR, .fpp and .FPP
306 - Support a CPPFLAGS variable on all default commands that use the
311 - Add support for the -U option.
313 - Allow CPPPATH, LIBPATH and LIBS to be specified as white-space
316 - Add a document builder to create .dvi files from TeX (.tex) files.
320 - Fix: Construction variables with values of 0 were incorrectly
323 - Support env['VAR'] to fetch construction variable values.
325 - Man page: document Precious().
329 RELEASE 0.05 - Thu, 21 Feb 2002 16:50:03 -0600
333 - Set PROGSUFFIX to .exe under Cygwin.
337 - Allow a library to specified as a command-line source file, not just
338 in the LIBS construction variable.
340 - Compensate for a bug in os.path.normpath() that returns '' for './'
343 - More performance optimizations: cache #include lines from files,
344 eliminate unnecessary calls.
346 - If a prefix or suffix contains white space, treat the resulting
347 concatenation as separate arguments.
349 - Fix irregularities in the way we fetch DevStudio information from
350 the Windows registry, and in our registry error handling.
354 - Flush stdout after print so it intermixes correctly with stderr
357 - Allow Scanners to return a list of strings, and document how to
358 write your own Scanners.
360 - Look up implicit (scanned) dependencies relative to the directory
361 of file being scanned.
363 - Make writing .sconsign files more robust by first trying to write
364 to a temp file that gets renamed.
366 - Create all of the directories for a list of targets before trying
367 to build any of the targets.
369 - WIN32 portability fixes in tests.
371 - Allow the list of variables exported to an SConscript file to be
374 - Document the overlooked LIBPATH construction variable.
375 (Bug reported by Eicke Godehardt.)
377 - Fix so that Ignore() ignores indirect, implicit dependencies
378 (included files), not just direct dependencies.
380 - Put the man page in the Debian distribution.
382 - Run HTML docs through tidy to clean up the HTML (for Konqueror).
384 - Add preliminary support for Unicode strings.
386 - Efficiency: don't scan dependencies more than once during the
389 - Fix the -c option so it doesn't stop removing targets if one doesn't
391 (Bug reported by Paul Connell.)
393 - Fix the --debug=pdb option when run on Windows NT.
394 (Bug reported by Paul Connell.)
396 - Add support for the -q option.
400 - Add support for the -u option.
402 - Add .cc and .hh file suffixes to the C Scanner.
406 - Make the scons script return an error code on failures.
408 - Add support for using code to generate a command to build a target.
412 RELEASE 0.04 - Wed, 30 Jan 2002 11:09:42 -0600
416 - Significant performance improvements in the Node.FS and
419 - Fix signatures of binary files on Win32 systems.
421 - Allow LIBS and LIBPATH to be strings, not just arrays.
423 - Print a traceback if a Python-function builder throws an exception.
427 - Fix using a directory as a Default(), and allow Default() to
428 support white space in file names for strings in arrays.
430 - Man page updates: corrected some mistakes, documented various
431 missing Environment methods, alphabetized the construction
432 variables and other functions, defined begin and end macros for
433 the example sections, regularized white space separation, fixed
434 the use of Export() in the Multiple Variants example.
436 - Function action fixes: None is now a successful return value.
437 Exceptions are now reported. Document function actions.
439 - Add 'Action' and 'Scanner' to the global keywords so SConscript
440 files can use them too.
442 - Removed the Wrapper class between Nodes and Walkers.
444 - Add examples using Library, LIBS, and LIBPATH.
446 - The C Scanner now always returns a sorted list of dependencies
447 so order changes don't cause unnecessary rebuilds.
449 - Strip $(-$) bracketed text from command lines. Use this to
450 surround $_INCDIRS and $_LIBDIRS so we don't rebuild in response
451 to changes to -I or -L options.
453 - Add the Ignore() method to ignore dependencies.
455 - Provide an error message when a nonexistent target is specified
458 - Remove targets before building them, and add an Environment
459 Precious() method to override that.
461 - Eliminate redundant calls to the same builder when the target is a
462 list of targets: Add a ListBuilder class that wraps Builders to
463 handle lists atomically. Extend the Task class to support building
464 and updating multiple targets in a single Task. Simplify the
465 interface between Task and Taskmaster.
467 - Add a --debug=pdb option to re-run SCons under the Python debugger.
469 - Only compute a build signature once for each node.
471 - Changes to our sys.path[] manipulation to support installation into
472 an arbitrary --prefix value.
476 - Add var=value command-line arguments.
480 RELEASE 0.03 - Fri, 11 Jan 2002 01:09:30 -0600
484 - Performance improvements in the Node.FS and Sig.Calculator classes.
486 - Add the InstallAs() method.
488 - Execute commands through an external interpreter (sh, cmd.exe, or
489 command.com) to handle redirection metacharacters.
491 - Allow the user to supply a command handler.
495 - Search both /usr/lib and /usr/local/lib for scons directories by
496 adding them both to sys.path, with whichever is in sys.prefix first.
498 - Fix interpreting strings of multiple white-space separated file names
499 as separate file names, allowing prefixes and suffixes to be appended
500 to each individually.
502 - Refactor to move CompositeBuilder initialization logic from the
503 factory wrapper to the __init__() method, and allow a Builder to
504 have both an action and a src_builder (or array of them).
506 - Refactor BuilderBase.__call__() to separate Node creation/lookup
507 from initialization of the Node's builder information.
509 - Add a CFile Builder object that supports turning lex (.l) and
510 yacc (.y) files into .c files.
512 - Document: variable interpretation attributes; how to propogate
513 the user's environment variables to executed commands; how to
514 build variants in multiple BuildDirs.
516 - Collect String, Dict, and List type-checking in common utility
517 routines so we can accept User{String,Dict,List}s all over.
519 - Put the Action factory and classes into their own module.
521 - Use one CPlusPlusAction in the Object Builder's action dictionary,
522 instead of letting it create multiple identical instances.
524 - Document the Install() and InstallAs() methods.
528 - Require that a Builder be given a name argument, supplying a
529 useful error message when it isn't.
533 - Add a "duplicate" keyword argument to BuildDir() that can be set
534 to prevent linking/copying source files into build directories.
536 - Add a "--debug=tree" option to print an ASCII dependency tree.
538 - Fetch the location of the Microsoft Visual C++ compiler(s) from
539 the Registry, instead of hard-coding the location.
541 - Made Scanner objects take Nodes, not path names.
543 - Have the C Scanner cache the #include file names instead of
544 (re-)scanning the file each time it's called.
546 - Created a separate class for parent "nodes" of file system roots,
547 eliminating the need for separate is-parent-null checks everywhere.
549 - Removed defined __hash__() and __cmp() methods from FS.Entry, in
550 favor of Python's more efficient built-in identity comparisons.
554 RELEASE 0.02 - Sun, 23 Dec 2001 19:05:09 -0600
558 - Added the Install(), BuildDir(), and Export() methods.
560 - Fix the -C option by delaying setting the top of the FS tree.
562 - Avoid putting the directory path on the libraries in the LIBS
563 construction variable.
565 - Added a GetBuildPath() method to return the full path to the
566 Node for a specified string.
568 - Fixed variable substitution in CPPPATH and LIBPATH.
572 - Fixed the version comment in the scons.bat (the UNIX geek used
575 - Fix to setup.py so it doesn't require a sys.argv[1] argument.
577 - Provide make-like warning message for "command not found" and
580 - Added an EXAMPLES section to the man page.
582 - Make Default() targets properly relative to their SConscript
587 - Documented CXXFLAGS, CXXCOM, and CPPPATH.
589 - Fixed SCONS_LIB_DIR to work as documented.
591 - Made Default() accept Nodes as arguments.
593 - Changed Export() to make it easier to use.
595 - Added the Import() and Return() methods.
599 RELEASE 0.01 - Thu Dec 13 19:25:23 CST 2001
601 A brief overview of important functionality available in release 0.01:
603 - C and C++ compilation on POSIX and Windows NT.
605 - Automatic scanning of C/C++ source files for #include dependencies.
607 - Support for building libraries; setting construction variables
608 allows creation of shared libraries.
610 - Library and C preprocessor search paths.
612 - File changes detected using MD5 signatures.
614 - User-definable Builder objects for building files.
616 - User-definable Scanner objects for scanning for dependencies.
618 - Parallel build (-j) support.
620 - Dependency cycles detected.
622 - Linux packages available in RPM and Debian format.
624 - Windows installer available.