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