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