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