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