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