Add a QT tool. (Christoph Wiedemann)
[scons.git] / src / CHANGES.txt
1 # __COPYRIGHT__
2 # __FILE__ __REVISION__ __DATE__ __DEVELOPER__
3
4
5                  SCons - a software construction tool
6
7                             Change Log
8
9
10
11 RELEASE 0.XX - XXX
12
13   From Chad Austin:
14
15   - Support specifying a list of tools when calling Environment.Copy().
16
17   - Give a Value Nodes a timestamp of the system time when they're
18     created, so they'll work when using timestamp-based signatures.
19
20   - Add a DefaultEnvironment() function that only creates a default
21     environment on-demand (for fetching source files, e.g.).
22
23   - Portability fix for test/M4.py.
24
25   From Steven Knight:
26
27   - Tighten up the scons -H help output.
28
29   - When the input yacc file ends in .yy and the -d flag is specified,
30     recognize that a .hpp file (not a .h file) will be created.
31
32   - Make builder prefixes work correctly when deducing a target
33     from a source file name in another directory.
34
35   - Documentation fixes:  typo in the man page.
36
37   - Use "cvs co -d" instead of "cvs co -p >" when checking out something
38     from CVS with a specified module name.  This avoids zero-length
39     files when there is a checkout error.
40
41   - Add an "sconsign" script to print the contents of .sconsign files.
42
43   - Speed up maintaining the various lists of Node children by using
44     dictionaries to avoid "x in list" searches.
45
46   - Cache the computed list of Node children minus those being Ignored
47     so it's only calculated once.
48
49   - Fix use of the --cache-show option when building a Program()
50     (or using any other arbitrary action) by making sure all Action
51     instances have strfunction() methods.
52
53   From Gary Oberbrunner:
54
55   - Report the target being built in error messages when building
56     multiple sources from different extensions, or when the target file
57     extension can't be deduced, or when we don't have an action for a
58     file suffix.
59
60   - Provide helpful error messages when the arguments to env.Install()
61     are incorrect.
62
63   - Fix the value returned by the Node.prevsiginfo() method to conform
64     to a previous change when checking whether a node is current.
65
66   From Laurent Pelecq:
67
68   - When the -debug=pdb option is specified, use pdb.Pdb().runcall() to
69     call pdb directly, don't call Python recursively.
70
71   From Christoph Wiedemann:
72
73   - Have the g++ Tool actually use g++ in preference to c++.
74
75   - Have the gcc Tool actually use gcc in preference to cc.
76
77   - Add a gnutools.py test of the GNU tool chain.
78
79   - Be smarter about linking: use $CC by default and $CXX only if we're
80     linking with any C++ objects.
81
82   - Avoid SCons hanging when a piped command has a lot of output to read.
83
84   - Add QT support for preprocessing .ui files into .c files.
85
86
87
88 RELEASE 0.90 - Wed, 25 Jun 2003 14:24:52 -0500
89
90   From Chad Austin:
91
92   - Fix the _concat() documentation, and add a test for it.
93
94   - Portability fixes for non-GNU versions of lex and yacc.
95
96   From Matt Balvin:
97
98   - Fix handling of library prefixes when the subdirectory matches
99     the prefix.
100
101   From Timothee Bessett:
102
103   - Add an M4 Builder.
104
105   From Charles Crain:
106
107   - Use '.lnk' as the suffix on the temporary file for linking long
108     command lines (necessary for the Phar Lap linkloc linker).
109
110   - Save non-string Options values as their actual type.
111
112   - Save Options string values that contain a single quote correctly.
113
114   - Save any Options values that are changed from the default
115     Environment values, not just ones changed on the command line or in
116     an Options file.
117
118   - Make closing the Options file descriptor exception-safe.
119
120   From Steven Knight:
121
122   - SCons now enforces (with an error) that construction variables
123     must have the same form as valid Python identifiers.
124
125   - Fix man page bugs: remove duplicate AddPostAction() description;
126     document no_import_lib; mention that CPPFLAGS does not contain
127     $_CPPINCFLAGS; mention that F77FLAGS does not contain $_F77INCFLAGS;
128     mention that LINKFLAGS and SHLINKFLAGS contains neither $_LIBFLAGS
129     nor $_LIBDIRFLAGS.
130
131   - Eliminate a dependency on the distutils.fancy_getopt module by
132     copying and pasting its wrap_text() function directly.
133
134   - Make the Script.Options() subclass match the underlying base class
135     implementation.
136
137   - When reporting a target is up to date, quote the target like make
138     (backquote-quote) instead of with double quotes.
139
140   - Fix handling of ../* targets when using -U, -D or -u.
141
142   From Steve Leblanc:
143
144   - Don't update the .sconsign files when run with -n.
145
146   From Gary Oberbrunner:
147
148   - Add support for the Intel C Compiler (icl.exe).
149
150   From Anthony Roach
151
152   - Fix Import('*').
153
154   From David Snopek
155
156   - Fix use of SConf in paths with white space in them.
157
158   - Add CheckFunc and CheckType functionality to SConf.
159
160   - Fix use of SConf with Builders that return a list of nodes.
161
162   From David Snopek and Christoph Wiedemann
163
164   - Fix use of the SConf subsystem with SConscriptChdir().
165
166   From Greg Spencer
167
168   - Check for the existence of MS Visual Studio on disk before using it,
169     to avoid getting fooled by leftover junk in the registry.
170
171   - Add support for MSVC++ .NET.
172
173   - Add support for MS Visual Studio project files (DSP, DSW,
174     SLN and VCPROJ files).
175
176   From Christoph Wiedemann
177
178   - SConf now works correctly when the -n and -q options are used.
179
180
181
182 RELEASE 0.14 - Wed, 21 May 2003 05:16:32 -0500
183
184   From Chad Austin:
185
186   - Use .dll (not .so) for shared libraries on Cygwin; use -fPIC
187     when compiling them.
188
189   - Use 'rm' to remove files under Cygwin.
190
191   - Add a PLATFORM variable to construction environments.
192
193   - Remove the "platform" argument from tool specifications.
194
195   - Propogate PYTHONPATH when running the regression tests so distutils
196     can be found in non-standard locations.
197
198   - Using MSVC long command-line linking when running Cygwin.
199
200   - Portability fixes for a lot of tests.
201
202   - Add a Value Node class for dependencies on in-core Python values.
203
204   From Allen Bierbaum:
205
206   - Pass an Environment to the Options validator method, and
207     add an Options.Save() method.
208
209   From Steve Christensen:
210
211   - Add an optional sort function argument to the GenerateHelpText()
212     Options function.
213
214   - Evaluate the "varlist" variables when computing the signature of a
215     function action.
216
217   From Charles Crain:
218
219   - Parse the source .java files for class names (including inner class
220     names) to figure out the target .class files that will be created.
221
222   - Make Java support work with Repositories and SConscriptChdir(0).
223
224   - Pass Nodes, not strings, to Builder emitter functions.
225
226   - Refactor command-line interpolation and signature calculation
227     so we can use real Node attributes.
228
229   From Steven Knight:
230
231   - Add Java support (javac, javah, jar and rmic).
232
233   - Propagate the external SYSTEMROOT environment variable into ENV on
234     Win32 systems, so external commands that use sockets will work.
235
236   - Add a .posix attribute to PathList expansions.
237
238   - Check out CVS source files using POSIX path names (forward slashes
239     as separators) even on Win32.
240
241   - Add Node.clear() and Node.FS.Entry.clear() methods to wipe out a
242     Node's state, allowing it to be re-evaluated by continuous
243     integration build interfaces.
244
245   - Change the name of the Set{Build,Content}SignatureType() functions
246     to {Target,Source}Signatures().  Deprecate the old names but support
247     them for backwards compatibility.
248
249   - Add internal SCons.Node.FS.{Dir,File}.Entry() methods.
250
251   - Interpolate the null string if an out-of-range subscript is used
252     for a construction variable.
253
254   - Fix the internal Link function so that it properly links or copies
255     files in subsidiary BuildDir directories.
256
257   - Refactor the internal representation of a single execution instance
258     of an action to eliminate redundant signature calculations.
259
260   - Eliminate redundant signature calculations for Nodes.
261
262   - Optimize out calling hasattr() before accessing attributes.
263
264   - Say "Cleaning targets" (not "Building...") when the -c option is
265     used.
266
267   From Damyan Pepper:
268
269   - Quote the "Entering directory" message like Make.
270
271   From Stefan Reichor:
272
273   - Add support for using Ghostscript to convert Postscript to PDF files.
274
275   From Anthony Roach:
276
277   - Add a standalone "Alias" function (separate from an Environment).
278
279   - Make Export() work for local variables.
280
281   - Support passing a dictionary to Export().
282
283   - Support Import('*') to import everything that's been Export()ed.
284
285   - Fix an undefined exitvalmap on Win32 systems.
286
287   - Support new SetOption() and GetOption() functions for setting
288     various command-line options from with an SConscript file.
289
290   - Deprecate the old SetJobs() and GetJobs() functions in favor of
291     using the new generic {Set,Get}Option() functions.
292
293   - Fix a number of tests that searched for a Fortran compiler using the
294     external PATH instead of what SCons would use.
295
296   - Fix the interaction of SideEffect() and BuildDir() so that (for
297     example) PDB files get put correctly in a BuildDir().
298
299   From David Snopek:
300
301   - Contribute the "Autoscons" code for Autoconf-like checking for
302     the existence of libraries, header files and the like.
303
304   - Have the Tool() function add the tool name to the $TOOLS
305     construction variable.
306
307   From Greg Spencer:
308
309   - Support the C preprocessor #import statement.
310
311   - Allow the SharedLibrary() Builder on Win32 systems to be able to
312     register a newly-built dll using regsvr32.
313
314   - Add a Builder for Windows type library (.tlb) files from IDL files.
315
316   - Add an IDL scanner.
317
318   - Refactor the Fortran, C and IDL scanners to share common logic.
319
320   - Add .srcpath and .srcdir attributes to $TARGET and $SOURCE.
321
322   From Christoph Wiedemann:
323
324   - Integrate David Snopek's "Autoscons" code as the new SConf
325     configuration subsystem, including caching of values between
326     runs (using normal SCons dependency mechanisms), tests, and
327     documentation.
328
329
330
331 RELEASE 0.13 - Mon, 31 Mar 2003 20:22:00 -0600
332
333   From Charles Crain:
334
335   - Fix a bug when BuildDir(duplicate=0) is used and SConscript
336     files are called from within other SConscript files.
337
338   - Support (older) versions of Perforce which don't set the Windows
339     registry.
340
341
342
343 RELEASE 0.12 - Thu, 27 Mar 2003 23:52:09 -0600
344
345   From Charles Crain:
346
347   - Added support for the Perforce source code management system.
348
349   - Fix str(Node.FS) so that it returns a path relative to the calling
350     SConscript file's directory, not the top-level directory.
351
352   - Added support for a separate src_dir argument to SConscript()
353     that allows explicit specification of where the source files
354     for an SConscript file can be found.
355
356   - Support more easily re-usable flavors of command generators by
357     calling callable variables when strings are expanded.
358
359   From Steven Knight:
360
361   - Added an INSTALL construction variable that can be set to a function
362     to control how the Install() and InstallAs() Builders install files.
363     The default INSTALL function now copies, not links, files.
364
365   - Remove deprecated features:  the "name" argument to Builder objects,
366     and the Environment.Update() method.
367
368   - Add an Environment.SourceCode() method to support fetching files
369     from source code systems.  Add factory methods that create Builders
370     to support BitKeeper, CVS, RCS, and SCCS.  Add support for fetching
371     files from RCS or SCCS transparently (like GNU Make).
372
373   - Make the internal to_String() function more efficient.
374
375   - Make the error message the same as other build errors when there's a
376     problem unlinking a target file in preparation for it being built.
377
378   - Make TARGET, TARGETS, SOURCE and SOURCES reserved variable names and
379     warn if the user tries to set them in a construction environment.
380
381   - Add support for Tar and Zip files.
382
383   - Better documentation of the different ways to export variables to a
384     subsidiary SConscript file.  Fix documentation bugs in a tools
385     example, places that still assumed SCons split strings on white
386     space, and typos.
387
388   - Support fetching arbitrary files from the TARGETS or SOURCES lists
389     (e.g. ${SOURCES[2]}) when calculating the build signature of a
390     command.
391
392   - Don't silently swallow exceptions thrown by Scanners (or other
393     exceptions while finding a node's dependent children).
394
395   - Push files to CacheDir() before calling the superclass built()
396     method (which may clear the build signature as part of clearing
397     cached implicit dependencies, if the file has a source scanner).
398     (Bug reported by Jeff Petkau.)
399
400   - Raise an internal error if we attempt to push a file to CacheDir()
401     with a build signature of None.
402
403   - Add an explicit Exit() function for terminating early.
404
405   - Change the documentation to correctly describe that the -f option
406     doesn't change to the directory in which the specified file lives.
407     
408   - Support changing directories locally with SConscript directory
409     path names relative to any SConstruct file specified with -f.
410     This allows you to build in another directory by simply changing
411     there and pointing at the SConstruct file in another directory.
412
413   - Change the default SConscriptChdir() behavior to change to the
414     SConscript directory while it's being read.
415
416   - Fix an exception thrown when the -U option was used with no
417     Default() target specified.
418
419   - Fix -u so that it builds things in corresponding build directories
420     when used in a source directory.
421
422   From Lachlan O'Dea:
423
424   - Add SharedObject() support to the masm tool.
425
426   - Fix WhereIs() to return normalized paths.
427
428   From Jeff Petkau:
429
430   - Don't copy a built file to a CacheDir() if it's already there.
431
432   - Avoid partial copies of built files in a CacheDir() by copying
433     to a temporary file and renaming.
434
435   From Anthony Roach:
436
437   - Fix incorrect dependency-cycle errors when an Aliased source doesn't
438     exist.
439
440
441
442 RELEASE 0.11 - Tue, 11 Feb 2003 05:24:33 -0600
443
444   From Chad Austin:
445
446   - Add support for IRIX and the SGI MIPSPro tool chain.
447
448   - Support using the MSVC tool chain when running Cygwin Python.
449
450   From Michael Cook:
451
452   - Avoid losing signal bits in the exit status from a command,
453     helping terminate builds on interrupt (CTRL+C).
454
455   From Charles Crain:
456
457   - Added new AddPreAction() and AddPostAction() functions that support
458     taking additional actions before or after building specific targets.
459
460   - Add support for the PharLap ETS tool chain.
461
462   From Steven Knight:
463
464   - Allow Python function Actions to specify a list of construction
465     variables that should be included in the Action's signature.
466
467   - Allow libraries in the LIBS variable to explicitly include the prefix
468     and suffix, even when using the GNU linker.
469     (Bug reported by Neal Becker.)
470
471   - Use DOS-standard CR-LF line endings in the scons.bat file.
472     (Bug reported by Gary Ruben.)
473
474   - Doc changes:  Eliminate description of deprecated "name" keyword
475     argument from Builder definition (reported by Gary Ruben).
476
477   - Support using env.Append() on BUILDERS (and other dictionaries).
478     (Bug reported by Bj=F6rn Bylander.)
479
480   - Setting the BUILDERS construction variable now properly clears
481     the previous Builder attributes from the construction Environment.
482     (Bug reported by Bj=F6rn Bylander.)
483
484   - Fix adding a prefix to a file when the target isn't specified.
485     (Bug reported by Esa Ilari Vuokko.)
486
487   - Clean up error messages from problems duplicating into read-only
488     BuildDir directories or into read-only files.
489
490   - Add a CommandAction.strfunction() method, and add an "env" argument
491     to the FunctionAction.strfunction() method, so that all Action
492     objects have strfunction() methods, and the functions for building
493     and returning a string both take the same arguments.
494
495   - Add support for new CacheDir() functionality to share derived files
496     between builds, with related options --cache-disable, --cache-force,
497     and --cache-show.
498
499   - Change the default behavior when no targets are specified to build
500     everything in the current directory and below (like Make).  This
501     can be disabled by specifying Default(None) in an SConscript.
502
503   - Revamp SCons installation to fix a case-sensitive installation
504     on Win32 systems, and to add SCons-specific --standard-lib,
505     --standalone-lib, and --version-lib options for easier user
506     control of where the libraries get installed.
507
508   - Fix the ability to directly import and use Platform and Tool modules
509     that have been implicitly imported into an Environment().
510
511   - Add support for allowing an embedding interface to annotate a node
512     when it's created.
513
514   - Extend the SConscript() function to accept build_dir and duplicate
515     keyword arguments that function like a BuildDir() call.
516
517   From Steve Leblanc:
518
519   - Fix the output of -c -n when directories are involved, so it
520     matches -c.
521
522   From Anthony Roach:
523
524   - Use a different shared object suffix (.os) when using gcc so shared
525     and static objects can exist side-by-side in the same directory.
526
527   - Allow the same object files on Win32 to be linked into either
528     shared or static libraries.
529
530   - Cache implicit cache values when using --implicit-cache.
531
532
533
534 RELEASE 0.10 - Thu, 16 Jan 2003 04:11:46 -0600
535
536   From Derrick 'dman' Hudson:
537
538   - Support Repositories on other file systems by symlinking or
539     copying files when hard linking won't work.
540
541   From Steven Knight:
542
543   - Remove Python bytecode (*.pyc) files from the scons-local packages.
544
545   - Have FunctionActions print a description of what they're doing
546     (a representation of the Python call).
547
548   - Fix the Install() method so that, like other actions, it prints
549     what would have happened when the -n option is used.
550
551   - Don't create duplicate source files in a BuildDir when the -n
552     option is used.
553
554   - Refactor the Scanner interface to eliminate unnecessary Scanner
555     calls and make it easier to write efficient scanners.
556
557   - Added a "recursive" flag to Scanner creation that specifies the
558     Scanner should be invoked recursively on dependency files returned
559     by the scanner.
560
561   - Significant performance improvement from using a more efficient
562     check, throughout the code, for whether a Node has a Builder.
563
564   - Fix specifying only the source file to MultiStepBuilders such as
565     the Program Builder.  (Bug reported by Dean Bair.)
566
567   - Fix an exception when building from a file with the same basename as
568     the subdirectory in which it lives.  (Bug reported by Gerard Patel.)
569
570   - Fix automatic deduction of a target file name when there are
571     multiple source files specified; the target is now deduced from just
572     the first source file in the list.
573
574   - Documentation fixes: better initial explanation of SConscript files;
575     fix a misformatted "table" in the StaticObject explanation.
576
577   From Steven Knight and Steve Leblanc:
578
579   - Fix the -c option so it will remove symlinks.
580
581   From Steve Leblanc:
582
583   - Add a Clean() method to support removing user-specified targets
584     when using the -c option.
585
586   - Add a development script for running SCons through PyChecker.
587
588   - Clean up things found by PyChecker (mostly unnecessary imports).
589
590   - Add a script to use HappyDoc to create HTML class documentation.
591
592   From Lachlan O'Dea:
593
594   - Make the Environment.get() method return None by default.
595
596   From Anthony Roach:
597
598   - Add SetJobs() and GetJobs() methods to allow configuration of the
599     number of default jobs (still overridden by -j).
600
601   - Convert the .sconsign file format from ASCII to a pickled Python
602     data structure.
603
604   - Error message cleanups:  Made consistent the format of error
605     messages (now all start with "scons: ***") and warning messages (now
606     all start with "scons: warning:").  Caught more cases with the "Do
607     not know how to build" error message.
608
609   - Added support for the MinGW tool chain.
610
611   - Added a --debug=includes option.
612
613
614
615 RELEASE 0.09 - Thu,  5 Dec 2002 04:48:25 -0600
616
617   From Chad Austin:
618
619   - Add a Prepend() method to Environments, to append values to
620     the beginning of construction variables.
621
622   From Matt Balvin:
623
624   - Add long command-line support to the "lib" Tool (Microsoft library
625     archiver), too.
626
627   From Charles Crain:
628
629   - Allow $$ in a string to be passed through as $.
630
631   - Support file names with odd characters in them.
632
633   - Add support for construction variable substition on scanner
634     directories (in CPPPATH, F77PATH, LIBPATH, etc.).
635
636   From Charles Crain and Steven Knight:
637
638   - Add Repository() functionality, including the -Y option.
639
640   From Steven Knight:
641
642   - Fix auto-deduction of target names so that deduced targets end
643     up in the same subdirectory as the source.
644
645   - Don't remove source files specified on the command line!
646
647   - Suport the Intel Fortran Compiler (ifl.exe).
648
649   - Supply an error message if there are no command-line or
650     Default() targets specified.
651
652   - Fix the ASPPCOM values for the GNU assembler.
653     (Bug reported by Brett Polivka.)
654
655   - Fix an exception thrown when a Default() directory was specified
656     when using the -U option.
657
658   - Issue a warning when -c can't remove a target.
659
660   - Eliminate unnecessary Scanner calls by checking for the
661     existence of a file before scanning it.  (This adds a generic
662     hook to check an arbitrary condition before scanning.)
663
664   - Add explicit messages to tell when we're "Reading SConscript files
665     ...," "done reading SConscript files," "Building targets," and
666     "done building targets."  Add a -Q option to supress these.
667
668   - Add separate $SHOBJPREFIX and $SHOBJSUFFIX construction variables
669     (by default, the same as $OBJPREFIX and $OBJSUFFIX).
670
671   - Add Make-like error messages when asked to build a source file,
672     and before trying to build a file that doesn't have all its source
673     files (including when an invalid drive letter is used on WIN32).
674
675   - Add an scons-local-{version} package (in both .tar.gz and .zip
676     flavors) to help people who want to ship SCons as a stand-alone
677     build tool in their software packages.
678
679   - Prevent SCons from unlinking files in certain situations when
680     the -n option is used.
681
682   - Change the name of Tool/lib.py to Tool/mslib.py.
683
684   From Steven Knight and Anthony Roach:
685
686   - Man page:  document the fact that Builder calls return Node objects.
687
688   From Steve LeBlanc:
689
690   - Refactor option processing to use our own version of Greg Ward's
691     Optik module, modified to run under Python 1.5.2.
692
693   - Add a ParseConfig() command to modify an environment based on
694     parsing output from a *-config command.
695
696   From Jeff Petkau:
697
698   - Fix interpretation of '#/../foo' on Win32 systems.
699
700   From Anthony Roach:
701
702   - Fixed use of command lines with spaces in their arguments,
703     and use of Nodes with spaces in their string representation.
704
705   - Make access and modification times of files in a BuildDir match
706     the source file, even when hard linking isn't available.
707
708   - Make -U be case insensitive on Win32 systems.
709
710   - Issue a warning and continue when finding a corrupt .sconsign file.
711
712   - Fix using an alias as a dependency of a target so that if one of the
713     alias' dependencies gets rebuilt, the resulting target will, too.
714
715   - Fix differently ordered targets causing unnecessary rebuilds
716     on case insensitive systems.
717
718   - Use os.system() to execute external commands whenever the "env"
719     utility is available, which is much faster than fork()/exec(),
720     and fixes the -j option on several platforms.
721
722   - Fix use of -j with multiple targets.
723
724   - Add an Options() object for friendlier accomodation of command-
725     line arguments.
726
727   - Add support for Microsoft VC++ precompiled header (.pch) files,
728     debugger (.pdb) files, and resource (.rc) files.
729
730   - Don't compute the $_CPPINCFLAGS, $_F77INCFLAGS, $_LIBFLAGS and
731     $_LIBDIRFLAGS variables each time a command is executed, define
732     them so they're computed only as needed.  Add a new _concat
733     function to the Environment that allows people to define their
734     own similar variables.
735
736   - Fix dependency scans when $LIBS is overridden.
737
738   - Add EnsurePythonVersion() and EnsureSConsVersion() functions.
739
740   - Fix the overly-verbose stack trace on ListBuilder build errors.
741
742   - Add a SetContentSignatureType() function, allowing use of file
743     timestamps instead of MD5 signatures.
744
745   - Make -U and Default('source') fail gracefully.
746
747   - Allow the File() and Dir() methods to take a path-name string as
748     the starting directory, in addition to a Dir object.
749
750   - Allow the command handler to be selected via the SPAWN, SHELL
751     and ESCAPE construction variables.
752
753   - Allow construction variables to be overridden when a Builder
754     is called.
755
756   From sam th:
757
758   - Dynamically check for the existence of utilities with which to
759     initialize Environments by default.
760
761
762
763 RELEASE 0.08 - Mon, 15 Jul 2002 12:08:51 -0500
764
765   From Charles Crain:
766
767   - Fixed a bug with relative CPPPATH dirs when using BuildDir().
768     (Bug reported by Bob Summerwill.)
769
770   - Added a warnings framework and a --warn option to enable or
771     disable warnings.
772
773   - Make the C scanner warn users if files referenced by #include
774     directives cannot be found and --warn=dependency is specified.
775
776   - The BUILDERS construction variable should now be a dictionary
777     that maps builder names to actions.  Existing uses of lists,
778     and the Builder name= keyword argument, generate warnings
779     about use of deprecated features.
780
781   - Removed the "shared" keyword argument from the Object and
782     Library builders.
783     
784   - Added separated StaticObject, SharedObject, StaticLibrary and
785     SharedLibrary builders.  Made Object and Library synonyms for
786     StaticObject and StaticLibrary, respectively.
787
788   - Add LIBS and LIBPATH dependencies for shared libraries.
789
790   - Removed support for the prefix, suffix and src_suffix arguments
791     to Builder() to be callable functions.
792
793   - Fix handling file names with multiple dots.
794
795   - Allow a build directory to be outside of the SConstruct tree.
796
797   - Add a FindFile() function that searches for a file node with a
798     specified name.
799
800   - Add $CPPFLAGS to the shared-object command lines for g++ and gcc.
801
802   From Charles Crain and Steven Knight:
803
804   - Add a "tools=" keyword argument to Environment instantiation,
805     and a separate Tools() method, for more flexible specification
806     of tool-specific environment changes.
807
808   From Steven Knight:
809
810   - Add a "platform=" keyword argument to Environment instantiation,
811     and a separate Platform() method, for more flexible specification
812     of platform-specific environment changes.
813
814   - Updated README instructions and setup.py code to catch an
815     installation failure from not having distutils installed.
816
817   - Add descriptions to the -H help text for -D, -u and -U so
818     people can tell them apart.
819
820   - Remove the old feature of automatically splitting strings
821     of file names on white space.
822
823   - Add a dependency Scanner for native Fortran "include" statements,
824     using a new "F77PATH" construction variable.
825
826   - Fix C #include scanning to detect file names with characters like
827     '-' in them.
828
829   - Add more specific version / build output to the -v option.
830
831   - Add support for the GNU as, Microsoft masm, and nasm assemblers.
832
833   - Allow the "target" argument to a Builder call to be omitted, in
834     which case the target(s) are deduced from the source file(s) and the
835     Builder's specified suffix.
836
837   - Add a tar archive builder.
838
839   - Add preliminary support for the OS/2 Platform, including the icc
840     and ilink Tools.
841
842   From Jeff Petkau:
843
844   - Fix --implicit-cache if the scanner returns an empty list.
845
846   From Anthony Roach:
847
848   - Add a "multi" keyword argument to Builder creation that specifies
849     it's okay to call the builder multiple times for a target.
850
851   - Set a "multi" on Aliases so multiple calls will append to an Alias.
852
853   - Fix emitter functions' use of path names when using BuildDir or
854     in subdirectories.
855
856   - Fix --implicit-cache causing redundant rebuilds when the header
857     file list changed.
858
859   - Fix --implicit-cache when a file has no implicit dependencies and
860     its source is generated.
861
862   - Make the drive letters on Windows always be the same case, so that
863     changes in the case of drive letters don't cause a rebuild.
864
865   - Fall back to importing the SCons.TimeStamp module if the SCons.MD5
866     module can't be imported.
867
868   - Fix interrupt handling to guarantee that a single interrupt will
869     halt SCons both when using -j and not.
870
871   - Fix .sconsign signature storage so that output files of one build
872     can be safely used as input files to another build.
873
874   - Added a --debug=time option to print SCons execution times.
875
876   - Print an error message if a file can't be unlinked before being
877     built, rather than just silently terminating the build.
878
879   - Add a SideEffect() method that can be used to tell the build
880     engine that a given file is created as a side effect of building
881     a target.  A file can be specified as a side effect of more than
882     one build comand, in which case the commands will not be executed
883     simultaneously.
884
885   - Significant performance gains from not using our own version of
886     the inefficient stock os.path.splitext() method, caching source
887     suffix computation, code cleanup in MultiStepBuilder.__call__(),
888     and replicating some logic in scons_subst().
889
890   - Add --implicit-deps-changed and --implicit-deps-unchanged options.
891
892   - Add a GetLaunchDir() function.
893
894   - Add a SetBuildSignatureType() function.
895
896   From Zed Shaw:
897
898   - Add an Append() method to Environments, to append values to
899     construction variables.
900
901   - Change the name of Update() to Replace().  Keep Update() as a
902     deprecated synonym, at least for now.
903
904   From Terrel Shumway:
905
906   - Use a $PYTHON construction variable, initialized to sys.executable,
907     when using Python to build parts of the SCons packages.
908
909   - Use sys.prefix, not sys.exec_prefix, to find pdb.py.
910
911
912
913 RELEASE 0.07 - Thu,  2 May 2002 13:37:16 -0500
914
915   From Chad Austin:
916
917   - Changes to build SCons packages on IRIX (and other *NIces).
918
919   - Don't create a directory Node when a file already exists there,
920     and vice versa.
921
922   - Add 'dirs' and 'names' keyword arguments to SConscript for
923     easier specification of subsidiary SConscript files.
924
925   From Charles Crain:
926
927   - Internal cleanup of environment passing to function Actions.
928
929   - Builders can now take arbitrary keyword arguments to create
930     attributes to be passed to: command generator functions,
931     FunctionAction functions, Builder emitter functions (below),
932     and prefix/suffix generator functions (below).
933
934   - Command generator functions can now return ANYTHING that can be
935     converted into an Action (a function, a string, a CommandGenerator
936     instance, even an ActionBase instance).
937
938   - Actions now call get_contents() with the actual target and source
939     nodes used for the build.
940
941   - A new DictCmdGenerator class replaces CompositeBuilder to support
942     more flexible Builder behavior internally.
943
944   - Builders can now take an emitter= keyword argument.  An emitter
945     is a function that takes target, source, and env argument, then
946     return a 2-tuple of (new sources, new targets).  The emitter is
947     called when the Builder is __call__'ed, allowing a user to modify
948     source and target lists.
949
950   - The prefix, suffix and src_suffix Builder arguments now take a
951     callable as well a string.  The callable is passed the Environment
952     and any extra Builder keyword arguments and is expected to return
953     the appropriate prefix or suffix.
954
955   - CommandActions can now be a string, a list of command + argument
956     strings, or a list of commands (strings or lists).
957
958   - Added shared library support.  The Object and Library Builders now
959     take a "shared=1" keyword argument to specify that a shared object
960     or shared library should be built.  It is an error to try to build
961     static objects into a shared library or vice versa.
962
963   - Win32 support for .def files has been added.  Added the Win32-specific
964     construction variables $WIN32DEFPREFIX, $WIN32DEFSUFFIX,
965     $WIN32DLLPREFIX and $WIN32IMPLIBPREFIX.  When building a .dll,
966     the new construction variable $WIN32_INSERT_DEF, controls whether
967     the appropriately-named .def file is inserted into the target
968     list (if not already present).  A .lib file is always added to
969     a Library build if not present in the list of targets.
970
971   - ListBuilder now passes all targets to the action, not just the first.
972
973   - Fix so that -c now deletes generated yacc .h files.
974
975   - Builder actions and emitter functions can now be initialized, through
976     construction variables, to things other than strings.
977
978   - Make top-relative '#/dir' lookups work like '#dir'.
979
980   - Fix for relative CPPPATH directories in subsidiary SConscript files
981     (broken in 0.06).
982
983   - Add a for_signature argument to command generators, so that
984     generators that need to can return distinct values for the
985     command signature and for executing the command.
986
987   From Alex Jacques:
988
989   - Create a better scons.bat file from a py2bat.py script on the Python
990     mailing list two years ago (modeled after pl2bat.pl).
991
992   From Steven Knight:
993
994   - Fix so that -c -n does *not* remove the targets!
995
996   - Man page:  Add a hierarchical libraries + Program example.
997
998   - Support long MSVC linker command lines through a builder action
999     that writes to a temporary file and uses the magic MSVC "link @file"
1000     argument syntax if the line is longer than 2K characters.
1001
1002   - Fix F77 command-line options on Win32 (use /Fo instead of -o).
1003
1004   - Use the same action to build from .c (lower case) and .C (upper
1005     case) files on case-insensitive systems like Win32.
1006
1007   - Support building a PDF file directly from a TeX or LaTeX file
1008     using pdftex or pdflatex.
1009
1010   - Add a -x option to runtest.py to specify the script being tested.
1011     A -X option indicates it's an executable, not a script to feed
1012     to the Python interpreter.
1013
1014   - Add a Split() function (identical to SCons.Util.argmunge()) for use
1015     in the next release, when Builders will no longer automatically split
1016     strings on white space.
1017
1018   From Steve Leblanc:
1019
1020   - Add the SConscriptChdir() method.
1021
1022   From Anthony Roach:
1023
1024   - Fix --debug=tree when used with directory targets.
1025
1026   - Significant internal restructuring of Scanners and Taskmaster.
1027
1028   - Added new --debug=dtree option.
1029
1030   - Fixes for --profile option.
1031
1032   - Performance improvement in construction variable substitution.
1033
1034   - Implemented caching of content signatures, plus added --max-drift
1035     option to control caching.
1036
1037   - Implemented caching of dependency signatures, enabled by new
1038     --implicit-cache option.
1039
1040   - Added abspath construction variable modifier.
1041
1042   - Added $SOURCE variable as a synonym for $SOURCES[0].
1043
1044   - Write out .sconsign files on error or interrupt so intermediate
1045     build results are saved.
1046
1047   - Change the -U option to -D.  Make a new -U that builds just the
1048     targets from the local SConscript file.
1049
1050   - Fixed use of sys.path so Python modules can be imported from
1051     the SConscript directory.
1052
1053   - Fix for using Aliases with the -u, -U and -D options.
1054
1055   - Fix so that Nodes can be passed to SConscript files.
1056
1057   From Moshe Zadka:
1058   
1059   - Changes for official Debian packaging.
1060
1061
1062
1063 RELEASE 0.06 - Thu, 28 Mar 2002 01:24:29 -0600
1064
1065   From Charles Crain:
1066
1067   - Fix command generators to expand construction variables.
1068
1069   - Make FunctionAction arguments be Nodes, not strings.
1070
1071   From Stephen Kennedy:
1072
1073   - Performance:  Use a dictionary, not a list, for a Node's parents.
1074
1075   From Steven Knight:
1076
1077   - Add .zip files to the packages we build.
1078
1079   - Man page:  document LIBS, fix a typo, document ARGUMENTS.
1080
1081   - Added RANLIB and RANLIBFLAGS construction variables.  Only use them
1082     in ARCOM if there's a "ranlib" program on the system.
1083
1084   - Add a configurable CFILESUFFIX for the Builder of .l and .y files
1085     into C files.
1086
1087   - Add a CXXFile Builder that turns .ll and .yy files into .cc files
1088     (configurable via a CXXFILESUFFIX construction variable).
1089
1090   - Use the POSIX-standard lex -t flag, not the GNU-specific -o flag.
1091     (Bug reported by Russell Christensen.)
1092
1093   - Fixed an exception when CPPPATH or LIBPATH is a null string.
1094     (Bug reported by Richard Kiss.)
1095
1096   - Add a --profile=FILE option to make profiling SCons easier.
1097
1098   - Modify the new DVI builder to create .dvi files from LaTeX (.ltx
1099     and .latex) files.
1100
1101   - Add support for Aliases (phony targets).
1102
1103   - Add a WhereIs() method for searching for path names to executables.
1104
1105   - Add PDF and PostScript document builders.
1106
1107   - Add support for compiling Fortran programs from a variety of
1108     suffixes (a la GNU Make):  .f, .F, .for, .FOR, .fpp and .FPP
1109
1110   - Support a CPPFLAGS variable on all default commands that use the
1111     C preprocessor.
1112
1113   From Steve Leblanc:
1114
1115   - Add support for the -U option.
1116
1117   - Allow CPPPATH, LIBPATH and LIBS to be specified as white-space
1118     separated strings.
1119
1120   - Add a document builder to create .dvi files from TeX (.tex) files.
1121
1122   From Anthony Roach:
1123
1124   - Fix:  Construction variables with values of 0 were incorrectly
1125     interpolated as ''. 
1126
1127   - Support env['VAR'] to fetch construction variable values.
1128
1129   - Man page:  document Precious().
1130
1131
1132
1133 RELEASE 0.05 - Thu, 21 Feb 2002 16:50:03 -0600
1134
1135   From Chad Austin:
1136
1137   - Set PROGSUFFIX to .exe under Cygwin.
1138
1139   From Charles Crain:
1140
1141   - Allow a library to specified as a command-line source file, not just
1142     in the LIBS construction variable.
1143
1144   - Compensate for a bug in os.path.normpath() that returns '' for './'
1145     on WIN32.
1146
1147   - More performance optimizations:  cache #include lines from files,
1148     eliminate unnecessary calls.
1149
1150   - If a prefix or suffix contains white space, treat the resulting
1151     concatenation as separate arguments.
1152
1153   - Fix irregularities in the way we fetch DevStudio information from
1154     the Windows registry, and in our registry error handling.
1155
1156   From Steven Knight:
1157
1158   - Flush stdout after print so it intermixes correctly with stderr
1159     when redirected.
1160
1161   - Allow Scanners to return a list of strings, and document how to
1162     write your own Scanners.
1163
1164   - Look up implicit (scanned) dependencies relative to the directory
1165     of file being scanned.
1166
1167   - Make writing .sconsign files more robust by first trying to write
1168     to a temp file that gets renamed.
1169
1170   - Create all of the directories for a list of targets before trying
1171     to build any of the targets.
1172
1173   - WIN32 portability fixes in tests.
1174
1175   - Allow the list of variables exported to an SConscript file to be
1176     a UserList, too.
1177
1178   - Document the overlooked LIBPATH construction variable.
1179     (Bug reported by Eicke Godehardt.)
1180
1181   - Fix so that Ignore() ignores indirect, implicit dependencies
1182     (included files), not just direct dependencies.
1183
1184   - Put the man page in the Debian distribution.
1185
1186   - Run HTML docs through tidy to clean up the HTML (for Konqueror).
1187
1188   - Add preliminary support for Unicode strings.
1189
1190   - Efficiency:  don't scan dependencies more than once during the
1191     walk of a tree.
1192
1193   - Fix the -c option so it doesn't stop removing targets if one doesn't
1194     already exist.
1195     (Bug reported by Paul Connell.)
1196
1197   - Fix the --debug=pdb option when run on Windows NT.
1198     (Bug reported by Paul Connell.)
1199
1200   - Add support for the -q option.
1201
1202   From Steve Leblanc:
1203
1204   - Add support for the -u option.
1205
1206   - Add .cc and .hh file suffixes to the C Scanner.
1207
1208   From Anthony Roach:
1209
1210   - Make the scons script return an error code on failures.
1211
1212   - Add support for using code to generate a command to build a target.
1213
1214
1215
1216 RELEASE 0.04 - Wed, 30 Jan 2002 11:09:42 -0600
1217
1218   From Charles Crain:
1219
1220   - Significant performance improvements in the Node.FS and
1221     Scanner subsystems.
1222
1223   - Fix signatures of binary files on Win32 systems.
1224
1225   - Allow LIBS and LIBPATH to be strings, not just arrays.
1226
1227   - Print a traceback if a Python-function builder throws an exception.
1228
1229   From Steven Knight:
1230
1231   - Fix using a directory as a Default(), and allow Default() to
1232     support white space in file names for strings in arrays.
1233
1234   - Man page updates:  corrected some mistakes, documented various
1235     missing Environment methods, alphabetized the construction
1236     variables and other functions, defined begin and end macros for
1237     the example sections, regularized white space separation, fixed
1238     the use of Export() in the Multiple Variants example.
1239
1240   - Function action fixes:  None is now a successful return value.
1241     Exceptions are now reported.  Document function actions.
1242
1243   - Add 'Action' and 'Scanner' to the global keywords so SConscript
1244     files can use them too.
1245
1246   - Removed the Wrapper class between Nodes and Walkers.
1247
1248   - Add examples using Library, LIBS, and LIBPATH.
1249
1250   - The C Scanner now always returns a sorted list of dependencies
1251     so order changes don't cause unnecessary rebuilds.
1252
1253   - Strip $(-$) bracketed text from command lines.  Use this to
1254     surround $_INCDIRS and $_LIBDIRS so we don't rebuild in response
1255     to changes to -I or -L options.
1256
1257   - Add the Ignore() method to ignore dependencies.
1258
1259   - Provide an error message when a nonexistent target is specified
1260     on the command line.
1261
1262   - Remove targets before building them, and add an Environment
1263     Precious() method to override that.
1264
1265   - Eliminate redundant calls to the same builder when the target is a
1266     list of targets:  Add a ListBuilder class that wraps Builders to
1267     handle lists atomically.  Extend the Task class to support building
1268     and updating multiple targets in a single Task.  Simplify the
1269     interface between Task and Taskmaster.
1270
1271   - Add a --debug=pdb option to re-run SCons under the Python debugger.
1272
1273   - Only compute a build signature once for each node.
1274
1275   - Changes to our sys.path[] manipulation to support installation into
1276     an arbitrary --prefix value.
1277
1278   From Steve Leblanc:
1279
1280   - Add var=value command-line arguments.
1281
1282
1283
1284 RELEASE 0.03 - Fri, 11 Jan 2002 01:09:30 -0600
1285
1286   From Charles Crain:
1287
1288   - Performance improvements in the Node.FS and Sig.Calculator classes.
1289
1290   - Add the InstallAs() method.
1291
1292   - Execute commands through an external interpreter (sh, cmd.exe, or
1293     command.com) to handle redirection metacharacters.
1294
1295   - Allow the user to supply a command handler.
1296
1297   From Steven Knight:
1298
1299   - Search both /usr/lib and /usr/local/lib for scons directories by
1300     adding them both to sys.path, with whichever is in sys.prefix first.
1301
1302   - Fix interpreting strings of multiple white-space separated file names
1303     as separate file names, allowing prefixes and suffixes to be appended
1304     to each individually.
1305
1306   - Refactor to move CompositeBuilder initialization logic from the
1307     factory wrapper to the __init__() method, and allow a Builder to
1308     have both an action and a src_builder (or array of them).
1309
1310   - Refactor BuilderBase.__call__() to separate Node creation/lookup
1311     from initialization of the Node's builder information.
1312
1313   - Add a CFile Builder object that supports turning lex (.l) and
1314     yacc (.y) files into .c files.
1315
1316   - Document: variable interpretation attributes; how to propogate
1317     the user's environment variables to executed commands; how to
1318     build variants in multiple BuildDirs.
1319
1320   - Collect String, Dict, and List type-checking in common utility
1321     routines so we can accept User{String,Dict,List}s all over.
1322
1323   - Put the Action factory and classes into their own module.
1324
1325   - Use one CPlusPlusAction in the Object Builder's action dictionary,
1326     instead of letting it create multiple identical instances.
1327
1328   - Document the Install() and InstallAs() methods.
1329
1330   From Steve Leblanc:
1331
1332   - Require that a Builder be given a name argument, supplying a
1333     useful error message when it isn't.
1334
1335   From Anthony Roach:
1336
1337   - Add a "duplicate" keyword argument to BuildDir() that can be set
1338     to prevent linking/copying source files into build directories.
1339
1340   - Add a "--debug=tree" option to print an ASCII dependency tree.
1341
1342   - Fetch the location of the Microsoft Visual C++ compiler(s) from
1343     the Registry, instead of hard-coding the location.
1344     
1345   - Made Scanner objects take Nodes, not path names.
1346     
1347   - Have the C Scanner cache the #include file names instead of
1348     (re-)scanning the file each time it's called.
1349
1350   - Created a separate class for parent "nodes" of file system roots,
1351     eliminating the need for separate is-parent-null checks everywhere.
1352     
1353   - Removed defined __hash__() and __cmp() methods from FS.Entry, in
1354     favor of Python's more efficient built-in identity comparisons.
1355
1356
1357
1358 RELEASE 0.02 - Sun, 23 Dec 2001 19:05:09 -0600
1359
1360   From Charles Crain:
1361
1362   - Added the Install(), BuildDir(), and Export() methods.
1363
1364   - Fix the -C option by delaying setting the top of the FS tree.
1365
1366   - Avoid putting the directory path on the libraries in the LIBS
1367     construction variable.
1368
1369   - Added a GetBuildPath() method to return the full path to the
1370     Node for a specified string.
1371
1372   - Fixed variable substitution in CPPPATH and LIBPATH.
1373
1374   From Steven Knight:
1375
1376   - Fixed the version comment in the scons.bat (the UNIX geek used
1377     # instead of @rem).
1378
1379   - Fix to setup.py so it doesn't require a sys.argv[1] argument.
1380
1381   - Provide make-like warning message for "command not found" and
1382     similar errors.
1383
1384   - Added an EXAMPLES section to the man page.
1385
1386   - Make Default() targets properly relative to their SConscript
1387     file's subdirectory.
1388
1389   From Anthony Roach:
1390
1391   - Documented CXXFLAGS, CXXCOM, and CPPPATH.
1392
1393   - Fixed SCONS_LIB_DIR to work as documented.
1394
1395   - Made Default() accept Nodes as arguments.
1396
1397   - Changed Export() to make it easier to use.
1398   
1399   - Added the Import() and Return() methods.
1400
1401
1402
1403 RELEASE 0.01 - Thu Dec 13 19:25:23 CST 2001
1404
1405 A brief overview of important functionality available in release 0.01:
1406
1407   - C and C++ compilation on POSIX and Windows NT.
1408
1409   - Automatic scanning of C/C++ source files for #include dependencies.
1410
1411   - Support for building libraries; setting construction variables
1412     allows creation of shared libraries.
1413
1414   - Library and C preprocessor search paths.
1415
1416   - File changes detected using MD5 signatures.
1417
1418   - User-definable Builder objects for building files.
1419
1420   - User-definable Scanner objects for scanning for dependencies.
1421
1422   - Parallel build (-j) support.
1423
1424   - Dependency cycles detected.
1425
1426   - Linux packages available in RPM and Debian format.
1427
1428   - Windows installer available.