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