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