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