Add --debug-includes. (Anthony Roach)
[scons.git] / src / CHANGES.txt
1 # Copyright (c) 2001, 2002 Steven Knight
2 # __FILE__ __REVISION__ __DATE__ __DEVELOPER__
3
4
5                  SCons - a software construction tool
6
7                             Change Log
8
9
10
11 RELEASE 0.10 - XXX
12
13   From Derrick 'dman' Hudson:
14
15   - Support Repositories on other file systems by symlinking or
16     copying files when hard linking won't work.
17
18   From Steven Knight:
19
20   - Remove Python bytecode (*.pyc) files from the scons-local packages.
21
22   - Have FunctionActions print a description of what they're doing
23     (a representation of the Python call).
24
25   - Fix the Install() method so that, like other actions, it prints
26     what would have happened when the -n option is used.
27
28   - Don't create duplicate source files in a BuildDir when the -n
29     option is used.
30
31   - Refactor the Scanner interface to eliminate unnecessary Scanner
32     calls and make it easier to write efficient scanners.
33
34   - Added a "recursive" flag to Scanner creation that specifies the
35     Scanner should be invoked recursively on dependency files returned
36     by the scanner.
37
38   - Significant performance improvement from using a more efficient
39     check, throughout the code, for whether a Node has a Builder.
40
41   - Fix specifying only the source file to MultiStepBuilders such as
42     the Program Builder.  (Bug reported by Dean Bair.)
43
44   - Fix an exception when building from a file with the same basename as
45     the subdirectory in which it lives.  (Bug reported by Gerard Patel.)
46
47   - Fix automatic deduction of a target file name when there are
48     multiple source files specified; the target is now deduced from just
49     the first source file in the list.
50
51   - Documentation fixes: better initial explanation of SConscript files;
52     fix a misformatted "table" in the StaticObject explanation.
53
54   From Steven Knight and Steve Leblanc:
55
56   - Fix the -c option so it will remove symlinks.
57
58   From Steve Leblanc:
59
60   - Add a Clean() method to support removing user-specified targets
61     when using the -c option.
62
63   - Add a development script for running SCons through PyChecker.
64
65   - Clean up things found by PyChecker (mostly unnecessary imports).
66
67   - Add a script to use HappyDoc to create HTML class documentation.
68
69   From Lachlan O'Dea:
70
71   - Make the Environment.get() method return None by default.
72
73   From Anthony Roach:
74
75   - Add SetJobs() and GetJobs() methods to allow configuration of the
76     number of default jobs (still overridden by -j).
77
78   - Convert the .sconsign file format from ASCII to a pickled Python
79     data structure.
80
81   - Error message cleanups:  Made consistent the format of error
82     messages (now all start with "scons: ***") and warning messages (now
83     all start with "scons: warning:").  Caught more cases with the "Do
84     not know how to build" error message.
85
86   - Added support for the MinGW tool chain.
87
88   - Added a --debug=inclues option.
89
90
91
92 RELEASE 0.09 - Thu,  5 Dec 2002 04:48:25 -0600
93
94   From Chad Austin:
95
96   - Add a Prepend() method to Environments, to append values to
97     the beginning of construction variables.
98
99   From Matt Balvin:
100
101   - Add long command-line support to the "lib" Tool (Microsoft library
102     archiver), too.
103
104   From Charles Crain:
105
106   - Allow $$ in a string to be passed through as $.
107
108   - Support file names with odd characters in them.
109
110   - Add support for construction variable substition on scanner
111     directories (in CPPPATH, F77PATH, LIBPATH, etc.).
112
113   From Charles Crain and Steven Knight:
114
115   - Add Repository() functionality, including the -Y option.
116
117   From Steven Knight:
118
119   - Fix auto-deduction of target names so that deduced targets end
120     up in the same subdirectory as the source.
121
122   - Don't remove source files specified on the command line!
123
124   - Suport the Intel Fortran Compiler (ifl.exe).
125
126   - Supply an error message if there are no command-line or
127     Default() targets specified.
128
129   - Fix the ASPPCOM values for the GNU assembler.
130     (Bug reported by Brett Polivka.)
131
132   - Fix an exception thrown when a Default() directory was specified
133     when using the -U option.
134
135   - Issue a warning when -c can't remove a target.
136
137   - Eliminate unnecessary Scanner calls by checking for the
138     existence of a file before scanning it.  (This adds a generic
139     hook to check an arbitrary condition before scanning.)
140
141   - Add explicit messages to tell when we're "Reading SConscript files
142     ...," "done reading SConscript files," "Building targets," and
143     "done building targets."  Add a -Q option to supress these.
144
145   - Add separate $SHOBJPREFIX and $SHOBJSUFFIX construction variables
146     (by default, the same as $OBJPREFIX and $OBJSUFFIX).
147
148   - Add Make-like error messages when asked to build a source file,
149     and before trying to build a file that doesn't have all its source
150     files (including when an invalid drive letter is used on WIN32).
151
152   - Add an scons-local-{version} package (in both .tar.gz and .zip
153     flavors) to help people who want to ship SCons as a stand-alone
154     build tool in their software packages.
155
156   - Prevent SCons from unlinking files in certain situations when
157     the -n option is used.
158
159   - Change the name of Tool/lib.py to Tool/mslib.py.
160
161   From Steven Knight and Anthony Roach:
162
163   - Man page:  document the fact that Builder calls return Node objects.
164
165   From Steve LeBlanc:
166
167   - Refactor option processing to use our own version of Greg Ward's
168     Optik module, modified to run under Python 1.5.2.
169
170   - Add a ParseConfig() command to modify an environment based on
171     parsing output from a *-config command.
172
173   From Jeff Petkau:
174
175   - Fix interpretation of '#/../foo' on Win32 systems.
176
177   From Anthony Roach:
178
179   - Fixed use of command lines with spaces in their arguments,
180     and use of Nodes with spaces in their string representation.
181
182   - Make access and modification times of files in a BuildDir match
183     the source file, even when hard linking isn't available.
184
185   - Make -U be case insensitive on Win32 systems.
186
187   - Issue a warning and continue when finding a corrupt .sconsign file.
188
189   - Fix using an alias as a dependency of a target so that if one of the
190     alias' dependencies gets rebuilt, the resulting target will, too.
191
192   - Fix differently ordered targets causing unnecessary rebuilds
193     on case insensitive systems.
194
195   - Use os.system() to execute external commands whenever the "env"
196     utility is available, which is much faster than fork()/exec(),
197     and fixes the -j option on several platforms.
198
199   - Fix use of -j with multiple targets.
200
201   - Add an Options() object for friendlier accomodation of command-
202     line arguments.
203
204   - Add support for Microsoft VC++ precompiled header (.pch) files,
205     debugger (.pdb) files, and resource (.rc) files.
206
207   - Don't compute the $_CPPINCFLAGS, $_F77INCFLAGS, $_LIBFLAGS and
208     $_LIBDIRFLAGS variables each time a command is executed, define
209     them so they're computed only as needed.  Add a new _concat
210     function to the Environment that allows people to define their
211     own similar variables.
212
213   - Fix dependency scans when $LIBS is overridden.
214
215   - Add EnsurePythonVersion() and EnsureSConsVersion() functions.
216
217   - Fix the overly-verbose stack trace on ListBuilder build errors.
218
219   - Add a SetContentSignatureType() function, allowing use of file
220     timestamps instead of MD5 signatures.
221
222   - Make -U and Default('source') fail gracefully.
223
224   - Allow the File() and Dir() methods to take a path-name string as
225     the starting directory, in addition to a Dir object.
226
227   - Allow the command handler to be selected via the SPAWN, SHELL
228     and ESCAPE construction variables.
229
230   - Allow construction variables to be overridden when a Builder
231     is called.
232
233   From sam th:
234
235   - Dynamically check for the existence of utilities with which to
236     initialize Environments by default.
237
238
239
240 RELEASE 0.08 - Mon, 15 Jul 2002 12:08:51 -0500
241
242   From Charles Crain:
243
244   - Fixed a bug with relative CPPPATH dirs when using BuildDir().
245     (Bug reported by Bob Summerwill.)
246
247   - Added a warnings framework and a --warn option to enable or
248     disable warnings.
249
250   - Make the C scanner warn users if files referenced by #include
251     directives cannot be found and --warn=dependency is specified.
252
253   - The BUILDERS construction variable should now be a dictionary
254     that maps builder names to actions.  Existing uses of lists,
255     and the Builder name= keyword argument, generate warnings
256     about use of deprecated features.
257
258   - Removed the "shared" keyword argument from the Object and
259     Library builders.
260     
261   - Added separated StaticObject, SharedObject, StaticLibrary and
262     SharedLibrary builders.  Made Object and Library synonyms for
263     StaticObject and StaticLibrary, respectively.
264
265   - Add LIBS and LIBPATH dependencies for shared libraries.
266
267   - Removed support for the prefix, suffix and src_suffix arguments
268     to Builder() to be callable functions.
269
270   - Fix handling file names with multiple dots.
271
272   - Allow a build directory to be outside of the SConstruct tree.
273
274   - Add a FindFile() function that searches for a file node with a
275     specified name.
276
277   - Add $CPPFLAGS to the shared-object command lines for g++ and gcc.
278
279   From Charles Crain and Steven Knight:
280
281   - Add a "tools=" keyword argument to Environment instantiation,
282     and a separate Tools() method, for more flexible specification
283     of tool-specific environment changes.
284
285   From Steven Knight:
286
287   - Add a "platform=" keyword argument to Environment instantiation,
288     and a separate Platform() method, for more flexible specification
289     of platform-specific environment changes.
290
291   - Updated README instructions and setup.py code to catch an
292     installation failure from not having distutils installed.
293
294   - Add descriptions to the -H help text for -D, -u and -U so
295     people can tell them apart.
296
297   - Remove the old feature of automatically splitting strings
298     of file names on white space.
299
300   - Add a dependency Scanner for native Fortran "include" statements,
301     using a new "F77PATH" construction variable.
302
303   - Fix C #include scanning to detect file names with characters like
304     '-' in them.
305
306   - Add more specific version / build output to the -v option.
307
308   - Add support for the GNU as, Microsoft masm, and nasm assemblers.
309
310   - Allow the "target" argument to a Builder call to be omitted, in
311     which case the target(s) are deduced from the source file(s) and the
312     Builder's specified suffix.
313
314   - Add a tar archive builder.
315
316   - Add preliminary support for the OS/2 Platform, including the icc
317     and ilink Tools.
318
319   From Jeff Petkau:
320
321   - Fix --implicit-cache if the scanner returns an empty list.
322
323   From Anthony Roach:
324
325   - Add a "multi" keyword argument to Builder creation that specifies
326     it's okay to call the builder multiple times for a target.
327
328   - Set a "multi" on Aliases so multiple calls will append to an Alias.
329
330   - Fix emitter functions' use of path names when using BuildDir or
331     in subdirectories.
332
333   - Fix --implicit-cache causing redundant rebuilds when the header
334     file list changed.
335
336   - Fix --implicit-cache when a file has no implicit dependencies and
337     its source is generated.
338
339   - Make the drive letters on Windows always be the same case, so that
340     changes in the case of drive letters don't cause a rebuild.
341
342   - Fall back to importing the SCons.TimeStamp module if the SCons.MD5
343     module can't be imported.
344
345   - Fix interrupt handling to guarantee that a single interrupt will
346     halt SCons both when using -j and not.
347
348   - Fix .sconsign signature storage so that output files of one build
349     can be safely used as input files to another build.
350
351   - Added a --debug=time option to print SCons execution times.
352
353   - Print an error message if a file can't be unlinked before being
354     built, rather than just silently terminating the build.
355
356   - Add a SideEffect() method that can be used to tell the build
357     engine that a given file is created as a side effect of building
358     a target.  A file can be specified as a side effect of more than
359     one build comand, in which case the commands will not be executed
360     simultaneously.
361
362   - Significant performance gains from not using our own version of
363     the inefficient stock os.path.splitext() method, caching source
364     suffix computation, code cleanup in MultiStepBuilder.__call__(),
365     and replicating some logic in scons_subst().
366
367   - Add --implicit-deps-changed and --implicit-deps-unchanged options.
368
369   - Add a GetLaunchDir() function.
370
371   - Add a SetBuildSignatureType() function.
372
373   From Zed Shaw:
374
375   - Add an Append() method to Environments, to append values to
376     construction variables.
377
378   - Change the name of Update() to Replace().  Keep Update() as a
379     deprecated synonym, at least for now.
380
381   From Terrel Shumway:
382
383   - Use a $PYTHON construction variable, initialized to sys.executable,
384     when using Python to build parts of the SCons packages.
385
386   - Use sys.prefix, not sys.exec_prefix, to find pdb.py.
387
388
389
390 RELEASE 0.07 - Thu,  2 May 2002 13:37:16 -0500
391
392   From Chad Austin:
393
394   - Changes to build SCons packages on IRIX (and other *NIces).
395
396   - Don't create a directory Node when a file already exists there,
397     and vice versa.
398
399   - Add 'dirs' and 'names' keyword arguments to SConscript for
400     easier specification of subsidiary SConscript files.
401
402   From Charles Crain:
403
404   - Internal cleanup of environment passing to function Actions.
405
406   - Builders can now take arbitrary keyword arguments to create
407     attributes to be passed to: command generator functions,
408     FunctionAction functions, Builder emitter functions (below),
409     and prefix/suffix generator functions (below).
410
411   - Command generator functions can now return ANYTHING that can be
412     converted into an Action (a function, a string, a CommandGenerator
413     instance, even an ActionBase instance).
414
415   - Actions now call get_contents() with the actual target and source
416     nodes used for the build.
417
418   - A new DictCmdGenerator class replaces CompositeBuilder to support
419     more flexible Builder behavior internally.
420
421   - Builders can now take an emitter= keyword argument.  An emitter
422     is a function that takes target, source, and env argument, then
423     return a 2-tuple of (new sources, new targets).  The emitter is
424     called when the Builder is __call__'ed, allowing a user to modify
425     source and target lists.
426
427   - The prefix, suffix and src_suffix Builder arguments now take a
428     callable as well a string.  The callable is passed the Environment
429     and any extra Builder keyword arguments and is expected to return
430     the appropriate prefix or suffix.
431
432   - CommandActions can now be a string, a list of command + argument
433     strings, or a list of commands (strings or lists).
434
435   - Added shared library support.  The Object and Library Builders now
436     take a "shared=1" keyword argument to specify that a shared object
437     or shared library should be built.  It is an error to try to build
438     static objects into a shared library or vice versa.
439
440   - Win32 support for .def files has been added.  Added the Win32-specific
441     construction variables $WIN32DEFPREFIX, $WIN32DEFSUFFIX,
442     $WIN32DLLPREFIX and $WIN32IMPLIBPREFIX.  When building a .dll,
443     the new construction variable $WIN32_INSERT_DEF, controls whether
444     the appropriately-named .def file is inserted into the target
445     list (if not already present).  A .lib file is always added to
446     a Library build if not present in the list of targets.
447
448   - ListBuilder now passes all targets to the action, not just the first.
449
450   - Fix so that -c now deletes generated yacc .h files.
451
452   - Builder actions and emitter functions can now be initialized, through
453     construction variables, to things other than strings.
454
455   - Make top-relative '#/dir' lookups work like '#dir'.
456
457   - Fix for relative CPPPATH directories in subsidiary SConscript files
458     (broken in 0.06).
459
460   - Add a for_signature argument to command generators, so that
461     generators that need to can return distinct values for the
462     command signature and for executing the command.
463
464   From Alex Jacques:
465
466   - Create a better scons.bat file from a py2bat.py script on the Python
467     mailing list two years ago (modeled after pl2bat.pl).
468
469   From Steven Knight:
470
471   - Fix so that -c -n does *not* remove the targets!
472
473   - Man page:  Add a hierarchical libraries + Program example.
474
475   - Support long MSVC linker command lines through a builder action
476     that writes to a temporary file and uses the magic MSVC "link @file"
477     argument syntax if the line is longer than 2K characters.
478
479   - Fix F77 command-line options on Win32 (use /Fo instead of -o).
480
481   - Use the same action to build from .c (lower case) and .C (upper
482     case) files on case-insensitive systems like Win32.
483
484   - Support building a PDF file directly from a TeX or LaTeX file
485     using pdftex or pdflatex.
486
487   - Add a -x option to runtest.py to specify the script being tested.
488     A -X option indicates it's an executable, not a script to feed
489     to the Python interpreter.
490
491   - Add a Split() function (identical to SCons.Util.argmunge()) for use
492     in the next release, when Builders will no longer automatically split
493     strings on white space.
494
495   From Steve Leblanc:
496
497   - Add the SConscriptChdir() method.
498
499   From Anthony Roach:
500
501   - Fix --debug=tree when used with directory targets.
502
503   - Significant internal restructuring of Scanners and Taskmaster.
504
505   - Added new --debug=dtree option.
506
507   - Fixes for --profile option.
508
509   - Performance improvement in construction variable substitution.
510
511   - Implemented caching of content signatures, plus added --max-drift
512     option to control caching.
513
514   - Implemented caching of dependency signatures, enabled by new
515     --implicit-cache option.
516
517   - Added abspath construction variable modifier.
518
519   - Added $SOURCE variable as a synonym for $SOURCES[0].
520
521   - Write out .sconsign files on error or interrupt so intermediate
522     build results are saved.
523
524   - Change the -U option to -D.  Make a new -U that builds just the
525     targets from the local SConscript file.
526
527   - Fixed use of sys.path so Python modules can be imported from
528     the SConscript directory.
529
530   - Fix for using Aliases with the -u, -U and -D options.
531
532   - Fix so that Nodes can be passed to SConscript files.
533
534   From Moshe Zadka:
535   
536   - Changes for official Debian packaging.
537
538
539
540 RELEASE 0.06 - Thu, 28 Mar 2002 01:24:29 -0600
541
542   From Charles Crain:
543
544   - Fix command generators to expand construction variables.
545
546   - Make FunctionAction arguments be Nodes, not strings.
547
548   From Stephen Kennedy:
549
550   - Performance:  Use a dictionary, not a list, for a Node's parents.
551
552   From Steven Knight:
553
554   - Add .zip files to the packages we build.
555
556   - Man page:  document LIBS, fix a typo, document ARGUMENTS.
557
558   - Added RANLIB and RANLIBFLAGS construction variables.  Only use them
559     in ARCOM if there's a "ranlib" program on the system.
560
561   - Add a configurable CFILESUFFIX for the Builder of .l and .y files
562     into C files.
563
564   - Add a CXXFile Builder that turns .ll and .yy files into .cc files
565     (configurable via a CXXFILESUFFIX construction variable).
566
567   - Use the POSIX-standard lex -t flag, not the GNU-specific -o flag.
568     (Bug reported by Russell Christensen.)
569
570   - Fixed an exception when CPPPATH or LIBPATH is a null string.
571     (Bug reported by Richard Kiss.)
572
573   - Add a --profile=FILE option to make profiling SCons easier.
574
575   - Modify the new DVI builder to create .dvi files from LaTeX (.ltx
576     and .latex) files.
577
578   - Add support for Aliases (phony targets).
579
580   - Add a WhereIs() method for searching for path names to executables.
581
582   - Add PDF and PostScript document builders.
583
584   - Add support for compiling Fortran programs from a variety of
585     suffixes (a la GNU Make):  .f, .F, .for, .FOR, .fpp and .FPP
586
587   - Support a CPPFLAGS variable on all default commands that use the
588     C preprocessor.
589
590   From Steve Leblanc:
591
592   - Add support for the -U option.
593
594   - Allow CPPPATH, LIBPATH and LIBS to be specified as white-space
595     separated strings.
596
597   - Add a document builder to create .dvi files from TeX (.tex) files.
598
599   From Anthony Roach:
600
601   - Fix:  Construction variables with values of 0 were incorrectly
602     interpolated as ''. 
603
604   - Support env['VAR'] to fetch construction variable values.
605
606   - Man page:  document Precious().
607
608
609
610 RELEASE 0.05 - Thu, 21 Feb 2002 16:50:03 -0600
611
612   From Chad Austin:
613
614   - Set PROGSUFFIX to .exe under Cygwin.
615
616   From Charles Crain:
617
618   - Allow a library to specified as a command-line source file, not just
619     in the LIBS construction variable.
620
621   - Compensate for a bug in os.path.normpath() that returns '' for './'
622     on WIN32.
623
624   - More performance optimizations:  cache #include lines from files,
625     eliminate unnecessary calls.
626
627   - If a prefix or suffix contains white space, treat the resulting
628     concatenation as separate arguments.
629
630   - Fix irregularities in the way we fetch DevStudio information from
631     the Windows registry, and in our registry error handling.
632
633   From Steven Knight:
634
635   - Flush stdout after print so it intermixes correctly with stderr
636     when redirected.
637
638   - Allow Scanners to return a list of strings, and document how to
639     write your own Scanners.
640
641   - Look up implicit (scanned) dependencies relative to the directory
642     of file being scanned.
643
644   - Make writing .sconsign files more robust by first trying to write
645     to a temp file that gets renamed.
646
647   - Create all of the directories for a list of targets before trying
648     to build any of the targets.
649
650   - WIN32 portability fixes in tests.
651
652   - Allow the list of variables exported to an SConscript file to be
653     a UserList, too.
654
655   - Document the overlooked LIBPATH construction variable.
656     (Bug reported by Eicke Godehardt.)
657
658   - Fix so that Ignore() ignores indirect, implicit dependencies
659     (included files), not just direct dependencies.
660
661   - Put the man page in the Debian distribution.
662
663   - Run HTML docs through tidy to clean up the HTML (for Konqueror).
664
665   - Add preliminary support for Unicode strings.
666
667   - Efficiency:  don't scan dependencies more than once during the
668     walk of a tree.
669
670   - Fix the -c option so it doesn't stop removing targets if one doesn't
671     already exist.
672     (Bug reported by Paul Connell.)
673
674   - Fix the --debug=pdb option when run on Windows NT.
675     (Bug reported by Paul Connell.)
676
677   - Add support for the -q option.
678
679   From Steve Leblanc:
680
681   - Add support for the -u option.
682
683   - Add .cc and .hh file suffixes to the C Scanner.
684
685   From Anthony Roach:
686
687   - Make the scons script return an error code on failures.
688
689   - Add support for using code to generate a command to build a target.
690
691
692
693 RELEASE 0.04 - Wed, 30 Jan 2002 11:09:42 -0600
694
695   From Charles Crain:
696
697   - Significant performance improvements in the Node.FS and
698     Scanner subsystems.
699
700   - Fix signatures of binary files on Win32 systems.
701
702   - Allow LIBS and LIBPATH to be strings, not just arrays.
703
704   - Print a traceback if a Python-function builder throws an exception.
705
706   From Steven Knight:
707
708   - Fix using a directory as a Default(), and allow Default() to
709     support white space in file names for strings in arrays.
710
711   - Man page updates:  corrected some mistakes, documented various
712     missing Environment methods, alphabetized the construction
713     variables and other functions, defined begin and end macros for
714     the example sections, regularized white space separation, fixed
715     the use of Export() in the Multiple Variants example.
716
717   - Function action fixes:  None is now a successful return value.
718     Exceptions are now reported.  Document function actions.
719
720   - Add 'Action' and 'Scanner' to the global keywords so SConscript
721     files can use them too.
722
723   - Removed the Wrapper class between Nodes and Walkers.
724
725   - Add examples using Library, LIBS, and LIBPATH.
726
727   - The C Scanner now always returns a sorted list of dependencies
728     so order changes don't cause unnecessary rebuilds.
729
730   - Strip $(-$) bracketed text from command lines.  Use this to
731     surround $_INCDIRS and $_LIBDIRS so we don't rebuild in response
732     to changes to -I or -L options.
733
734   - Add the Ignore() method to ignore dependencies.
735
736   - Provide an error message when a nonexistent target is specified
737     on the command line.
738
739   - Remove targets before building them, and add an Environment
740     Precious() method to override that.
741
742   - Eliminate redundant calls to the same builder when the target is a
743     list of targets:  Add a ListBuilder class that wraps Builders to
744     handle lists atomically.  Extend the Task class to support building
745     and updating multiple targets in a single Task.  Simplify the
746     interface between Task and Taskmaster.
747
748   - Add a --debug=pdb option to re-run SCons under the Python debugger.
749
750   - Only compute a build signature once for each node.
751
752   - Changes to our sys.path[] manipulation to support installation into
753     an arbitrary --prefix value.
754
755   From Steve Leblanc:
756
757   - Add var=value command-line arguments.
758
759
760
761 RELEASE 0.03 - Fri, 11 Jan 2002 01:09:30 -0600
762
763   From Charles Crain:
764
765   - Performance improvements in the Node.FS and Sig.Calculator classes.
766
767   - Add the InstallAs() method.
768
769   - Execute commands through an external interpreter (sh, cmd.exe, or
770     command.com) to handle redirection metacharacters.
771
772   - Allow the user to supply a command handler.
773
774   From Steven Knight:
775
776   - Search both /usr/lib and /usr/local/lib for scons directories by
777     adding them both to sys.path, with whichever is in sys.prefix first.
778
779   - Fix interpreting strings of multiple white-space separated file names
780     as separate file names, allowing prefixes and suffixes to be appended
781     to each individually.
782
783   - Refactor to move CompositeBuilder initialization logic from the
784     factory wrapper to the __init__() method, and allow a Builder to
785     have both an action and a src_builder (or array of them).
786
787   - Refactor BuilderBase.__call__() to separate Node creation/lookup
788     from initialization of the Node's builder information.
789
790   - Add a CFile Builder object that supports turning lex (.l) and
791     yacc (.y) files into .c files.
792
793   - Document: variable interpretation attributes; how to propogate
794     the user's environment variables to executed commands; how to
795     build variants in multiple BuildDirs.
796
797   - Collect String, Dict, and List type-checking in common utility
798     routines so we can accept User{String,Dict,List}s all over.
799
800   - Put the Action factory and classes into their own module.
801
802   - Use one CPlusPlusAction in the Object Builder's action dictionary,
803     instead of letting it create multiple identical instances.
804
805   - Document the Install() and InstallAs() methods.
806
807   From Steve Leblanc:
808
809   - Require that a Builder be given a name argument, supplying a
810     useful error message when it isn't.
811
812   From Anthony Roach:
813
814   - Add a "duplicate" keyword argument to BuildDir() that can be set
815     to prevent linking/copying source files into build directories.
816
817   - Add a "--debug=tree" option to print an ASCII dependency tree.
818
819   - Fetch the location of the Microsoft Visual C++ compiler(s) from
820     the Registry, instead of hard-coding the location.
821     
822   - Made Scanner objects take Nodes, not path names.
823     
824   - Have the C Scanner cache the #include file names instead of
825     (re-)scanning the file each time it's called.
826
827   - Created a separate class for parent "nodes" of file system roots,
828     eliminating the need for separate is-parent-null checks everywhere.
829     
830   - Removed defined __hash__() and __cmp() methods from FS.Entry, in
831     favor of Python's more efficient built-in identity comparisons.
832
833
834
835 RELEASE 0.02 - Sun, 23 Dec 2001 19:05:09 -0600
836
837   From Charles Crain:
838
839   - Added the Install(), BuildDir(), and Export() methods.
840
841   - Fix the -C option by delaying setting the top of the FS tree.
842
843   - Avoid putting the directory path on the libraries in the LIBS
844     construction variable.
845
846   - Added a GetBuildPath() method to return the full path to the
847     Node for a specified string.
848
849   - Fixed variable substitution in CPPPATH and LIBPATH.
850
851   From Steven Knight:
852
853   - Fixed the version comment in the scons.bat (the UNIX geek used
854     # instead of @rem).
855
856   - Fix to setup.py so it doesn't require a sys.argv[1] argument.
857
858   - Provide make-like warning message for "command not found" and
859     similar errors.
860
861   - Added an EXAMPLES section to the man page.
862
863   - Make Default() targets properly relative to their SConscript
864     file's subdirectory.
865
866   From Anthony Roach:
867
868   - Documented CXXFLAGS, CXXCOM, and CPPPATH.
869
870   - Fixed SCONS_LIB_DIR to work as documented.
871
872   - Made Default() accept Nodes as arguments.
873
874   - Changed Export() to make it easier to use.
875   
876   - Added the Import() and Return() methods.
877
878
879
880 RELEASE 0.01 - Thu Dec 13 19:25:23 CST 2001
881
882 A brief overview of important functionality available in release 0.01:
883
884   - C and C++ compilation on POSIX and Windows NT.
885
886   - Automatic scanning of C/C++ source files for #include dependencies.
887
888   - Support for building libraries; setting construction variables
889     allows creation of shared libraries.
890
891   - Library and C preprocessor search paths.
892
893   - File changes detected using MD5 signatures.
894
895   - User-definable Builder objects for building files.
896
897   - User-definable Scanner objects for scanning for dependencies.
898
899   - Parallel build (-j) support.
900
901   - Dependency cycles detected.
902
903   - Linux packages available in RPM and Debian format.
904
905   - Windows installer available.