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