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