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