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