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