Prepare for release 0.04.
[scons.git] / src / CHANGES.txt
1 # Copyright (c) 2001, 2002 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 - Wed, 30 Jan 2002 11:09:42 -0600
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   - Changes to our sys.path[] manipulation to support installation into
71     an arbitrary --prefix value.
72
73   From Steve Leblanc:
74
75   - Add var=value command-line arguments.
76
77
78
79 RELEASE 0.03 - Fri, 11 Jan 2002 01:09:30 -0600
80
81   From Charles Crain:
82
83   - Performance improvements in the Node.FS and Sig.Calculator classes.
84
85   - Add the InstallAs() method.
86
87   - Execute commands through an external interpreter (sh, cmd.exe, or
88     command.com) to handle redirection metacharacters.
89
90   - Allow the user to supply a command handler.
91
92   From Steven Knight:
93
94   - Search both /usr/lib and /usr/local/lib for scons directories by
95     adding them both to sys.path, with whichever is in sys.prefix first.
96
97   - Fix interpreting strings of multiple white-space separated file names
98     as separate file names, allowing prefixes and suffixes to be appended
99     to each individually.
100
101   - Refactor to move CompositeBuilder initialization logic from the
102     factory wrapper to the __init__() method, and allow a Builder to
103     have both an action and a src_builder (or array of them).
104
105   - Refactor BuilderBase.__call__() to separate Node creation/lookup
106     from initialization of the Node's builder information.
107
108   - Add a CFile Builder object that supports turning lex (.l) and
109     yacc (.y) files into .c files.
110
111   - Document: variable interpretation attributes; how to propogate
112     the user's environment variables to executed commands; how to
113     build variants in multiple BuildDirs.
114
115   - Collect String, Dict, and List type-checking in common utility
116     routines so we can accept User{String,Dict,List}s all over.
117
118   - Put the Action factory and classes into their own module.
119
120   - Use one CPlusPlusAction in the Object Builder's action dictionary,
121     instead of letting it create multiple identical instances.
122
123   - Document the Install() and InstallAs() methods.
124
125   From Steve Leblanc:
126
127   - Require that a Builder be given a name argument, supplying a
128     useful error message when it isn't.
129
130   From Anthony Roach:
131
132   - Add a "duplicate" keyword argument to BuildDir() that can be set
133     to prevent linking/copying source files into build directories.
134
135   - Add a "--debug=tree" option to print an ASCII dependency tree.
136
137   - Fetch the location of the Microsoft Visual C++ compiler(s) from
138     the Registry, instead of hard-coding the location.
139     
140   - Made Scanner objects take Nodes, not path names.
141     
142   - Have the C Scanner cache the #include file names instead of
143     (re-)scanning the file each time it's called.
144
145   - Created a separate class for parent "nodes" of file system roots,
146     eliminating the need for separate is-parent-null checks everywhere.
147     
148   - Removed defined __hash__() and __cmp() methods from FS.Entry, in
149     favor of Python's more efficient built-in identity comparisons.
150
151
152
153 RELEASE 0.02 - Sun, 23 Dec 2001 19:05:09 -0600
154
155   From Charles Crain:
156
157   - Added the Install(), BuildDir(), and Export() methods.
158
159   - Fix the -C option by delaying setting the top of the FS tree.
160
161   - Avoid putting the directory path on the libraries in the LIBS
162     construction variable.
163
164   - Added a GetBuildPath() method to return the full path to the
165     Node for a specified string.
166
167   - Fixed variable substitution in CPPPATH and LIBPATH.
168
169   From Steven Knight:
170
171   - Fixed the version comment in the scons.bat (the UNIX geek used
172     # instead of @rem).
173
174   - Fix to setup.py so it doesn't require a sys.argv[1] argument.
175
176   - Provide make-like warning message for "command not found" and
177     similar errors.
178
179   - Added an EXAMPLES section to the man page.
180
181   - Make Default() targets properly relative to their SConscript
182     file's subdirectory.
183
184   From Anthony Roach:
185
186   - Documented CXXFLAGS, CXXCOM, and CPPPATH.
187
188   - Fixed SCONS_LIB_DIR to work as documented.
189
190   - Made Default() accept Nodes as arguments.
191
192   - Changed Export() to make it easier to use.
193   
194   - Added the Import() and Return() methods.
195
196
197
198 RELEASE 0.01 - Thu Dec 13 19:25:23 CST 2001
199
200 A brief overview of important functionality available in release 0.01:
201
202   - C and C++ compilation on POSIX and Windows NT.
203
204   - Automatic scanning of C/C++ source files for #include dependencies.
205
206   - Support for building libraries; setting construction variables
207     allows creation of shared libraries.
208
209   - Library and C preprocessor search paths.
210
211   - File changes detected using MD5 signatures.
212
213   - User-definable Builder objects for building files.
214
215   - User-definable Scanner objects for scanning for dependencies.
216
217   - Parallel build (-j) support.
218
219   - Dependency cycles detected.
220
221   - Linux packages available in RPM and Debian format.
222
223   - Windows installer available.