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