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