Performance improvement: avoid recomputing signatures.
[scons.git] / src / CHANGES.txt
1 # Copyright (c) 2001 Steven Knight
2 # __FILE__ __REVISION__ __DATE__ __DEVELOPER__
3
4
5                  SCons - a software construction tool
6
7                             Change Log
8
9
10
11 RELEASE 0.04 - 
12
13   From Charles Crain:
14
15   - Significant performance improvements in the Node.FS and
16     Scanner subsystems.
17
18   - Fix signatures of binary files on Win32 systems.
19
20   - Allow LIBS and LIBPATH to be strings, not just arrays.
21
22   - Print a traceback if a Python-function builder throws an exception.
23
24   From Steven Knight:
25
26   - Fix using a directory as a Default(), and allow Default() to
27     support white space in file names for strings in arrays.
28
29   - Man page updates:  corrected some mistakes, documented various
30     missing Environment methods, alphabetized the construction
31     variables and other functions, defined begin and end macros for
32     the example sections, regularized white space separation, fixed
33     the use of Export() in the Multiple Variants example.
34
35   - Function action fixes:  None is now a successful return value.
36     Exceptions are now reported.  Document function actions.
37
38   - Add 'Action' and 'Scanner' to the global keywords so SConscript
39     files can use them too.
40
41   - Removed the Wrapper class between Nodes and Walkers.
42
43   - Add examples using Library, LIBS, and LIBPATH.
44
45   - The C Scanner now always returns a sorted list of dependencies
46     so order changes don't cause unnecessary rebuilds.
47
48   - Strip $(-$) bracketed text from command lines.  Use this to
49     surround $_INCDIRS and $_LIBDIRS so we don't rebuild in response
50     to changes to -I or -L options.
51
52   - Add the Ignore() method to ignore dependencies.
53
54   - Provide an error message when a nonexistent target is specified
55     on the command line.
56
57   - Remove targets before building them, and add an Environment
58     Precious() method to override that.
59
60   - Eliminate redundant calls to the same builder when the target is a
61     list of targets:  Add a ListBuilder class that wraps Builders to
62     handle lists atomically.  Extend the Task class to support building
63     and updating multiple targets in a single Task.  Simplify the
64     interface between Task and Taskmaster.
65
66   - Add a --debug=pdb option to re-run SCons under the Python debugger.
67
68   - Only compute a build signature once for each node.
69
70   From Steve Leblanc:
71
72   - Add var=value command-line arguments.
73
74
75
76 RELEASE 0.03 - Fri, 11 Jan 2002 01:09:30 -0600
77
78   From Charles Crain:
79
80   - Performance improvements in the Node.FS and Sig.Calculator classes.
81
82   - Add the InstallAs() method.
83
84   - Execute commands through an external interpreter (sh, cmd.exe, or
85     command.com) to handle redirection metacharacters.
86
87   - Allow the user to supply a command handler.
88
89   From Steven Knight:
90
91   - Search both /usr/lib and /usr/local/lib for scons directories by
92     adding them both to sys.path, with whichever is in sys.prefix first.
93
94   - Fix interpreting strings of multiple white-space separated file names
95     as separate file names, allowing prefixes and suffixes to be appended
96     to each individually.
97
98   - Refactor to move CompositeBuilder initialization logic from the
99     factory wrapper to the __init__() method, and allow a Builder to
100     have both an action and a src_builder (or array of them).
101
102   - Refactor BuilderBase.__call__() to separate Node creation/lookup
103     from initialization of the Node's builder information.
104
105   - Add a CFile Builder object that supports turning lex (.l) and
106     yacc (.y) files into .c files.
107
108   - Document: variable interpretation attributes; how to propogate
109     the user's environment variables to executed commands; how to
110     build variants in multiple BuildDirs.
111
112   - Collect String, Dict, and List type-checking in common utility
113     routines so we can accept User{String,Dict,List}s all over.
114
115   - Put the Action factory and classes into their own module.
116
117   - Use one CPlusPlusAction in the Object Builder's action dictionary,
118     instead of letting it create multiple identical instances.
119
120   - Document the Install() and InstallAs() methods.
121
122   From Steve Leblanc:
123
124   - Require that a Builder be given a name argument, supplying a
125     useful error message when it isn't.
126
127   From Anthony Roach:
128
129   - Add a "duplicate" keyword argument to BuildDir() that can be set
130     to prevent linking/copying source files into build directories.
131
132   - Add a "--debug=tree" option to print an ASCII dependency tree.
133
134   - Fetch the location of the Microsoft Visual C++ compiler(s) from
135     the Registry, instead of hard-coding the location.
136     
137   - Made Scanner objects take Nodes, not path names.
138     
139   - Have the C Scanner cache the #include file names instead of
140     (re-)scanning the file each time it's called.
141
142   - Created a separate class for parent "nodes" of file system roots,
143     eliminating the need for separate is-parent-null checks everywhere.
144     
145   - Removed defined __hash__() and __cmp() methods from FS.Entry, in
146     favor of Python's more efficient built-in identity comparisons.
147
148
149
150 RELEASE 0.02 - Sun, 23 Dec 2001 19:05:09 -0600
151
152   From Charles Crain:
153
154   - Added the Install(), BuildDir(), and Export() methods.
155
156   - Fix the -C option by delaying setting the top of the FS tree.
157
158   - Avoid putting the directory path on the libraries in the LIBS
159     construction variable.
160
161   - Added a GetBuildPath() method to return the full path to the
162     Node for a specified string.
163
164   - Fixed variable substitution in CPPPATH and LIBPATH.
165
166   From Steven Knight:
167
168   - Fixed the version comment in the scons.bat (the UNIX geek used
169     # instead of @rem).
170
171   - Fix to setup.py so it doesn't require a sys.argv[1] argument.
172
173   - Provide make-like warning message for "command not found" and
174     similar errors.
175
176   - Added an EXAMPLES section to the man page.
177
178   - Make Default() targets properly relative to their SConscript
179     file's subdirectory.
180
181   From Anthony Roach:
182
183   - Documented CXXFLAGS, CXXCOM, and CPPPATH.
184
185   - Fixed SCONS_LIB_DIR to work as documented.
186
187   - Made Default() accept Nodes as arguments.
188
189   - Changed Export() to make it easier to use.
190   
191   - Added the Import() and Return() methods.
192
193
194
195 RELEASE 0.01 - Thu Dec 13 19:25:23 CST 2001
196
197 A brief overview of important functionality available in release 0.01:
198
199   - C and C++ compilation on POSIX and Windows NT.
200
201   - Automatic scanning of C/C++ source files for #include dependencies.
202
203   - Support for building libraries; setting construction variables
204     allows creation of shared libraries.
205
206   - Library and C preprocessor search paths.
207
208   - File changes detected using MD5 signatures.
209
210   - User-definable Builder objects for building files.
211
212   - User-definable Scanner objects for scanning for dependencies.
213
214   - Parallel build (-j) support.
215
216   - Dependency cycles detected.
217
218   - Linux packages available in RPM and Debian format.
219
220   - Windows installer available.