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