feat: adds minor java improvements
[scons.git] / CHANGES.txt
blob343d5471d6be24577b55ce4b1ad954ae1a1d0941
3                  SCons - a software construction tool
5                             Change Log
7 NOTE: The 4.0.0 Release of SCons dropped Python 2.7 Support
8 NOTE: The 4.2.0 Release of SCons will drop Python 3.5 Support
10 RELEASE  VERSION/DATE TO BE FILLED IN LATER
12   From Joseph Brill:
13     - Internal MSVS update: Remove unnecessary calls to find all installed versions of msvc
14       when constructing the installed visual studios list.
16   From William Deegan:
17     - Improve Subst()'s logic to check for proper callable function or class's argument list.
18       It will now allow callables with expected args, and any extra args as long as they
19       have default arguments. Additionally functions with no defaults for extra arguments
20       as long as they are set using functools.partial to create a new callable which set them.
21     - Fix Issue #3035 - mingw with SHLIBVERSION set fails with either not a dll error or
22       "Multiple ways to build the same target were specified for:".  Now mingw will disable
23       creating the symlinks (and adding version string to ) dlls.  It sets SHLIBNOVERSIONSYMLINKS,
24       IMPLIBNOVERSIONSYMLINKS and LDMODULENOVERSIONSYMLINKS to True.
25     - Added --experimental flag, to enable various experimental features/tools.  You can specify
26       'all', 'none', or any combination of available experimental features.
27     - Fix Issue #3933 - Remove unguarded print of debug information in SharedLibrary logic when
28       SHLIBVERSION is specified.
29     - Fix versioned shared library naming for MacOS platform. (Previously was libxyz.dylib.1.2.3,
30       has been fixed to libxyz.1.2.3.dylib. Additionally the sonamed symlink had the same issue,
31       that is now resolved as well)
32     - Fix #3955 - _LIBDIRFLAGS leaving $( and $) in *COMSTR output.  Added affect_signature flag to
33       _concat function.  If set to False, it will prepend and append $( and $). That way the various
34       Environment variables can use that rather than "$( _concat(...) $)".
36   From David H:
37     - Fix Issue #3906 - `IMPLICIT_COMMAND_DEPENDENCIES` was not properly disabled when
38       set to any string value (For example ['none','false','no','off'])
39       Also previously 'All' wouldn't have the desired affect.
40     - Add JavaScanner to include JAVACLASSPATH as a dependency when using the Java tool.
41     - Fix incorrect Java classpath generation when a NodeList is used as part of any JAVA*PATH variables.
43   From Ivan Kravets:
44     - Provide a custom argument escape function for `TempFileMunge` using a new
45       `TEMPFILEARGESCFUNC` variable. Useful if you need to apply extra operations on
46       a command argument before writing to a temporary file (fix Windows slashes,
47       normalize paths, etc.)
49   From Henrik Maier:
50    - DocbookXslt tool: The XSLT stylesheet file is now initialized to an env.File() Node,
51      such that dependencies work correctly in hierarchical builds (eg when using
52      DocbookXslt in SConscript('subdir/SConscript') context.
54   From Daniel Moody:
55     - Update CacheDir to use uuid for tmpfile uniqueness instead of pid.
56       This fixes cases for shared cache where two systems write to the same
57       cache tmpfile at the same time because the happened to get the same pid.
58     - Added support for passing custom CacheDir derived classes to SCons. Moved
59       copy_from_cache attribute from the Environment class to CacheDir class.
60       Code contributed by MongoDB.
61     - Update BuildTask to pass all targets to the progress object fixing an issue
62       where multi-target build nodes only got the first target passed to the progress
63       object.
65   From Mats Wichmann:
66     - Initial support in tests for Python 3.10 - expected bytecode and
67       one changed expected exception message. Change some more regexes
68       to be specified as rawstrings in response to DeprecationWarnings.
69     - Add an example of adding an emitter to User Guide (concept
70       from Jeremy Elson)
71     - Add timing information for sconsign database dump when --debug=time
72       is selected. Also switch to generally using time.perf_counter,
73       which is the Python recommended way for timing short durations.
74     - Drop remaining definitions of dict-like has_key methods, since
75       Python 3 doesn't have a dictionary has_key (maintenance)
76     - Do not treat --site-dir=DIR and --no-site-dir as distinct options.
77       Allows a later instance to override an earlier one.
78     - Ignore empty cmdline arguments when computing targets (issue 2986)
79     - Remove long-deprecated construction variables PDFCOM, WIN32_INSERT_DEF,
80       WIN32DEFPREFIX, WIN32DEFSUFFIX, WIN32EXPPREFIX, WIN32EXPSUFFIX.
81       All have been replaced by other names since at least 1.0.
82     - Add a __iadd__ method to the CLVar class so that inplace adds
83       (+=) also work as expected (issue 2399)
84     - Remove local copy of CLVar in EnvironmentTests unittest file -
85       should be testing against the production version, and they
86       didn't really differ.
87     - Don't strip spaces in INSTALLSTR by using raw subst (issue 2018)
88     - Deprecate Python 3.5 as a supported version.
89     - CPPDEFINES now expands construction variable references (issue 2363)
90     - Restore behavior that Install()'d files are writable (issue 3927)
91     - Simplified Mkdir(), the internal mkdir_func no longer needs to handle
92       existing directories, it can now pass exist_ok=True to os.makedirs().
93     - Avoid WhereIs exception if user set a tool name to empty (from issue 1742)
94     - Maintenance: remove obsolete __getslice__ definitions (Py3 never calls);
95       add Node.fs.scandir to call new (Py3.5) os.scandir; Node.fs.makedirs
96       now passes the exist_ok flag; Cachedir creation now uses this flag.
97     - Maintenance: remove unneeded imports and reorganize some.  Fix uses
98       of warnings in some tools which instantiated the class but did nothing
99       with them, need to instead call SCons.Warnings.warn with the warn class.
100     - Drop overridden changed_since_last_build method in Value class.
101     - Resync the SetOption implementation and the manpage, making sure new
102       options are available and adding a notes column for misc information.
103       SetOption equivalents to --hash-chunksize, --implicit-deps-unchanged
104       and --implicit-deps-changed are enabled.
105     - Add tests for SetOption failing on disallowed options and value types.
106     - Maintenance: eliminate lots of checker complaints about Util.py.
107     - Maintenance: fix checker-spotted issues in Environment (apply_tools)
108       and EnvironmentTests (asserts comparing with self).
109       For consistency, env.Tool() now returns a tool object the same way
110       Tool() has done.
112   From Dillan Mills:
113     - Add support for the (TARGET,SOURCE,TARGETS,SOURCES,CHANGED_TARGETS,CHANGED_SOURCES}.relpath property.
114       This will provide a path relative to the top of the build tree (where the SConstruct is located)
115       Fixes #396
117   From Andrew Morrow:
118     - Fix issue #3790: Generators in CPPDEFINES now have access to populated source
119       and target lists
121 RELEASE 4.1.0 - Tues, 19 Jan 2021 15:04:42 -0700
123   From James Benton:
124     - Add COMPILATIONDB_PATH_FILTER env option for CompilationDatabase() builder which allows
125       filtering of entries based on the output file paths using glob style file matching (issue #3742).
127   From Joseph Brill:
128     - Internal MSVC and test updates: Rework the msvc installed versions cache so that it
129       is not exposed externally and update external references accordingly.
130     - Modify the MSCommon internal-use only debug logging records to contain the correct relative
131       file path when the debug function is called from outside the MSCommon module.
133   From William Deegan:
134     - Fix yacc tool, not respecting YACC set at time of tool initialization.
135     - Refactor SCons.Tool to move all common shared and loadable module linking logic to SCons.Tool.linkCommon
136     - Remove pywin32 imports from SCons.Script.Main. No longer needed.
137     - Switch to use ctypes instead of pywin32 (requiring an extra pip install) - Fixes Github Issue #2291
138        - pywin32 no longer necessary for SCons install. (pip install SCons will no longer also require pywin32 on win32)
139        - Remove pywin32 usage from SCons.Util where it was used for accessing the registry. Python native winreg
140          library already includes this functionality.
141        - Remove using pywin32 to retrieve peak memory usage on Win32 for `--debug=memory`
142     - Fix Issue #3759 - include scons.1, sconsign.1, scons-time.1 manpages in sdist and wheel packages.
143     - Change SCons's build so the generated `SCons/__init__.py` is no longer removed by `scons -c`
144     - Completely rewrote versioned shared libraries logic. Added support for SOVERSION via dmoody's initial PR #3733
145     - No longer automatically disable setting SONAME on shared libraries on OpenBSD.
146     - Fix race condition bug when initializing a scons cache directory at the
147       same time from multiple threads or processes. Problem described in PR #3114.
148       This is a simpler fix which should avoid some problems identified with the initial PR.
149       (Credit to Fredrik Medley for reporting the issue, the initial PR, and discussing and testing
150        this solution)
152   From Michał Górny:
153     - Fix dvipdf test failure due to passing incorrect flag to dvipdf.
155   From Adam Gross:
156     - Fix minor bug affecting SCons.Node.FS.File.get_csig()'s usage of the MD5 chunksize.
157       User-facing behavior does not change with this fix (GH Issue #3726).
158     - Fix occasional test failures caused by not being able to find a file or directory fixture
159       when running multiple tests with multiple jobs.
160     - Added support for a new command-line parameter `--hash-format` to override the default
161       hash format that SCons uses. It can also be set via `SetOption('hash_format')`. Supported
162       values are: `md5`, `sha1`, and `sha256`. For all hash formats other than
163       the default of `md5`, the SConsign database will include the name of the hash format.
164       For example, `--hash-format=sha256` will create a SConsign with name
165       `.sconsign_sha256.dblite.`.
166     - Fix incorrect cache hits and/or misses when running in interactive mode by having
167       SCons.Node.Node.clear() clear out all caching-related state.
168     - Change Environment.SideEffect() to not add duplicate side effects.
169       NOTE: The list of returned side effect Nodes will not include any duplicate side effect Nodes.
170     - Add support to the Python scanner for finding dynamically generated dependencies.
171       Previously the scanner only found imports if they existed on disk at scanning time.
173   From David H:
174     - Add ZIP_OVERRIDE_TIMESTAMP env option to Zip builder which allows for overriding of the file
175       modification times in the archive.
176     - Fix Zip builder not rebuilding when ZIPROOT env option was changed.
178   From Jason Kenny
179     - Fix python3 crash when Value node get_text_content when child content does not have decode()
180       NOTE: If you depend on Value node's get_text_content returning concatenated contents of it's
181       children. This may break your code. It now concatenates the csig() of all children.
183   From Joachim Kuebart:
184     - Suppress missing SConscript deprecation warning if `must_exist=False`
185       is used.
187   From Rocco Matano:
188     - Fix Zip tool to respect ZIPCOMSTR. Previously all zip builder calls would yield something
189       like zip(["test.zip"], ["zip_scons.py"]) and ignore ZIPCOMSTR if ZIPCOM and ZIPCOMSTR
190       weren't set after the Environment/Tool is initialized. (Explained in PR #3659)
192   From Daniel Moody:
193     - Fix issue where java parsed a class incorrectly from lambdas used after a new.
195   From Simon Tegelid
196     - Fix using TEMPFILE in multiple actions in an action list. Previously a builder, or command
197       with an action list like this:
198       ['${TEMPFILE("xxx.py -otempfile $SOURCE")}', '${TEMPFILE("yyy.py -o$TARGET tempfile")}']
199       Could yield a single tempfile with the first TEMPFILE's contents, used by both steps
200       in the action list.
202   From Mats Wichmann:
203     - Complete tests for Dictionary, env.keys() and env.values() for
204       OverrideEnvironment. Enable env.setdefault() method, add tests.
205     - Raise an error if an option (not otherwise consumed) is used which
206       looks like an abbreviation of one one added by AddOption. (#3653)
207     - Tool module not found will now raise a UserError to more clearly indicate this is
208       probably an SConscript problem, and to make the traceback more relevant.
209     - Fix three issues with MergeFlags:
210       - Signature/return did not match documentation or existing usage - the implementation
211         now no longer returns the passed env
212       - merging --param arguments did not work (issue #3107);
213       - passing a dict to merge where the values are strings failed (issue #2961).
214     - Include previously-excluded SideEffect section in User Guide.
215     - Clean up unneeded imports (autoflake tool).
216     - Make sure cProfile is used if profiling - SCons was expecting
217       the Util module to monkeypatch in cProfile as profile if available,
218       but this is no longer being done.
219     - Cleanup in SCons.Util.AddMethod. If called with an environment instance
220       as the object to modify, the method would not be correctly set up in
221       any Clone of that instance.  Now tries to detect this and calls
222       MethodWrapper to set up the method the same way env.AddMethod does.
223       MethodWrapper moved to Util to avoid a circular import. Fixes #3028.
224     - Some Python 2 compatibility code dropped
225     - Rework runtest.py to use argparse for arg handling (was a mix
226       of hand-coded and optparse, with a stated intent to "gradually port").
227     - Add options to runtest to generate/not generate a log of failed tests,
228       and to rerun such tests. Useful when an error cascades through several
229       tests, can quickly try if a change improves all the fails. Dropped
230       runtest test for fallback from qmtest, not needed; added new tests.
231     - Eliminate tex tool usage of "for foo in range(len(iterable))"
232     - Restore internal Trace function to functional state.
233     - Only try to initialize the wix tool by default (or when tool `default` is explicitly installed)
234       on Windows based systems.
235     - Pick a better "Topic" Trove classifier for SCons: SW Dev / Build Tools
236     - Use os.replace instead of os.rename in dblite so don't need to
237       special-case Windows here. dblite is the default storage engine for the SConsign file(s).
238     - Fix cut-n-paste error in msvc debug printout and make some debug output
239       in msvs and msvsTests.py be off until needed (uncomment to use)
240     - Fix Issue #3014 - Empty file and missing file have same csig
241     - Refactor env.Append/Prepend to remove Py 1.5 era need to nest
242       try blocks, can now "continue" at the appropriate places.
243     - Add /snap/bin to env['PATH'] on POSIX, although this is only
244       really useful for a subset of POSIX systems that use snaps.
245       Was needed for CI builds, which run on Ubuntu LTS images.
246     - Eliminate Py2-ism __nonzero__ (now __bool__). Work around issue #3860
247       where a check for BuilderBase raising exc. on __bool__ was optimized out.
248       This issue was found due to a bug in Python 3.10.0a4. See issue #3860 for details.
251 RELEASE 4.0.1 - Mon, 16 Jul 2020 16:06:40 -0700
253   From Rob Boehne:
254     - Fix fortran tools to set SHFORTRAN variables to $FORTRAN, similarly SHF77, SHF90, SHF95,
255       SHF03 and SHF08 will default to the variables $F77, $F90, $F95, $F03 and $F08 respectively.
256       If you were depending on changing the value of FORTRAN (or $F[0-9][0-9]) having no effect
257       on the value of SHFORTRAN, this change will break that.   The values of FORTRAN, F77, F90,
258       F95, F03, F08 and SHFORTRAN, SHF77 (etc.) now are not overridden in generate if alredy set
259       by the user.
260     - Fix subprocess execution of 'lslpp' on AIX to produce text standard i/o.
261     - Re-do the fix for suncxx tool (Oracle Studio compiler) now that only Python 3 is supported,
262       to avoid decoding errors.
264   From William Deegan:
265     - Added Environment() variable TEMPFILEDIR which allows setting the directory which temp
266       files createdby TEMPFILEMUNGE are created in.
268   From Daniel Moody:
269     - Added method on Node to test if its node used in SConf. (Github Issue #3626)
273 RELEASE 4.0.0 - Sat, 04 Jul 2020 12:00:27 +0000
275   From Dirk Baechle:
276     - Updated documentation toolchain to work properly under Python3, also
277       removed libxslt support from the Docbook Tool. (issue #3580)
278     - Added Docker images for building and testing SCons. (issue #3585)
281   From James Benton:
282     - Improve Visual Studio solution/project generation code to add support
283       for a per-variant cppflags. Intellisense can be affected by cppflags,
284       this is especially important when it comes to /std:c++* which specifies
285       what C++ standard version to target. SCons will append /Zc:__cplusplus
286       to the project's cppflags when a /std:c++* flag is found as this is
287       required for intellisense to use the C++ standard version from cppflags.
289   From Rob Boehne
290     - Specify UTF-8 encoding when opening Java source file as text.  By default, encoding is the output
291     of locale.getpreferredencoding(False), and varies by platform.
293   From Joseph Brill:
294     - MSVC updates: When there are multiple product installations (e.g, Community and
295       Build Tools) of MSVC 2017 or MSVC 2019, an Enterprise, Professional,
296       or Community installation will be selected before a Build Tools installation when
297       "14.1" or "14.2" is requested, respectively. (GH Issue #3699).
298     - MSVC updates: When there are multiple product installations of MSVC 2017 (e.g.,
299       Community and Express), 2017 Express is no longer returned when "14.1" is
300       requested.  Only 2017 Express will be returned when "14.1Exp" is requested.
301       (GH Issue #3699).
302     - MSVC updates: An MSVC 6.0 installation now appears in the installed versions list
303       when msvc debug output is enabled (GH Issue #3699).
304     - MSVS test updates: Tests for building a program using generated MSVS project and
305       solution files using MSVS 2015 and later now work as expected on x86 hosts.
306     - Test update: Reduce the number of "false negative" test failures for the interactive
307       configuration test (test/interactive/configure.py).
308     - MSVS update: Fix the development environment path for MSVS 7.0.
310   From William Deegan:
311     - Fix broken clang + MSVC 2019 combination by using MSVC configuration logic to
312       propagate'VCINSTALLDIR' and 'VCToolsInstallDir' which clang tools use to locate
313       header files and libraries from MSVC install. (Fixes GH Issue #3480)
314     - Added C:\msys64\mingw64\bin to default mingw and clang windows PATH's.  This
315       is a reasonable default and also aligns with changes in Appveyor's VS2019 image.
316     - Drop support for Python 2.7. SCons will be Python 3.5+ going forward.
317     - Change SCons.Node.ValueWithMemo to consider any name passed when memoizing Value() nodes
318     - Fix Github Issue #3550 - When using Substfile() with a value like Z:\mongo\build\install\bin
319       the implementation using re.sub() would end up interpreting the string and finding regex escape
320       characters where it should have been simply replacing existing text. Switched to use string.replace().
321     - Fix Github Issue #2904 - Provide useful error message when more than one Configure Contexts are opened.
322       Only one open is allowed. You must call conf.Finish() to complete the currently open one before creating another
323     - Add msys2 installed mingw default path to PATH for mingw tool.
324       - C:\msys64\mingw64\bin
325     - Purge obsolete internal build and tooling scripts
326     - Allow user specified location for vswhere.exe specified by VSWHERE.
327       NOTE: This must be set at the time the 'msvc' 'msvs' and/or 'mslink' tool(s) are initialized to have any effect.
328     - Resolve Issue #3451 and Issue #3450 - Rewrite SCons setup.py and packaging. Move script logic to entry points so
329       package can create scripts which use the correct version of Python.
330     - Resolve Issue #3248 - Removing '-Wl,-Bsymbolic' from SHLIBVERSIONFLAGS
331       NOTE: If your build depends on the above you must now add to your SHLIBVERSIONFLAGS
332     - Speedup bin/docs-update-generated by caching parsed docbook schema. (60x speedup)
333     - Reorganized source tree. Moved src/engine/SCons to SCons to be more in line with current Python source
334       tree organization practices.
335     - Renamed as.py to asm.py and left redirecting tool.  'as' is a reserved word and so
336       changing the name was required as we wanted to import symbols for use in compilation_db
337       tool.
338     - Add CompilationDatabase() builder in compilation_db tool. Contributed by MongoDB.
339       Setting COMPILATIONDB_USE_ABSPATH to True|False controls whether the files are absolute or relative
340       paths.  Address Issue #3693 and #3694 found during development.
341     - Fixed Github Issue 3628 - Hardcoding pickle protocol to 4 (supports python 3.4+)
342       and skipping Python 3.8's new pickle protocol 5 whose main advantage is for out-of-band data buffers.
343       NOTE: If you used Python 3.8 with SCons 3.0.0 or above, you may get a a pickle protocol error. Remove your
344       .sconsign.dblite. You will end up with a full rebuild.
346   From Andrii Doroshenko:
347     - Extended `Environment.Dump()` to select a format to serialize construction variables (pretty, json).
349   From Jeremy Elson:
350     - Updated design doc to use the correct syntax for Depends()
352   From Adam Gross:
353     - Added support for scanning multiple entries in an action string if
354       IMPLICIT_COMMAND_DEPENDENCIES is set to 2 or 'all'. This enables more thorough
355       action scanning where every item in each command line is scanned to determine
356       if it is a non-source and non-target path and added to the list of implicit dependencies
357       for the target.
358     - Added support for taking instances of the Value class as implicit
359       dependencies.
360     - Added new module SCons.Scanner.Python to allow scanning .py files.
361     - Added support for explicitly passing a name when creating Value() nodes. This may be useful
362       when the value can't be converted to a string or if having a name is otherwise desirable.
363     - Fixed usage of abspath and path for RootDir objects on Windows. Previously
364       env.fs.Dir("T:").abspath would return "T:\T:" and now it correctly returns "T:".
366   From Ivan Kravets, PlatformIO
367     - New conditional C Scanner (`SCons.Scanner.C.CConditionalScanner()`)
368       which interprets C/C Preprocessor conditional syntax (#ifdef, #if, #else,
369       #elif, #define, etc.)
370     - Improvements for virtual C Pre-Processor:
371       * Handle UNSIGNED LONG and LONG numeric constants in DEC (keep support for HEX)
372       * Skip unrecognized directives, such as `#if( defined ...)`
373       * Ignore `#include DYNAMIC_INCLUDE` directive that depends on a dynamic
374         macro which is not located in a state TABLE.
375       * Cleanup CPP expressions before evaluating (strip comments, carriage returns)
377   From Iosif Kurazs:
378     - Added a new flag called "linedraw" for the command line argument  "--tree"
379       that instructs scons to use single line drawing characters to draw the dependency tree.
381   From Daniel Moody:
382     - Add no_progress (-Q) option as a set-able option. However, setting it in the
383       SConstruct/SConscript will still cause "scons: Reading SConscript files ..." to be
384       printed, since the option is not set when the build scripts first get read.
385     - Added check for SONAME in environment to setup symlinks correctly (Github Issue #3246)
386     - User callable's called during substition expansion could possibly throw a TypeError
387       exception, however SCons was using TypeError to detect if the callable had a different
388       signature than expected, and would silently fail to report user's exceptions. Fixed to
389       use signature module to detect function signature instead of TypeError. (Github Issue #3654)
390     - Added storage of SConstructs and SConscripts nodes into global set for checking
391       if a given node is a SConstruct/SConscript.
392       Added new node function SCons.Node.is_sconscript(self) (Github Issue #3625)
394   From Andrew Morrow:
395     - Fix Issue #3469 - Fixed improper reuse of temporary and compiled files by Configure when changing
396       the order and/or number of tests.  This is done by using the hash of the generated temporary files
397       content and (For the target files) the hash of the action.
398       So where previously files would be named:
399       - config_1.c, config_1.o, config_1
400       The will now be named (For example)
401       - conftest_68b375d16e812c43e6d72d6e93401e7c_0.c,
402         conftest_68b375d16e812c43e6d72d6e93401e7c_0_5713f09fc605f46b2ab2f7950455f187.o
403         or
404         conftest_68b375d16e812c43e6d72d6e93401e7c_0.o
405         conftest_68b375d16e812c43e6d72d6e93401e7c_0_5713f09fc605f46b2ab2f7950455f187 (for executable)
407   From Mathew Robinson:
408     - Improve performance of Subst by preventing unnecessary frame
409       allocations by no longer defining the *Subber classes inside of their
410       respective function calls.
411     - Improve performance of Subst in some cases by preventing
412       unnecessary calls to eval when a token is surrounded in braces
413       but is not a function call.
414     - Improve performance of subst by removing unnecessary recursion.
415     - Cleanup dangling symlinks before running builders (Issue #3516)
417   From Mats Wichmann:
418     - Remove deprecated SourceCode
419     - str.format syntax errors fixed
420     - a bunch of linter/checker syntax fixups
421     - Convert remaining uses of insecure/deprecated mktemp method.
422     - Clean up some duplications in manpage.  Clarify portion of manpage on Dir and File nodes.
423     - Reduce needless list conversions.
424     - Fixed regex in Python scanner.
425     - Accommodate VS 2017 Express - it's got a more liberal license then VS
426       Community, so some people prefer it (from 2019, no more Express)
427     - vswhere call should also now work even if programs aren't on the C: drive.
428     - Add an alternate warning message if cl.exe is not found and msvc config
429       cache is in use (SCONS_CACHE_MSVC_CONFIG was given) - config cache
430       may be out of date.
431     - Fixed bug where changing TEXTFILESUFFIX would cause Substfile() to rebuild. (Github Issue #3540)
432     - Script/Main.py now uses importlib instead of imp module.
433     - Drop some Python 2-isms.
434     - MSVC updates: pass on VSCMD_DEBUG and VSCMD_SKIP_SENDTELEMETRY to msvc
435       tool setup if set in environment. Add Powershell to default env
436       (used to call telemetry script).
437     - Microsoft Visual Studio - switch to using uuid module to generate GUIDs rather than hand rolled
438       method using md5 directly.
439       NOTE: This change affects the following builders' output. If your build depends on the output of these builders
440       you will likely see a rebuild.
441       * Package() (with PACKAGETYPE='msi')
442       * MSVSSolution()
443       * MSVSProject()
444     - Docbook builder provides a fallback if lxml fails to generate
445       a document with tostring().
446     - Fix description of ARCOMSTR constr. var. (issue 3636). Previously the text was a copy of ASCOMSTR which
447       has different function.
448     - Update xml files in SCons to reflect changed relative paths after
449       code restructuring (src/engine/SCons -> SCons)
450     - Preliminary Python 3.9 support - elimination of some warnings.
451     - Drop the with_metaclass jig which was designed to let class
452       definitions using a metaclass be written the same for Py2/Py3.
453     - Bump python_version_unsupported (and deprecated) to indicate 3.5
454       is lowest supported Python.
455     - ParseFlags should not modify the user's passed in dict in case it's
456       a compound data structure (e.g. values are lists) (issue #3665)
457     - In Py3 classes no longer need to be listed as deriving from object.
458     - Remove deprecated check for Task subclasses needing a needs_execute
459       method - this is now enforced via an abstract base class, so the
460       check and test is no longer needed.
461     - Close various logfiles (trace, cache, taskmastertrace, configure)
462       when done using atexit calls.
463     - Rebase forked copy of shutil.copytree to Python 3.7 stlib version.
464     - Significant rework of documentation: API docs are now generated
465       using Sphinx; manpage and user guide now use more "standard"
466       markup elements (which could facilitate later conversion to a
467       different doc format, should that choice be made); significant
468       rewordings in manpage.  Manpage Examples moved to an external
469       repository / website (scons-cookbook.readthedocs.io).
470     - Clean up test harness and tests' use of subdir, file_fixture and
471       dir_fixture.
472     - SubstitutionEnvironment and OverrideEnvironment now have keys()
473       and values() methods to better emulate a dict (already had items()).
474     - Rename internal Warning base class to SConsWarning to avoid any
475       possible confusion with Python's own Warning class.
478 RELEASE 3.1.2 - Mon, 17 Dec 2019 02:06:27 +0000
480   From Edoardo Bezzeccheri
481     - Added debug option "action_timestamps" which outputs to stdout the absolute start and end time for each target.
483   From Rob Boehne
484     - Fix suncxx tool (Oracle Studio compiler) when using Python 3.  Previously would throw an exception.
485       Resolved by properly handling tool version string output as unicode.
487   From Tim Gates
488     - Resolved a typo in engine.SCons.Tool
490   From Adam Gross:
491     - Resolved a race condition in multithreaded Windows builds with Python 2
492       in the case where a child process is spawned while a Python action has a
493       file open. Original author: Ryan Beasley.
494     - Added memoization support for calls to Environment.Value() in order to
495           improve performance of repeated calls.
498   From Jason Kenny
499     - Update Command() function to accept target_scanner, source_factory, and target_factory arguments.
500       This makes Command act more like a one-off builder.
502   From Ivan Kravets
503     - Added support for "-imacros" to ParseFlags
505   From Jacek Kuczera:
506     - Fix CheckFunc detection code for Visual 2019. Some functions
507       (e.g. memmove) were incorrectly recognized as not available.
509   From Jakub Kulik
510     - Fix stacktrace when using SCons with Python 3.5+ and SunOS/Solaris related tools.
512   From Philipp Maierhöfer:
513     - Avoid crash with UnicodeDecodeError on Python 3 when a Latex log file in
514       non-UTF-8 encoding (e.g. containing umlauts in Latin-1 encoding when
515       the fontenc package is included with \usepackage[T1]{fontenc}) is read.
517   From Mathew Robinson:
518     - Improved threading performance by ensuring NodeInfo is shared
519       across threads. Results in ~13% improvement for parallel builds
520       (-j# > 1) with many shared nodes.
521     - Improve performance of Entry.disambiguate() by making check for
522       most common case first, preventing unnecessary IO.
523     - Improved DAG walk performance by reducing unnecessary work when
524       there are no un-visited children.
526   From Mats Wichmann
527     - Replace instances of string find method with "in" checks where
528       the index from find() was not used.
529     - CmdStringHolder fix from issue #3428
530     - Turn previously deprecated debug options into failures:
531       --debug=tree, --debug=dtree, --debug=stree, --debug=nomemoizer.
532     - Experimental New Feature: Enable caching MSVC configuration
533       If SCONS_CACHE_MSVC_CONFIG shell environment variable is set,
534       SCons will cache the results of past calls to vcvarsall.bat to
535       a file; integrates with existing memoizing of such vars.
536       On vs2019 saves 5+ seconds per SCons invocation, which really
537       helps test suite runs.
538     - Remove deprecated SourceSignatures, TargetSignatures
539     - Remove deprecated Builder keywords: overrides and scanner
540     - Remove deprecated env.Copy
541     - Remove deprecated BuildDir plus SConscript keyword build_dir
542     - A number of documentation improvements.
545 RELEASE 3.1.1 - Mon, 07 Aug 2019 20:09:12 -0500
547   From William Deegan:
548     - Remove obsoleted references to DeciderNeedsNode which could cause crash when using --debug=explain
550   From Jason Kenny
551     - Add Fix and test for crash in 3.1.0 when using Decider('MD5-timestamp') and --debug=explain
553   From Ben Reed:
554     - Added -fmerge-all-constants to flags that get included in both CCFLAGS and LINKFLAGS.
556   From Mathew Robinson:
557     - Fix issue #3415 - Update remaining usages of EnvironmentError to SConsEnvironmentError
558       this patch fixes issues introduced in 3.1.0 where any of the
559       following would cause SCons to error and exit:
560         - CacheDir not write-able
561         - JSON encoding errors for CacheDir config
562         - JSON decoding errors for CacheDir config
565 RELEASE 3.1.0 - Mon, 20 Jul 2019 16:59:23 -0700
567   From Joseph Brill:
568     - Code to supply correct version-specifier argument to vswhere for
569       VS version selection.
571   From William Deegan:
572     - Enhanced --debug=explain output. Now the separate components of the dependency list are split up
573       as follows:
575       scons: rebuilding `file3' because:
576            the dependency order changed:
577            ->Sources
578            Old:xxx      New:zzz
579            Old:yyy      New:yyy
580            Old:zzz      New:xxx
581            ->Depends
582            ->Implicit
583            Old:/usr/bin/python  New:/usr/bin/python
584     - Fix Issue #3350 - SCons Exception EnvironmentError is conflicting with Python's EnvironmentError.
585     - Fix spurious rebuilds on second build for cases where builder has > 1 target and the source file
586       is generated. This was causing the > 1th target to not have it's implicit list cleared when the source
587       file was actually built, leaving an implicit list similar to follows for 2nd and higher target
588               ['/usr/bin/python', 'xxx', 'yyy', 'zzz']
589       This was getting persisted to SConsign and on rebuild it would be corrected to be similar to this
590               ['zzz', 'yyy', 'xxx', '/usr/bin/python']
591       Which would trigger a rebuild because the order changed.
592       The fix involved added logic to mark all shared targets as peers and then ensure they're implicit
593       list is all cleared together.
594     - Fix Issue #3349 - SCons Exception EnvironmentError is conflicting with Python's EnvironmentError.
595       Renamed to SConsEnvironmentError
596     - Fix Issue #3350 - mslink failing when too many objects.  This is resolved by adding TEMPFILEARGJOIN variable
597       which specifies what character to join all the argements output into the tempfile. The default remains a space
598       when mslink, msvc, or mslib tools are loaded they change the TEMPFILEARGJOIN to be a line separator (\r\n on win32)
599     - Fix performance degradation for MD5-timestamp decider.  NOTE: This changes the Decider() function arguments.
600       From:
601           def my_decider(dependency, target, prev_ni):
602       To:
603           def my_decider(dependency, target, prev_ni, repo_node):
604       Where repo_node is the repository (or other) node to use to check if the node is out of date instead of dependency.
606   From Peter Diener:
607     - Additional fix to issue #3135 - Also handle 'pure' and 'elemental' type bound procedures
608     - Fix issue #3135 - Handle Fortran submodules and type bound procedures
610   From Adam Gross:
611     - Upgraded and improved Visual Studio solution/project generation code using the MSVSProject builder.
612       - Added support for Visual Studio 2017 and 2019.
613       - Added support for the following per-variant parameters to the builder:
614         - cpppaths: Provides per-variant include paths.
615         - cppdefines: Provides per-variant preprocessor definitions.
617   From Michael Hartmann:
618     - Fix handling of Visual Studio Compilers to properly reject any unknown HOST_PLATFORM or TARGET_PLATFORM
620   From Bert Huijben:
621     - Added support for Visual Studio 2019 toolset.
623   From Mathew Robinson:
624     - Update cache debug output to include cache hit rate.
625     - No longer unintentionally hide exceptions in Action.py
626     - Allow builders and pseudo-builders to inherit from OverrideEnvironments
628   From Leonard de Ruijter:
629     - Add logic to derive correct version argument to vswhere
631   From Lukas Schrangl:
632     - Enable LaTeX scanner to find more than one include per line
634   From Mats Wichmann:
635     - scons-time takes more care closing files and uses safer mkdtemp to avoid
636       possible races on multi-job runs.
637     - Use importlib to dynamically load tool and platform modules instead of imp module
638     - sconsign: default to .sconsign.dblite if no filename is specified.
639       Be more informative in case of unsupported pickle protocol (py2 only).
640     - Fix issue #3336 - on Windows, paths were being added to PATH even if
641       tools were not found in those paths.
642     - More fixes for newer Java versions (since 9): handle new jdk directory
643       naming (jdk-X.Y instead of jdkX.Y) on Windows; handle two-digit major
644       version. Docstrings improved.
645     - Fixups for pylint: exception types, redefined functions,
646       globals, etc.  Some old code removed to resolve issues (hashlib is
647       always present on modern Pythons; no longer need the code for
648       2.5-and-earlier optparse). cmp is not a builtin function in Py3,
649       drop one (unused) use; replace one.  Fix another instance of
650       renaming to SConsEnvironmentError. Trailing whitespace.
651       Consistently use not is/in (if not x is y -> if x is not y).
652     - Add a PY3-only function for setting up the cachedir that should be less
653       prone to races. Add a hack to the PY2 version (from Issue #3351) to
654       be less prone to a race in the check for old-style cache.
655     - Fix coding error in docbook tool only exercised when using python lxml
656     - Recognize two additional GNU compiler header directory options in
657       ParseFlags: -iquote and -idirafter.
658     - Fix more re patterns that contain \ but not specified as raw strings
659       (affects scanners for D, LaTeX, swig)
662 RELEASE 3.0.5 - Mon, 26 Mar 2019 15:04:42 -0700
664   From William Deegan:
666     - Fix Issue #3283 - Handle using --config=force in combination with Decider('MD5-timestamp').
667       3.0.2 in fix for issue #2980 added that deciders can throw DeciderNeedsNode exception.
668       The Configure logic directly calls the decider when using --config=force but wasn't handling
669       that exception.  This would yield minimally configure tests using TryLink() not running and
670       leaving TypeError Nonetype exception in config.log
671     - Fix Issue #3303 - Handle --config=force overwriting the Environment passed into Configure()'s
672       Decider and not clearing it when the configure context is completed.
673     - Add default paths for yacc tool on windows to include cygwin, mingw, and chocolatey
674     - Fix issue #2799 - Fix mingw tool to respect SHCCCOMSTR, SHLINKCOMSTR and LDMODULECOMSTR
675     - Fix Issue #3329 - Add support for MS SDK V10.0A (which is commonly installed with VS2017)
676     - Fix Issue #3333 - Add support for finding vswhere under 32 bit windows installs.
678   From Maciej Kumorek:
679     - Update the MSVC tool to include the nologo flag by default in RCFLAGS
681 From Daniel Moody:
682     - Change the default for AppendENVPath to delete_existing=0, so path
683       order will not be changed, unless explicitly set (Issue #3276)
684     - Fixed bug which threw error when running SCons on windows system with no MSVC installed.
685     - Update link tool to convert target to node before accessing node member
686     - Update mingw tool to remove MSVC like nologo CCFLAG
687     - Add default paths for lex tool on windows to include cygwin, mingw, and chocolatey
688     - Add lex construction variable LEXUNISTD for turning off unix headers on windows
689     - Update lex tool to use win_flex on windows if available
691   From Mats Wichmann:
692     - Quiet open file ResourceWarnings on Python >= 3.6 caused by
693       not using a context manager around Popen.stdout
694     - Add the textfile tool to the default tool list
695     - Fix syntax on is/is not clauses: should not use with a literal
696     - Properly retrieve exit code when catching SystemExit
697     - scons-time now uses context managers around file opens
698     - Fix regex patterns that were not specified as raw strings
700   From Bernhard M. Wiedemann:
701     - Do not store build host+user name if reproducible builds are wanted
704 RELEASE 3.0.4 - Mon, 20 Jan 2019 22:49:27 +0000
706   From Mats Wichmann:
707     - Improve finding of Microsoft compiler: add a 'products' wildcard
708       in case 2017 Build Tools only is installed as it is considered a separate
709       product from the default Visual Studio
710     - Add TEMPFILESUFFIX to allow a customizable filename extension, as
711       described in the patch attached to issue #2431.
712     - scons.py and sconsign.py stopped working if script called as a symlink
713       to location in scons-local location.
714     - Fix issue running scons using a symlink to scons.py in an scons-local dir
715     - Doc updates around Default(), and the various *TARGETS variables.
717   From Daniel Moody:
718     - Improved support for VC14.1 and Visual Studio 2017, as well as arm and arm64 targets.
719       Issues #3268 & Issue #3222
720     - Initial support for ARM targets with Visual Studio 2017 - Issue #3182 (You must set TARGET_ARCH for this to work)
721     - Update TempFileMunge class to use PRINT_CMD_LINE_FUNC
723   From Tobias Herzog
724     - Enhance cpp scanner regex logic to detect if/elif expressions without whitespaces but
725       parenthesis like "#if(defined FOO)" or "#elif!(BAR)" correctly.
728 RELEASE 3.0.3 - Mon, 07 Jan 2019 20:05:22 -0400
729   NOTE: 3.0.2 release was dropped because there was a packaging bug. Please consider all 3.0.2
730         content.
732   From William Deegan:
733     - Fixes to packaging logic.  Ensuring the SCons.Tool.clangCommon module is added
734       to the release packages.
735     - Modify scons.bat script to check for scons python script without .py extension if no file
736       scons.py exists. This enables an all platform wheel to work.
738   From Mats Wichmann:
739     - Update doc examples to work with Python 3.5+:  map() now returns an iterable instead of a list.
742 RELEASE 3.0.2 - Mon, 31 Dec 2018 16:00:12 -0700
744   From Bernard Blackham:
745     - Fixed handling of side-effects in task master (fixes #3013).
747   From William Deegan:
748     - Remove long deprecated SCons.Options code and tests.  This removes BoolOption,EnumOption,
749       ListOption,PackageOption, and PathOption which have been replaced by *Variable() many years ago.
750     - Re-Enable parallel SCons (-j) when running via Pypy
751     - Move SCons test framework files to testing/framework and remove all references to QMtest.
752       QMTest has not been used by SCons for some time now.
753     - Updated logic for mingw and clang on win32 to search default tool install paths if not
754       found in normal SCons PATH.  If the user specifies PATH or tool specific paths they
755       will be used and the default paths below will be ignored.
756       - Default path for clang/clangxx : C:\Program Files\LLVM\bin
757       - Default path for mingw         : C:\MinGW\bin and/or  C:\mingw-w64\*\mingw64\bin
758       - Key program to locate mingw    : mingw32-make (as the gcc with mingw prefix has no fixed name)
759     - Fixed issue causing stack trace when python Action function contains a unicode string when being
760       run with Python 2.7
761     - Add alternate path to QT install for Centos in qt tool: /usr/lib64/qt-3.3/bin
762     - Fix Java tools to search reasonable default paths for Win32, Linux, macOS.  Add required paths
763       for swig and java native interface to JAVAINCLUDES.  You should add these to your CPPPATH if you need
764       to compile with them.  This handles spaces in paths in default Java paths on windows.
765     - Added more java paths to match install for Centos 7 of openjdk
766     - Fix new logic which populates JAVAINCLUDES to handle the case where javac is not found.
767     - Fix GH Issue #2580 - # in FRAMEWORKPATH doesn't get properly expanded. The # is left in the
768       command line.
769     - Fix issue #2980 with credit to Piotr Bartosik (and William Blevins).  This is an issue where using
770       TimeStamp-MD5 Decider and CacheDir can yield incorrect md5's being written into the .sconsign.
771       The difference between Piotr Bartosik's patch and the current code is that the more complicated
772       creation of file to csig map is only done when the count of children for the current node doesn't
773       match the previous count which is loaded from the sconsign.
774     - Fix issue # 3106 MSVC if using MSVC_BATCH and target dir had a space would fail due to quirk in
775       MSVC's handling of escaped targetdirs when batch compiling.
776     - Fix GH Issue #3141 unicode string in a TryAction() with python 2.7 crashes.
777     - Fix GH Issue #3212 - Use of Py3 and CacheDir + Configure's TryCompile (or likely and Python Value Nodes)
778       yielded trying to combine strings and bytes which threw exception.
779     - Fix GH Issue #3225 SCons.Util.Flatten() doesn't handle MappingView's produced by dictionary as return
780       values from dict().{items(), keys(), values()}.
781     - Fix GH Issue #3241 - Properly support versioned shared libraries for MacOS.  We've also introduced two
782       new env variables APPLELINK_CURRENT_VERSION and APPLELINK_COMPATIBILITY_VERSION which will specify
783       what is passed to the linkers -current_version and -compatibility_version flags.  If not specified
784       they will be derived from SHLIBVERSION as such:
785       - APPLELINK_CURRENT_VERSION = SHLIBVERSION
786       - APPLELINK_COMPATIBILITY_VERSION = all but the last digit in SHLIBVERSION with .0 appended.
787       Note that the values of the above will be validated. Valid format for either APPLELINK variable is
788       X[.Y[.Z]] where 0 <= X <= 65535, 0 <= Y <= 255, 0 <= Z <= 255.
789       The new variables have been added to the documents and should show up in user guide and manpage.
790     - Fix GH Issue #3136 no longer wrap io.{BufferedReader,BufferedWriter,BufferedRWPair,BufferedRandom,TextIOWrapper
791       with logic to set HANDLE_FLAG_INHERIT flag on the file handle.  Python 3.4+ automatically sets this according
792       to Python docs: https://docs.python.org/3/library/os.html#fd-inheritance
794   From Ray Donnelly:
795     - Fix the PATH created by scons.bat (and other .bat files) to provide a normalized
796       PATH.  Some pythons in the 3.6 series are no longer able to handle paths which
797       have ".." in them and end up crashing.  This is done by cd'ing into the directory
798       we want to add to the path and then using %CD% to give us the normalized directory
799       See bug filed under Python 3.6: https://bugs.python.org/issue32457.
800       Note: On Win32 PATH's which have not been normalized may cause undefined behavior
801       by other executables being run by SCons (or any subprocesses of executables being run by SCons).
802       Resolving this issue should eliminate that possibility going forward.
804   From Andrew Featherstone
805     - Removed unused --warn options from the man page and source code.
807   From Arda Fu
808     - Fix cpp scanner regex logic to treat ifndef for py3.5+. Previously it was
809       not properly differentiating between if, ifdef, and ifndef.
811   From Philipp Maierhöfer
812     - Added a __hash__ method to the class SCons.Subst.Literal. Required when substituting Literal
813       objects when SCons runs with Python 3.
814     - Added missing FORTRANMODDIRPREFIX to the gfortran tool.
816   From Matthew Marinets:
817     - Fixed an issue that caused the Java emitter to incorrectly parse arguments to constructors that
818       implemented a class.
820   From Fredrik Medley:
821     - Fix exception when printing of EnviromentError messages.
822       Specifically, this fixes error reporting of the race condition when
823       initializing the cache which error previously was hidden.
825   From Daniel Moody:
826     - Updated Jar builder to handle nodes and directories better
827     - Updated Jar builder to flatten source list which could contain embedded lists
828     - Removed some magic numbers from jar.py on behalf of Mats Wichmann (mats@linux.com)
829     - Set the pickling protocal back to highest which was causing issues
830       with variant dir tests. This will cause issues if reading sconsigns
831       pickled with the previous lower protocol.
832     - Updated swig to setup default paths for windows
833     - Updated gettext tools to setup default paths for windows with Cygwin/MinGW setups
834     - Add common location for default paths for cygwin and mingw in Platform modules
835     - Updated YACC tool to work on windows with Cygwin/MinGW setups
836     - Set the pickling protocal back to highest which was causing issues
837       with variant dir tests. This will cause issues if reading sconsigns
838       pickled with the previous lower protocol.
839     - Updated FS.py to handle removal of splitunc function from python 3.7
840     - Updated the vc.py to ignore MSVS versions where no compiler could be found
842   From Gary Oberbrunner:
843     - Fix bug when Installing multiple subdirs outside the source tree
844     - fix to_str to handle None without raising exception
845     - Fix -jN for python 3.7
847   From Jonathon Reinhart:
848     - Replace all instances of `int main()` in C code with `int main(void)`.
849       Specifically, this fixes the test cases use by Configure.CheckCC() which
850       would fail when using -Wstrict-prototypes.
852   From Zachary Tessler:
853     - Fix calculation of signatures for FunctionActions that contain list (or set,...)
854       comprehensions whose expressions involve constant literals. Those constants had
855       been ignored in signatures, so changing them did not cause targets to be rebuilt.
857   From Paweł Tomulik:
858     - In the testing framework, module TestCommon, fixed must_contain(),
859       must_not_contain(), and related methods of TestCommon class to work with
860       substrings located at zero offset.
861     - Added virtualenv support. A new function Virtualenv() determines whether
862       SCons runs in a virtualenv. The search PATH may also be extended to
863       prefer executables from the current virtualenv over the ones provided by
864       base environment. New option --enable-virtualenv provided to import some
865       virtualenv-related variables to SCons and extend every env['ENV']['PATH']
866       automatically. New option --ignore-virtualenv disables this. Two
867       environment variables, SCONS_ENABLE_VIRTUALENV and
868       SCONS_IGNORE_VIRTUALENV are supported for the same purpose.
870   From Richard West:
871     - Add SConstruct.py, Sconstruct.py, sconstruct.py to the search path for the root SConstruct file.
872       Allows easier debugging within Visual Studio
873     - Change setup.py to change the install directory (via  pip, or setup.py install) from scons-#.#.#
874       to scons (Yielding <pythondir>/lib/scons/SCons/ instead of <pythondir>/lib/scons/SCons-#.#.#/).
875       This changes SCons to better comply with normal Python installation practices.
877   From Mats Wichmann:
878     - Recognize new java 9, 10, 11 (as 9.0 and 10.0, 11.0)
879     - Updated manpage scons.xml to fix a nested list problem
880     - Updated doc terminiology: use prepend instead of append as appropriate
881     - XML validity fixes from SConstruct.py change
882     - Update wiki links to new github location
883     - Update bug links to new github location
884     - Make it easier for SConscript() call to fail on missing script.
885       It was possible to call SCons.Warnings.warningAsException
886       (not documented as a user API) to make all warnings fail. Now
887       SConscript can take an optional must_exist flag which if true fails
888       if the script does not exist.  Not failing on missing script is
889       now considered deprecated, and the first instance will print a
890       deprecation message.  It is now also possible to flip the scons
891       behavior (which still defaults to warn, not fail) by calling
892       SCons.Script.set_missing_sconscript_error, which is also not a
893       documented interface at the moment.
894     - Convert TestCmd.read to use with statement on open (quiets 17 py3 warnings)
895     - Quiet py3 warning in UtilTests.py
896     - Fix tests specifying octal constants for py3
897     - Fix must_contain tests for py3
898     - RPM package generation:
899        - Fix supplying a build architecture
900        - Disable auto debug package generation on certain rpmbuild versions
901        - Adjust some tests to only supply build-id file on certain rpmbuild versions
902        - Tests now use a file fixture for the repeated (trivial) main.c program.
903        - Document and comment cleanup.
904        - Added new Environment Value X_RPM_EXTRADEFS to supply custom settings
905          to the specfile without adding specific logic for each one to scons.
906     - The test for Python.h needed by swig tests is moved to get_python_platform
907       so it does not have to be repeated in every test; picks up one failure
908       which did not make the (previously needed) check. Windows version
909       of get_python_platform needed some rework in case running in virtualenv.
910     - If test opens os.devnull, register with atexit so file opens do not leak.
911     - Fix bugs in Win32 process spawn logic to handle OSError exception correctly.
912     - Use time.perf_counter instead of time.clock if it exists.
913       time.clock deprecated since py3.3, due to remove in 3.8. deprecation
914       warnings from py3.7 were failing a bunch of tests on Windows since they
915       mess up expected stderr.
916     - Prefer Py3's inspect.getfullargspec over deprecated inspect.getargspec.
917       Switched to "new" (standard in Py2.7) usage of receiving a namedtuple -
918       we were unpacking to a four-tuple, two of the items of which were unused;
919       getfullargspec returns a named tuple with seven elements so it is a
920       cleaner drop-in replacement using the namedtuple.
921     - Updated the test-framework.rst documentation.
922     - Remove obsoleted internal implementaiton of OrderedDict.
923     - Test for tar packaging fixups
924     - Stop using deprecated unittest asserts
925     - messages in strip-install-dir test now os-neutral
926     - Add xz compression format to packaging choices.
927     - Syntax cleanups - trailing blanks, use "is" to compare with None, etc.
928       Three uses of variables not defined are changed.
929     - Some script changes in trying to find scons engine
930     - Update (pep8) configure-cache script, add a --show option.
931     - Fix for a couple of "what if tool not found" exceptions in framework.
932     - Add Textfile/Substfile to default environment. (issue #3147)
933     - sconsign: a couple of python3 fixes; be more tolerant of implicit
934       entries which have no signatures; minor PEP8 changes.
935     - Fix a couple of type mistakes (list-> string, filter type -> list)
936     - Fix a couple of type mistakes in packaging tools: list-> string in msi,
937       filter type -> list in ipk
939   From Bernhard M. Wiedemann:
940     - Update SCons' internal scons build logic to allow overriding build date
941       with SOURCE_DATE_EPOCH for SCons itself.
942     - Change the datestamps in SCons' docs and embedded in code use ISO 8601 format and UTC
944   From Hao Wu
945     - Typo in customized decider example in user guide
946     - Replace usage of unittest.TestSuite with unittest.main() (fix #3113)
948 RELEASE 3.0.1 - Mon, 12 Nov 2017 15:31:33 -0700
950   From Daniel Moody:
951     - Jar can take multiple targets, and will make a duplicate jar from the sources for each target
952     - Added some warnings in case the Jar builder makes an implicit target
953     - Added Jar method and changed jar build to be more specific. Jar method will take in
954       directories or classes as source. Added more tests to JAR to ensure the jar was
955       packaged with the correct compiled class files.
956     - Added a No result test case to handle bug which seems unrelated to java in the
957       swig-dependencies.py test, more info here: http://scons.tigris.org/issues/show_bug.cgi?id=2907
958     - Added a travis script to test on ubuntu trusty now that the project is on github
959       so that Continuus Integration tests can be run automatically. It tests most case and considers
960       no result a pass as well. Improving this script can install more dependincies allowing for more
961       tests to be run.
963   From Daniel Moody:
964     - Updated the Jar Builder tool in Tool/__init__.py so that is doesn't force class files as
965       sources, allowing directories to be passed, which was causing test/Java/JAR.py to fail.
967   From William Deegan:
968     - Fix issue where code in utility routine to_String_for_subst() had code whose result was never
969       properly returned.
970       (Found by: James Rinkevich https://pairlist4.pair.net/pipermail/scons-users/2017-October/006358.html )
971     - Fixed Variables.GenerateHelpText() to now use the sort parameter. Due to incorrect 2to3 fixer changes
972       8 years ago it was being used as a boolean parameter.  Now you can specify sort to be a callable, or boolean
973       value. (True = normal sort). Manpage also updated.
974     - Fixed Tool loading logic from exploding sys.path with many site_scons/site_tools prepended on py3.
975     - Added additional output with time to process each SConscript file when using --debug=time.
977   From Thomas Berg:
978     - Fixed a regression in scons-3.0.0 where "from __future__ import print_function" was imposed
979       on the scope where SConstruct is executed, breaking existing builds using PY 2.7.
981   From William Deegan:
982     - Fix broken subst logic where a string with "$$(abc)" was being treated as "$(abc) and the
983       logic for removing the signature escapes was then failing because there was no closing "$)".
984       This was introduced by a pull request to allow recursive variable evaluations to yield a string
985       such as "$( $( some stuff $) $)".
987   From Zachary Tessler:
988     - Fix incorrect warning for repeated identical builder calls that use overrides
991 RELEASE 3.0.0 - Mon, 18 Sep 2017 08:32:04 -0700
993 NOTE: This is a major release.  You should expect that some targets may rebuild when upgrading.
994 Significant changes in some python action signatures. Also switching between PY 2.7 and PY 3.5, 3.6
995 will cause rebuilds.
998   From William Blevins:
999     - Updated D language scanner support to latest: 2.071.1. (PR #1924)
1000       https://dlang.org/spec/module.html accessed 11 August 2016
1001       - Enhancements:
1002         - Added support for selective imports: "import A : B, C;" -> A
1003         - Added support for renamed imports. "import B = A;" -> A
1004         - Supports valid combinations: "import A, B, CCC = C, DDD = D : EEE = FFF;" -> A, B, C, D
1005       - Notes:
1006         - May find new (previously missed) Dlang dependencies.
1007         - May cause rebuild after upgrade due to dependency changes.
1008     - Updated Fortran-related tests to pass under GCC 5/6.
1009     - Fixed SCons.Tool.Packaging.rpm.package source nondeterminism across builds.
1011   From William Deegan:
1012     - Removed deprecated tools CVS, Perforce, BitKeeper, RCS, SCCS, Subversion.
1013     - Removed deprecated module SCons.Sig
1014     - Added prioritized list of xsltproc tools to docbook. The order will now be as
1015       follows: xsltproc, saxon, saxon-xslt, xalan  (with first being highest priority, first
1016       tool found is used)
1017     - Fixed MSVSProject example code (http://scons.tigris.org/issues/show_bug.cgi?id=2979)
1018     - Defined MS SDK 10.0 and Changed VS 2015 to use SDK 10.0
1019     - Changes to Action Function and Action Class signiture creation.  NOTE: This will cause rebuilds
1020       for many builds when upgrading to SCons 3.0
1021     - Fixed Bug #3027 - "Cross Compiling issue: cannot override ranlib"
1022     - Fixed Bug #3020 - "Download link in user guide wrong. python setup.py install --version-lib broken"
1023     - Fixed Bug #2486 - Added SetOption('silent',True) - Previously this value was not allowed to be set.
1024     - Fixed Bug #3040 - Non-unicode character in CHANGES.txt
1025     - Fixed Bug #2622 - AlwaysBuild + MSVC regression.
1026     - Fixed Bug #3025 - (Credit to Florian : User flow86 on tigris) - Fix typo JAVACLASSSUFIX should have been
1027                         JAVACLASSSUFFIX
1030   From Ibrahim Esmat:
1031     - Added the capability to build Windows Store Compatible libraries that can be used
1032       with Universal Windows Platform (UWP) Apps and published to the store
1034   From Daniel Holth:
1035     - Add basic support for PyPy (by deleting __slots__ from Node with a
1036       metaclass on PyPy); wrap most-used open() calls in 'with' statements to
1037       avoid too many open files.
1038     - Add __main__.py for `python -m SCons` in case it is on PYTHONPATH.
1039     - Always use highest available pickle protocol for efficiency.
1040     - Remove unused command line fallback for the zip tool.
1042   From Gaurav Juvekar:
1043     - Fix issue #2832: Expand construction variables in 'chdir' argument of builders. (PR #463)
1044     - Fix issue #2910: Make --tree=all handle Unicode. (PR #427)
1045     - Fix issue #2788: Fix typo in documentation example for sconf. (PR #388)
1047   From Alexey Klimkin:
1048     - Use memoization to optimize PATH evaluation across all dependencies per
1049       node. (PR #345)
1050     - Use set() where it is applicable (PR #344)
1052   From M. Limber:
1053     - Fixed msvs.py for Visual Studio Express editions that would report
1054       "Error  : ValueError: invalid literal for float(): 10.0Exp".
1056   From Rick Lupton:
1057     - Update LaTeX scanner to understand \import and related commands
1059   From Steve Robinson:
1060     - Add support for Visual Studio 2017.  This support requires vswhere.exe a helper
1061       tool installed with newer installs of 2017. SCons expects it to be located at
1062       "C:\Program Files (x86)\Microsoft Visual Studio\Installer\vswhere.exe"
1063       It can be downloaded separately at
1064       https://github.com/Microsoft/vswhere
1066   From Tom Tanner:
1067     - Allow nested $( ... $) sections
1069   From Paweł Tomulik:
1070     - Fixed the issue with LDMODULEVERSIONFLAGS reported by Tim Jenness
1071       (https://pairlist4.pair.net/pipermail/scons-users/2016-May/004893.html).
1072       An error was causing "-Wl,Bsymbolic" being added to linker's command-line
1073       even when there was no specified value in LDMODULEVERSION and thus no
1074       need for the flags to be specified.
1075     - Added LoadableModule to the list of global functions (DefaultEnvironment
1076       builders).
1078   From Manish Vachharajani:
1079     - Update debian rules, compat, and control to not use features
1080       deprecated or obsolete in later versions of debhelpers
1081     - Update python version to 2.7 in debian/control
1083   From Richard Viney:
1084     - Fixed PCHPDBFLAGS causing a deprecation warning on MSVC v8 and later when
1085       using PCHs and PDBs together.
1088   From Richard West:
1089     - Added nested / namespace tool support
1090     - Added a small fix to the python3 tool loader when loading a tool as a package
1091     - Added additional documentation to the user manual on using toolpaths with the environment
1092       This includes the use of sys.path to search for tools installed via pip or package managers
1093     - Added support for a PyPackageDir function for use with the toolpath
1095   From Russel Winder:
1096     - Reordered the default D tools from "dmd, gdc, ldc" to "dmd, ldc, gdc".
1097     - Add a ProgramAllAtOnce builder to the dmd, ldc, and gdc tools. (PR #448)
1098     - Remove a file name exception for very old Fedora LDC installation.
1099     - gdc can now handle building shared objects (tested for version 6.3.0).
1100     - Remove establishing the SharedLibrary builder in the dmd, ldc, and gdc
1101       tools, must now include the ar tool to get this builder as is required for
1102       other compiler tools.
1103     - Add clang and clang++ tools based on Paweł Tomulik's work.
1105 RELEASE 2.5.1 - Mon, 03 Nov 2016 13:37:42 -0400
1107   From William Deegan:
1108     - Add scons-configure-cache.py to packaging. It was omitted
1110   From Alexey Klimkin:
1111     - Use memoization to optimize PATH evaluation across all dependencies per
1112       node. (PR #345)
1114 RELEASE 2.5.0 - Mon, 09 Apr 2016 11:27:42 -0700
1116   From Dirk Baechle:
1117     - Removed a lot of compatibility methods and workarounds
1118       for Python versions < 2.7, in order to prepare the work
1119       towards a combined 2.7/3.x version. (PR #284)
1120       Also fixed the default arguments for the print_tree and
1121       render_tree methods. (PR #284, too)
1123   From William Blevins:
1124     - Added support for cross-language dependency scanning;
1125       SCons now respects scanner keys for implicit dependencies.
1126       - Notes for SCons users with heterogeneous systems.
1127         - May find new (previously missed) dependencies.
1128         - May cause rebuild after upgrade due to dependency changes.
1129         - May find new dependency errors (EG. cycles).
1130           - Discovered in some of the SCons QT tests.
1131     - Resolved missing cross-language dependencies for
1132       SWIG bindings (fixes #2264).
1133     - Corrected typo in User Guide for Scanner keyword. (PR #2959)
1134     - Install builder interacts with scanner found in SCANNERS differently.
1135       - Previous: Install builder recursively scanned implicit dependencies
1136         for scanners from SCANNER, but not for built-in (default) scanners.
1137       - Current: Install builder will not scan for implicit dependencies via
1138         either scanner source. This optimizes some Install builder behavior
1139         and brings orthogonality to Install builder scanning behavior.
1141   From William Deegan:
1142     - Add better messaging when two environments have
1143       different actions for the same target (Bug #2024)
1144     - Fix issue only with MSVC and Always build where targets
1145       marked AlwaysBuild wouldn't make it into CHANGED_SOURCES
1146       and thus yield an empty compile command line. (Bug #2622)
1147     - Fix posix platform escaping logic to properly handle paths
1148       with parens in them "()".  (Bug #2225)
1150   From Jakub Pola:
1151     - Intel Compiler 2016 (Linux/Mac) update for tool directories.
1153   From Adarsh Sanjeev:
1154     - Fix for issue #2494: Added string support for Chmod function.
1156   From Tom Tanner:
1157     - change cache to use 2 character subdirectories, rather than one character,
1158       so as not to give huge directories for large caches, a situation which
1159       causes issues for NFS.
1160       For existing caches, you will need to run the scons-configure-cache.py
1161       script to update them to the new format. You will get a warning every time
1162       you build until you co this.
1163     - Fix a bunch of unit tests on windows
1165 RELEASE 2.4.1 - Mon, 07 Nov 2015 10:37:21 -0700
1167   From Arfrever Frehtes Taifersar Arahesis:
1168     - Fix for Bug # 2791 - Setup.py fails unnecessarily under Jython.
1170   From Dirk Baechle:
1171     - Fixed license of SVG titlepage files in the context of Debian
1172       packaging, such that they allow for commercial use too (#2985).
1174   From William Blevins:
1175     - InstallVersionedLib now available in the DefaultEnvironment context.
1176     - Improves orthogonality of use cases between different Install functions.
1178   From Carnë Draug:
1179     - Added new configure check, CheckProg, to check for
1180       existence of a program.
1182   From Andrew Featherstone:
1183     - Fix for issue #2840 - Fix for two environments specifying same target with different
1184       actions not throwing hard error. Instead SCons was incorrectly issuing a warning
1185       and continuing.
1187   From Hiroaki Itoh :
1188     - Add support `Microsoft Visual C++ Compiler for Python 2.7'
1189       Compiler can be obtained at: https://www.microsoft.com/en-us/download/details.aspx?id=44266
1191   From Florian Miedniak:
1192     - Fixed tigris issue #3011: Glob() excludes didn't work when used with VariantDir(duplicate=0)
1194   From William Roberts:
1195     - Fix bug 2831 and allow Help() text to be appended to AddOption() help.
1197   From Paweł Tomulik:
1198     - Reimplemented versioning for shared libraries, with the following effects
1199     - Fixed tigris issues #3001, #3006.
1200     - Fixed several other issues not reported to tigris, including:
1201       issues with versioned libraries in subdirectories with tricky names,
1202       issues with versioned libraries and variant directories,
1203       issue with soname not being injected to library when using D linkers,
1204     - Switched to direct symlinks instead of daisy-chained ones -- soname and
1205       development symlinks point directly to the versioned shared library now),
1206       for rationale see:
1207       https://www.debian.org/doc/debian-policy/ch-sharedlibs.html
1208       https://fedoraproject.org/wiki/Packaging:Guidelines#Devel_Packages
1209       https://bitbucket.org/scons/scons/pull-requests/247/new-versioned-libraries-gnulink-cyglink/diff#comment-10063929
1210     - New construction variables to allow override default behavior: SONAME,
1211       SHLIBVERSIONFLAGS, _SHLIBVERSIONFLAGS, SHLIBNOVERSIONSYMLINKS,
1212       LDMODULEVERSION, LDMODULEVERSIONFLAGS, _LDMODULEVERSIONFLAGS,
1213       LDMODULENOVERSIONSYMLINKS.
1214     - Changed logic used to configure the versioning machinery from
1215       platform-centric to linker-oriented.
1216     - The SHLIBVERSION/LDMODULEVERSION variables are no longer validated by
1217       SCons (more freedom to users).
1218     - InstallVersionedLib() doesn't use SHLIBVERSION anymore.
1219     - Enchanced docs for the library versioning stuff.
1220     - New tests for versioned libraries.
1221     - Library versioning is currently implemented for the following linker
1222       tools: 'cyglink', 'gnulink', 'sunlink'.
1223     - Fix to swig tool - pick-up 'swig', 'swig3.0' and 'swig2.0' (in order).
1224     - Fix to swig tool - respect env['SWIG'] provided by user.
1228 RELEASE 2.4.0 - Mon, 21 Sep 2015 08:56:00 -0700
1230   From Dirk Baechle:
1231     - Switched several core classes to use "slots", to
1232       reduce the overall memory consumption in large
1233       projects (fixes #2180, #2178, #2198)
1234     - Memoizer counting uses decorators now, instead of
1235       the old metaclasses approach.
1237   From Andrew Featherstone
1238     - Fixed typo in SWIGPATH description
1240 RELEASE 2.3.6 - Mon, 31 Jul 2015 14:35:03 -0700
1242   From Rob Smith:
1243     - Added support for Visual Studio 2015
1245 RELEASE 2.3.5 - Mon, 17 Jun 2015 21:07:32 -0700
1247   From Stephen Pollard:
1248     - Documentation fixes for libraries.xml and
1249       builders-writing.xml (#2989 and #2990)
1251   From William Deegan:
1252     - Extended docs for InstallVersionedLib/SharedLibrary,
1253       and added SKIP_WIN_PACKAGES argument to build script
1254       bootstrap.py (PR #230, #3002).
1256   From William Blevins:
1257     - Fixed symlink support (PR #227, #2395).
1258     - Updated debug-count test case (PR #229).
1260   From Alexey Klimkin:
1261     - Fixed incomplete LIBS flattening and substitution in
1262       Program scanner(PR #205, #2954).
1264   From Dirk Baechle:
1265     - Added new method rentry_exists_on_disk to Node.FS (PR #193).
1267   From Russel Winder:
1268     - Fixed several D tests under the different OS.
1269     - Add support for f08 file extensions for Fortran 2008 code.
1271   From Anatoly Techtonik:
1272     - Show --config choices if no argument is specified (PR #202).
1273     - Fixed build crash when XML toolchain isn't installed, and
1274       activated compression for ZIP archives.
1276   From Alexandre Feblot:
1277     - Fix for VersionedSharedLibrary under 'sunos' platform.
1278     - Fixed dll link with precompiled headers on MSVC 2012
1279     - Added an 'exclude' parameter to Glob()
1281   From Laurent Marchelli:
1282     - Support for multiple cmdargs (one per variant) in VS project files.
1283     - Various improvements for TempFileMunge class.
1284     - Added an implementation for Visual Studio users files (PR #209).
1286   From Dan Pidcock:
1287     - Added support for the 'PlatformToolset' tag in VS project files (#2978).
1289   From James McCoy:
1290     - Added support for '-isystem' to ParseFlags.
1292 RELEASE 2.3.4 - Mon, 27 Sep 2014 12:50:35 -0400
1294   From Bernhard Walle and Dirk Baechle:
1295     - Fixed the interactive mode, in connection with
1296       Configure contexts (#2971).
1298   From Anatoly Techtonik:
1299     - Fix EnsureSConsVersion warning when running packaged version
1301   From Russel Winder:
1302     - Fix D tools for building shared libraries
1304 RELEASE 2.3.3 - Sun, 24 Aug 2014 21:08:33 -0400
1306   From Roland Stark:
1307     - Fixed false line length calculation in the TempFileMunge class (#2970).
1309   From Gary Oberbrunner:
1310     - Improve SWIG detection
1312   From Russel Winder:
1313     - Fix regression on Windows in D language update
1315   From Neal Becker and Stefan Zimmermann:
1316     - Python 3 port and compatibility
1318   From Anatoly Techtonik:
1319     - Do not fail on EnsureSConsVersion when running from checkout
1321   From Kendrick Boyd and Rob Managan:
1322     - Fixed the newglossary action to work with VariantDir (LaTeX).
1324   From Manuel Francisco Naranjo:
1325     - Added a default for the BUILDERS environment variable,
1326       to prevent not defined exception on a Clone().
1328   From Andrew Featherstone:
1329     - Added description of CheckTypeSize method (#1991).
1330     - Fixed handling of CPPDEFINE var in Append()
1331       for several list-dict combinations (#2900).
1333   From William Blevins:
1334     - Added test for Java derived-source dependency tree generation.
1335     - Added Copy Action symlink soft-copy support (#2395).
1336     - Various contributions to the documentation (UserGuide).
1338 RELEASE 2.3.2
1340   From Dirk Baechle:
1341     - Update XML doc editor configuration
1342     - Fix: Allow varlist to be specified as list of strings for Actions (#2754)
1344   From veon on bitbucket:
1345     - Fixed handling of nested ifs in CPP scanner PreProcessor class.
1347   From Shane Gannon:
1348     - Support for Visual Studio 2013 (12.0)
1350   From Michael Haubenwallner:
1351     - Respect user's CC/CXX values; don't always overwrite in generate()
1352     - Delegate linker Tool.exists() to CC/CXX Tool.exists().
1354   From Rob Managan:
1355     - Updated the TeX builder to support use of the -synctex=1
1356       option and the files it creates.
1357     - Updated the TeX builder to correctly clean auxiliary files when
1358       the biblatex package is used.
1360   From Gary Oberbrunner:
1361     - get default RPM architecture more robustly when building RPMs
1363   From Amir Szekely:
1364     - Fixed NoClean() for multi-target builders (#2353).
1366   From Paweł Tomulik:
1367     - Fix SConf tests that write output
1369   From Russel Winder:
1370     - Revamp of the D language support. Tools for DMD, GDC and LDC provided
1371       and integrated with the C and C++ linking. NOTE: This is only tested
1372       with D v2. Support for D v1 is now deprecated.
1374   From Anatoly Techtonik:
1375     - Several improvements for running scons.py from source:
1376       * engine files form source directory take priority over all other
1377         importable versions
1378       * message about scons.py running from source is removed to fix tests
1379         that were failing because of this extra line in the output
1380       * error message when SCons import fails now lists lookup paths
1381     - Remove support for QMTest harness from runtest.py
1382     - Remove RPM and m4 from default tools on Windows
1383     - BitKeeper, CVS, Perforce, RCS, SCCS are deprecated from default
1384       tools and will be removed in future SCons versions to speed up
1385       SCons initialization (it will still be possible to use these tools
1386       explicitly)
1388   From Sye van der Veen:
1389     - Support for Visual Studio 12.0Exp, and fixes for earlier MSVS
1390       versions.
1393 RELEASE 2.3.1
1395   From Andrew Featherstone:
1396     - Added support for EPUB output format to the DocBook tool.
1398   From Tom Tanner:
1399     - Stop leaking file handles to subprocesses by switching to using subprocess
1400       always.
1401     - Allow multiple options to be specified with --debug=a,b,c
1402     - Add support for a readonly cache (--cache-readonly)
1403     - Always print stats if requested
1404     - Generally try harder to print out a message on build errors
1405     - Adds a switch to warn on missing targets
1406     - Add Pseudo command to mark targets which should not exist after
1407       they are built.
1409   From Bogdan Tenea:
1410     - Check for 8.3 filenames on cygwin as well as win32 to make variant_dir work properly.
1412   From Alexandre Feblot:
1413     - Make sure SharedLibrary depends on all dependent libs (by depending on SHLINKCOM)
1415   From Stefan Sperling:
1416     - Fixed the setup of linker flags for a versioned SharedLibrary
1417       under OpenBSD (#2916).
1419   From Antonio Cavallo:
1420     - Improve error if Visual Studio bat file not found.
1422   From Manuel Francisco Naranjo:
1423     - Allow Subst.Literal string objects to be compared with each other,
1424       so they work better in AddUnique() and Remove().
1426   From David Rothenberger:
1427     - Added cyglink linker that uses Cygwin naming conventions for
1428       shared libraries and automatically generates import libraries.
1430   From Dirk Baechle:
1431     - Update bootstrap.py so it can be used from any dir, to run
1432       SCons from a source (non-installed) dir.
1433     - Count statistics of instances are now collected only when
1434       the --debug=count command-line option is used (#2922).
1435     - Added release_target_info() to File nodes, which helps to
1436       reduce memory consumption in clean builds and update runs
1437       of large projects.
1438     - Fixed the handling of long options in the command-line
1439       parsing (#2929).
1440     - Fixed misspelled variable in intelc.py (#2928).
1442   From Gary Oberbrunner:
1443     - Test harness: fail_test() can now print a message to help debugging.
1445   From Anatoly Techtonik:
1446     - Require rpmbuild when building SCons package.
1447     - Print full stack on certain errors, for debugging.
1448     - Improve documentation for Textfile builder.
1450   From William Deegan:
1451     - VS2012 & VS2010 Resolve initialization issues by adding path to reg.exe
1452       in shell used to run batch files.
1453     - MSVC Support fixed defaulting TARGET_ARCH to HOST_ARCH. It should be
1454       None if not explicitly set.
1455     - MSVC Fixed issue where if more than one Architectures compilers are
1456       detected, it would take the last one found, and not the first.
1458   From Philipp Kraus:
1459     - Added optional ZIPROOT to Zip tool.
1461   From Dirk Baechle:
1462     - Replaced old SGML-based documentation toolchain with a more modern
1463       approach, that also requires less external dependencies (programs and
1464       Python packages). Added a customized Docbook XSD for strict validation of
1465       all input XML files.
1467   From Luca Falavigna:
1468     - Fixed spelling errors in MAN pages (#2897).
1470   From Michael McDougall:
1471     - Fixed description of ignore_case for EnumVariable in the
1472       MAN page (#2774).
1474 RELEASE 2.3.0 - Mon, 02 Mar 2013 13:22:29 -0400
1476   From Anatoly Techtonik:
1477     - Added ability to run scripts/scons.py directly from source checkout
1478     - Hide deprecated --debug={dtree,stree,tree} from --help output
1479     - Error messages from option parser now include hints about valid choices
1480     - Cleaned up some Python 1.5 and pre-2.3 code, so don't expect SCons
1481       to run on anything less than Python 2.4 anymore
1482     - Several fixes for runtest.py:
1483       * exit with an error if no tests were found
1484       * removed --noqmtest option - this behavior is by default
1485       * replaced `-o FILE --xml` combination with `--xml FILE`
1486       * changed `-o, --output FILE` option to capture stdout/stderr output
1487         from runtest.py
1488     - Remove os_spawnv_fix.diff patch required to enable parallel builds
1489       support prior to Python 2.2
1491   From Juan Lang:
1492     - Fix WiX Tool to use .wixobj rather than .wxiobj for compiler output
1493     - Support building with WiX releases after 2.0
1495   From Alexey Klimkin:
1496     - Fix nested LIBPATH expansion by flattening sequences in subst_path.
1498   From eyan on Bitbucket:
1499     - Print target name with command execution time with --debug=time
1501   From Thomas Berg and Evgeny Podjachev:
1502     - Fix subprocess spawning on Windows.  Work around a Windows
1503       bug that can crash python occasionally when using -jN. (#2449)
1505   From Dirk Baechle:
1506     - Updated test framework to support dir and file fixtures and
1507       added ability to test external (out-of-tree) tools (#2862).
1508       See doc in QMTest/test-framework.rst.
1509     - Fixed several errors in the test suite (Java paths, MSVS version
1510       detection, Tool import), additionally
1511       * provided MinGW command-line support for the CXX, AS and
1512         Fortran tests,
1513       * refactored the detection of the gcc version and the according
1514         Fortran startup library,
1515       * provided a new module rpmutils.py, wrapping the RPM naming rules
1516         for target files and further hardware-dependent info (compatibility,
1517         compiler flags, ...),
1518       * added new test methods must_exist_one_of() and
1519         must_not_exist_any_of() and
1520       * removed Aegis support from runtest.py. (#2872)
1522   From Gary Oberbrunner:
1523     - Add -jN support to runtest.py to run tests in parallel
1524     - Add MSVC10 and MSVC11 support to get_output low-level bat script runner.
1525     - Fix MSVS solution generation for VS11, and fixed tests.
1527   From Rob Managan:
1528     - Updated the TeX builder to support the \newglossary command
1529       in LaTeX's glossaries package and the files it creates.
1530     - Improve support for new versions of biblatex in the TeX builder
1531       so biber is called automatically if biblatex requires it.
1532     - Add SHLIBVERSION as an option that tells SharedLibrary to build
1533       a versioned shared library and create the required symlinks.
1534       Add builder InstallVersionedLib to create the required symlinks
1535       installing a versioned shared library.
1537 RELEASE 2.2.0 - Mon, 05 Aug 2012 15:37:48 +0000
1539   From dubcanada on Bitbucket:
1540     - Fix 32-bit Visual Express C++ on 64-bit Windows (generate 32-bit code)
1542   From Paweł Tomulik:
1543     - Added gettext toolset
1544     - Fixed FindSourceFiles to find final sources (leaf nodes).
1546   From Greg Ward:
1547     - Allow Node objects in Java path (#2825)
1549   From Joshua Hughes:
1550     - Make Windows not redefine builtin file as un-inheritable (#2857)
1551     - Fix WINDOWS_INSERT_DEF on MinGW (Windows) (#2856)
1553   From smallbub on Bitbucket:
1554     - Fix LINKCOMSTR, SHLINKCOMSTR, and LDMODULECOMSTR on Windows (#2833).
1556   From Mortoray:
1557     - Make -s (silent mode) be silent about entering subdirs (#2976).
1558     - Fix cloning of builders when cloning environment (#2821).
1560   From Gary Oberbrunner:
1561     - Show valid Visual Studio architectures in error message
1562        when user passes invalid arch.
1564   From Alexey Petruchik:
1565     - Support for Microsoft Visual Studio 11 (both using it
1566       and generating MSVS11 solution files).
1568   From Alexey Klimkin:
1569     - Fixed the Taskmaster, curing spurious build failures in
1570       multi-threaded runs (#2720).
1572   From Dirk Baechle:
1573     - Improved documentation of command-line variables (#2809).
1574     - Fixed scons-doc.py to properly convert main XML files (#2812).
1576   From Rob Managan:
1577     - Updated the TeX builder to support LaTeX's multibib package.
1578     - Updated the TeX builder to support LaTeX's biblatex package.
1579     - Added support for using biber instead of bibtex by setting
1580       env['BIBTEX'] = 'biber'
1582   From Arve Knudsen:
1583     - Test for FORTRANPPFILESUFFIXES (#2129).
1586 RELEASE 2.1.0 - Mon, 09 Sep 2011 20:54:57 -0700
1588   From Anton Lazarev:
1589     - Fix Windows resource compiler scanner to accept DOS line endings.
1591   From Matthias:
1592     - Update MSVS documents to remove note indicating that only one
1593       project is currently supported per solution file.
1595   From Grzegorz Bizoń:
1596     - Fix long compile lines in batch mode by using TEMPFILE
1597     - Fix MSVC_BATCH=False (was treating it as true)
1599   From Justin Gullingsrud:
1600     - support -std=c++0x and related CXXFLAGS in pkgconfig (ParseFlags)
1602   From Vincent Beffara:
1603     - Support -dylib_file in pkgconfig (ParseFlags)
1605   From Gary Oberbrunner and Sohail Somani:
1606     - new construction variable WINDOWS_EMBED_MANIFEST to automatically
1607       embed manifests in Windows EXEs and DLLs.
1609   From Gary Oberbrunner:
1610     - Fix Visual Studio project generation when CPPPATH contains Dir nodes
1611     - Ensure Visual Studio project is regenerated when CPPPATH or CPPDEFINES change
1612     - Fix unicode error when using non-ASCII filenames with Copy or Install
1613     - Put RPATH in LINKCOM rather than LINKFLAGS so resetting
1614       LINKFLAGS doesn't kill RPATH
1615     - Fix precompiled headers on Windows when variant dir name has spaces.
1616     - Adding None to an Action no longer fails (just returns original action)
1617     - New --debug=prepare option to show each target as it's being
1618       prepared, whether or not anything needs to be done for it.
1619     - New debug option --debug=duplicate to print a line for each
1620       unlink/relink (or copy) of a variant file from its source file.
1621     - Improve error message for EnumVariables to show legal values.
1622     - Fix Intel compiler to sort versions >9 correctly (esp. on Linux)
1623     - Fix Install() when the source and target are directories and the
1624       target directory exists.
1626   From David Garcia Garzon:
1627     - Fix Delete to be able to delete broken symlinks and dir
1628       symlinks.
1630   From Imran Fanaswala and Robert Lehr:
1631     - Handle .output file generated by bison/yacc properly. Cleaning it
1632       when necessary.
1634   From Antoine Dechaume:
1635     - Handle SWIG file where there is whitespace after the module name
1636       properly. Previously the generated files would include
1637       the whitespace.
1639   From Dmitry R.:
1640     - Handle Environment in case __semi_deepcopy is None
1642   From Benoit Belley:
1644     - Much improved support for Windows UNC paths (\\SERVERNAME).
1646   From Jean-Baptiste Lab:
1648     - Fix problems with appending CPPDEFINES that contain
1649       dictionaries, and related issues with Parse/MergeFlags and
1650       CPPDEFINES.
1652   From Allen Weeks:
1654     - Fix for an issue with implicit-cache with multiple targets
1655       when dependencies are removed on disk.
1657   From Evgeny Podjachev and Alexey Petruchick:
1659     - Support generation of Microsoft Visual Studio 2008 (9.0)
1660       and 2010 (10.0) project and solution files.
1662   From Ken Deeter:
1664     - Fix a problem when FS Entries which are actually Dirs have builders.
1666   From Luca Falavigna:
1668     - Support Fortran 03
1670   From Gary Oberbrunner:
1672     - Print the path to the SCons package in scons --version
1674   From Jean-Fran�ois Colson:
1676     - Improve Microsoft Visual Studio Solution generation, and fix
1677       various errors in the generated solutions especially when using
1678       MSVS_SCC_PROVIDER, and when generating multiple projects.  The
1679       construction variable MSVS_SCC_PROJECT_BASE_PATH, which never
1680       worked properly, is removed.  Users can use the new variable
1681       MSVS_SCC_CONNECTION_ROOT instead if desired.
1683   From Anatoly Techtonik:
1685     - Use subprocess in bootstrap.py instead of os.execve to avoid
1686       losing output control on Windows (http://bugs.python.org/issue9148)
1688     - Revert patch for adding SCons to App Paths, because standard cmd
1689       shell doesn't search there. This is confusing, because `scons` can
1690       be executed from explorer, but fail to start from console.
1692     - Fix broken installation with easy_install on Windows (issue #2051)
1693       SCons traditionally installed in a way that allowed to run multiple
1694       versions side by side. This custom logic was incompatible with
1695       easy_install way of doing things.
1697     - Use epydoc module for generating API docs in HTML if command line
1698       utility is not found in PATH. Actual for Windows.
1700   From Alexander Goomenyuk:
1702     - Add .sx to assembly source scanner list so .sx files
1703       get their header file dependencies detected.
1705   From Arve Knudsen:
1707     - Set module metadata when loading site_scons/site_init.py
1708       so it is treated as a proper module; __doc__, __file__ and
1709       __name__ now refer to the site_init.py file.
1711   From Russel Winder:
1713     - Users Guide updates explaining that Tools can be packages as
1714       well as python modules.
1716   From Gary Oberbrunner:
1718     - New systemwide and per-user site_scons dirs.
1720   From Dirk Baechle:
1722     - XML fixes in User's Guide.
1723     - Fixed the detection of 'jar' and 'rmic' during
1724       the initialization of the respective Tools (#2730).
1725     - Improved docs for custom Decider functions and
1726       custom Scanner objects (#2711, #2713).
1727     - Corrected SWIG module names for generated *.i files (#2707).
1729   From Joe Zuntz:
1731     - Fixed a case-sensitivity problem with Fortran modules.
1733   From Bauke Conijn:
1735     - Added Users Guide example for auto-generated source code
1737   From Steven Knight:
1739     - Fix explicit dependencies (Depends()) on Nodes that don't have
1740       attached Builders.
1742     - Fix use of the global Alias() function with command actions.
1744   From Matt Hughes:
1746     - Fix the ability to append to default $*FLAGS values (which are
1747       implemented as CLVar instances) in a copied construction environment
1748       without affecting the original construction environment's value.
1750   From Rob Managan:
1752     - Updated the TeX command strings to include a /D on Windows in
1753       case the new directory is on a different drive letter.
1755     - Fixed the LaTeX scanner so dependencies are found in commands that
1756       are broken across lines with a comment or have embedded spaces.
1758     - The TeX builders should now work with tex files that are generated
1759       by another program. Thanks to Hans-Martin von Gaudecker for
1760       isolating the cause of this bug.
1762     - Added support for INDEXSTYLE environment variable so makeindex can
1763       find style files.
1765     - Added support for the bibunits package so we call bibtex on all
1766       the bu*.aux files.
1768     - Add support of finding path information on OSX for TeX applications
1769       MacPorts and Fink paths need to be added by the user
1771   From Russel Winder:
1773     - Add support for DMD version 2 (the phobos2 library).
1775   From William Deegan:
1777     - Add initial support for VS/VC 2010 (express and non-express versions)
1778     - Remove warning for not finding MS VC/VS install.
1779       "scons: warning: No version of Visual Studio compiler found
1780         - C/C++ compilers most likely not set correctly"
1781     - Add support for Linux 3.0
1784 RELEASE 2.0.1 - Mon, 15 Aug 2010 15:46:32 -0700
1786   From Dirk Baechle:
1788     - Fix XML in documentation.
1790   From Joe Zuntz:
1792     - Fixed a case-sensitivity problem with Fortran modules.
1794   From Bauke Conijn:
1796     - Added Users Guide example for auto-generated source code
1798   From Steven Knight:
1800     - Fix explicit dependencies (Depends()) on Nodes that don't have
1801       attached Builders.
1803   From Matt Hughes:
1805     - Fix the ability to append to default $*FLAGS values (which are
1806       implemented as CLVar instances) in a copied construction environment
1807       without affecting the original construction environment's value.
1809   From Rob Managan:
1811     - Updated the TeX command strings to include a /D on Windows in
1812       case the new directory is on a different drive letter.
1814     - Fixed the LaTeX scanner so dependencies are found in commands that
1815       are broken across lines with a comment or have embedded spaces.
1818 RELEASE 2.0.0.final.0 - Mon, 14 Jun 2010 22:01:37 -0700
1820   From Dirk Baechle:
1822     - Fix XML in documentation.
1824   From Steven Knight:
1826     - Provide forward compatibility for the 'profile' module.
1828     - Provide forward compatibility for the 'pickle' module.
1830     - Provide forward compatibility for the 'io' module.
1832     - Provide forward compatibility for the 'queue' module.
1834     - Provide forward compatibility for the 'collections' module.
1836     - Provide forward compatibility for the 'builtins' module.
1838     - Provide forward compatibility for 'sys.intern()'.
1840     - Convert to os.walk() from of os.path.walk().
1842     - Remove compatibility logic no longer needed.
1844     - Add a '-3' option to runtest to print 3.x incompatibility warnings.
1846     - Convert old-style classes into new-style classes.
1848     - Fix "Ignoring corrupt sconsign entry" warnings when building
1849       in a tree with a pre-2.0 .sconsign file.
1851     - Fix propagation from environment of VS*COMNTOOLS to resolve issues
1852       initializing MSVC/MSVS/SDK issues.
1854     - Handle detecting Visual C++ on Python versions with upper-case
1855       platform architectures like 'AMD64'.
1857   From W. Trevor King:
1859     - Revisions to README.
1861   From Greg Noel:
1863     - Apply numerous Python fixers to update code to more modern idioms.
1864       Find where fixers should be applied to code in test strings and
1865       apply the fixers there, too.
1867     - Write a fixer to convert string functions to string methods.
1869     - Modify the 'dict' fixer to be less conservative.
1871     - Modify the 'apply' fixer to handle more cases.
1873     - Create a modified 'types' fixer that converts types to 2.x
1874       equivalents rather than 3.x equivalents.
1876     - Write a 'division' fixer to highlight uses of the old-style
1877       division operator.  Correct usage where needed.
1879     - Add forward compatibility for the new 'memoryview' function
1880       (which replaces the 'buffer' function).
1882     - Add forward compatibility for the 'winreg' module.
1884     - Remove no-longer-needed 'platform' module.
1886     - Run tests with the '-3' option to Python 2.6 and clear up
1887       various reported incompatibilities.
1889     - Comb out code paths specialized to Pythons older than 2.4.
1891     - Update deprecation warnings; most now become mandatory.
1893     - Start deprecation cycle for BuildDir() and build_dir.
1895     - Start deprecation cycle for SourceCode() and related factories
1897     - Fixed a problem with is_Dict() not identifying some objects derived
1898       from UserDict.
1900   From Jim Randall:
1902     - Document the AllowSubstExceptions() function in the User's Guide.
1904   From William Deegan:
1906     - Migrate MSVC/MSVS/SDK improvements from 1.3 branch.
1909 RELEASE 1.3.0 - Tue, 23 Mar 2010 21:44:19 -0400
1911   From Steven Knight:
1913     - Update man page and documentation.
1915   From William Deegan (plus minor patch from Gary Oberbrunner):
1917     - Support Visual Studio 8.0 Express
1919 RELEASE 1.2.0.d20100306 - Sat, 06 Mar 2010 16:18:33 -0800
1921   From Luca Falavigna:
1923     - Fix typos in the man page.
1925   From Gottfried Ganssauge:
1927     - Support execution when SCons is installed via easy_install.
1929   From Steven Knight:
1931     - Make the messages for Configure checks of compilers consistent.
1933     - Issue an error message if a BUILDERS entry is not a Builder
1934       object or a callable wrapper.
1936   From Rob Managan:
1938     - Update tex builder to handle the case where a \input{foo}
1939       command tries to work with a directory named foo instead of the
1940       file foo.tex. The builder now ignores a directory and continues
1941       searching to find the correct file. Thanks to Lennart Sauerbeck
1942       for the test case and initial patch
1944       Also allow the \include of files in subdirectories when variantDir
1945       is used with duplicate=0. Previously latex would crash since
1946       the directory in which the .aux file is written was not created.
1947       Thanks to Stefan Hepp for finding this and part of the solution.
1949   From James Teh:
1950     - Patches to fix some issues using MS SDK V7.0
1952   From William Deegan:
1953     - Lots of testing and minor patches to handle mixed MS VC and SDK
1954       installations, as well as having only the SDK installed.
1957 RELEASE 1.2.0.d20100117 - Sun, 17 Jan 2010 14:26:59 -0800
1959   From Jim Randall:
1960     - Fixed temp filename race condition on Windows with long cmd lines.
1962   From David Cournapeau:
1963     - Fixed tryRun when sconf directory is in a variant dir.
1964     - Do not add -fPIC for ifort tool on non-posix platforms (darwin and
1965       windows).
1966     - Fix bug 2294 (spurious CheckCC failures).
1967     - Fix SCons bootstrap process on windows 64 (wrong wininst name)
1969   From William Deegan:
1970     - Final merge from vs_revamp branch to main
1972     - Added definition and usage of HOST_OS, HOST_ARCH, TARGET_OS,
1973       TARGET_ARCH, currently only defined/used by Visual Studio
1974       Compilers. This will be rolled out to other platforms/tools
1975       in the future.
1977     - Add check for python >= 3.0.0 and exit gracefully.
1978       For 1.3 python >= 1.5.2 and < 3.0.0 are supported
1980     - Fix bug 1944 - Handle non-existent .i file in swig emitter, previously
1981       it would crash with an IOError exception. Now it will try to make an
1982       educated guess on the module name based on the filename.
1984   From Lukas Erlinghagen:
1986     - Have AddOption() remove variables from the list of
1987       seen-but-unknown variables (which are reported later).
1989     - An option name and aliases can now be specified as a tuple.
1991   From Hartmut Goebel:
1993     - Textfile builder.
1995   From Jared Grubb:
1997     - use "is/is not" in comparisons with None instead of "==" or "!=".
1999   From Jim Hunziker:
2001     - Avoid adding -gphobos to a command line multiple times
2002       when initializing use of the DMD compiler.
2004   From Jason Kenney:
2006     - Sugguested HOST/TARGET OS/ARCH separation.
2008   From Steven Knight:
2010     - Fix the -n option when used with VariantDir(duplicate=1)
2011       and the variant directory doesn't already exist.
2013     - Fix scanning of Unicode files for both UTF-16 endian flavors.
2015     - Fix a TypeError on #include of file names with Unicode characters.
2017     - Fix an exception if a null command-line argument is passed in.
2019     - Evaluate Requires() prerequisites before a Node's direct children
2020       (sources and dependencies).
2022   From Greg Noel:
2024     - Remove redundant __metaclass__ initializations in Environment.py.
2026     - Correct the documentation of text returned by sconf.Result().
2028     - Document that filenames with '.' as the first character are
2029       ignored by Glob() by default (matching UNIX glob semantics).
2031     - Fix SWIG testing infrastructure to work on Mac OS X.
2033     - Restructure a test that occasionally hung so that the test would
2034       detect when it was stuck and fail instead.
2036     - Substfile builder.
2038   From Gary Oberbrunner:
2040     - When reporting a target that SCons doesn't know how to make,
2041       specify whether it's a File, Dir, etc.
2043   From Ben Webb:
2045     - Fix use of $SWIGOUTDIR when generating Python wrappers.
2047     - Add $SWIGDIRECTORSUFFIX and $SWIGVERSION construction variables.
2049   From Rob Managan:
2051     - Add -recorder flag to Latex commands and updated internals to
2052       use the output to find files TeX creates. This allows the MiKTeX
2053       installations to find the created files
2055     - Notify user of Latex errors that would get buried in the
2056       Latex output
2058     - Remove LATEXSUFFIXES from environments that don't initialize Tex.
2060     - Add support for the glossaries package for glossaries and acronyms
2062     - Fix problem that pdftex, latex, and pdflatex tools by themselves did
2063       not create the actions for bibtex, makeindex,... by creating them
2064       and other environment settings in one routine called by all four
2065       tex tools.
2067     - Fix problem with filenames of sideeffects when the user changes
2068       the name of the output file from the latex default
2070     - Add scanning of files included in Latex by means of \lstinputlisting{}
2071       Patch from Stefan Hepp.
2073     - Change command line for epstopdf to use --outfile= instead of -o
2074       since this works on all platforms.
2075       Patch from Stefan Hepp.
2077     - Change scanner to properly search for included file from the
2078       directory of the main file instead of the file it is included from.
2079       Also update the emitter to add the .aux file associated with
2080       \include{filename} commands. This makes sure the required directories
2081       if any are created for variantdir cases.
2082       Half of the patch from Stefan Hepp.
2084 RELEASE 1.2.0.d20090223 - Mon, 23 Feb 2009 08:41:06 -0800
2086   From Stanislav Baranov:
2088     - Make suffix-matching for scanners case-insensitive on Windows.
2090   From David Cournapeau:
2092     - Change the way SCons finds versions of Visual C/C++ and Visual
2093       Studio to find and use the Microsoft v*vars.bat files.
2095   From Robert P. J. Day:
2097     - User's Guide updates.
2099   From Dan Eaton:
2101     - Fix generation of Visual Studio 8 project files on x64 platforms.
2103   From Allan Erskine:
2105     - Set IncludeSearchPath and PreprocessorDefinitions in generated
2106       Visual Studio 8 project files, to help IntelliSense work.
2108   From Mateusz Gruca:
2110     - Fix deletion of broken symlinks by the --clean option.
2112   From Steven Knight:
2114     - Fix the error message when use of a non-existent drive on Windows
2115       is detected.
2117     - Add sources for files whose targets don't exist in $CHANGED_SOURCES.
2119     - Detect implicit dependencies on commands even when the command is
2120       quoted.
2122     - Fix interaction of $CHANGED_SOURCES with the --config=force option.
2124     - Fix finding #include files when the string contains escaped
2125       backslashes like "C:\\some\\include.h".
2127     - Pass $CCFLAGS to Visual C/C++ precompiled header compilation.
2129     - Remove unnecessary nested $( $) around $_LIBDIRFLAGS on link lines
2130       for the Microsoft linker, the OS/2 ilink linker and the Phar Lap
2131       linkloc linker.
2133     - Spell the Windows environment variables consistently "SystemDrive"
2134       and "SystemRoot" instead of "SYSTEMDRIVE" and "SYSTEMROOT".
2138 RELEASE 1.2.0.d20090113 - Tue, 13 Jan 2009 02:50:30 -0800
2140   From Stanislav Baranov, Ted Johnson and Steven Knight:
2142     - Add support for batch compilation of Visual Studio C/C++ source
2143       files, controlled by a new $MSVC_BATCH construction variable.
2145   From Steven Knight:
2147     - Print the message, "scons: Build interrupted." on error output,
2148       not standard output.
2150     - Add a --warn=future-deprecated option for advance warnings about
2151       deprecated features that still have warnings hidden by default.
2153     - Fix use of $SOURCE and $SOURCES attributes when there are no
2154       sources specified in the Builder call.
2156     - Add support for new $CHANGED_SOURCES, $CHANGED_TARGETS,
2157       $UNCHANGED_SOURCES and $UNCHANGED_TARGETS variables.
2159     - Add general support for batch builds through new batch_key= and
2160       targets= keywords to Action object creation.
2162   From Arve Knudsen:
2164     - Make linker tools differentiate properly between SharedLibrary
2165       and LoadableModule.
2167     - Document TestCommon.shobj_prefix variable.
2169     - Support $SWIGOUTDIR values with spaces.
2171   From Rob Managan:
2173     - Don't automatically try to build .pdf graphics files for
2174       .eps files in \includegraphics{} calls in TeX/LaTeX files
2175       when building with the PDF builder (and thus using pdflatex).
2177   From Gary Oberbrunner:
2179     - Allow AppendENVPath() and PrependENVPath() to interpret '#'
2180       for paths relative to the top-level SConstruct directory.
2182     - Use the Borland ilink -e option to specify the output file name.
2184     - Document that the msvc Tool module uses $PCH, $PCHSTOP and $PDB.
2186     - Allow WINDOWS_INSERT_DEF=0 to disable --output-def when linking
2187       under MinGW.
2189   From Zia Sobhani:
2191     - Fix typos in the User's Guide.
2193   From Greg Spencer:
2195     - Support implicit dependency scanning of files encoded in utf-8
2196       and utf-16.
2198   From Roberto de Vecchi:
2200     - Remove $CCFLAGS from the the default definitions of $CXXFLAGS for
2201       Visual C/C++ and MIPSpro C++ on SGI so, they match other tools
2202       and avoid flag duplication on C++ command lines.
2204   From Ben Webb:
2206     - Handle quoted module names in SWIG source files.
2208     - Emit *_wrap.h when SWIG generates header file for directors
2210   From Matthew Wesley:
2212     - Copy file attributes so we identify, and can link a shared library
2213       from, shared object files in a Repository.
2217 RELEASE 1.2.0 - Sat, 20 Dec 2008 22:47:29 -0800
2219   From Steven Knight:
2221     - Don't fail if can't import a _subprocess module on Windows.
2223     - Add warnings for use of the deprecated Options object.
2227 RELEASE 1.1.0.d20081207 - Sun, 07 Dec 2008 19:17:23 -0800
2229   From Benoit Belley:
2231     - Improve the robustness of GetBuildFailures() by refactoring
2232       SCons exception handling (especially BuildError exceptions).
2234     - Have the --taskmastertrace= option print information about
2235       individual Task methods, not just the Taskmaster control flow.
2237     - Eliminate some spurious dependency cycles by being more aggressive
2238       about pruning pending children from the Taskmaster walk.
2240     - Suppress mistaken reports of a dependency cycle when a child
2241       left on the pending list is a single Node in EXECUTED state.
2243   From David Cournapeau:
2245     - Fix $FORTRANMODDIRPREFIX for the ifort (Intel Fortran) tool.
2247   From Brad Fitzpatrick:
2249     - Don't pre-generate an exception message (which will likely be
2250       ignored anyway) when an EntryProxy re-raises an AttributeError.
2252   From Jared Grubb:
2254     - Clean up coding style and white space in Node/FS.py.
2256     - Fix a typo in the documentation for $_CPPDEFFLAGS.
2258     - Issue 2401: Fix usage of comparisons with None.
2260   From Ludwig H�hne:
2262     - Handle Java inner classes declared within a method.
2264   From Steven Knight:
2266     - Fix label placement by the "scons-time.py func" subcommand
2267       when a profile value was close to (or equal to) 0.0.
2269     - Fix env.Append() and env.Prepend()'s ability to add a string to
2270       list-like variables like $CCFLAGS under Python 2.6.
2272     - Other Python2.6 portability:  don't use "as" (a Python 2.6 keyword).
2273       Don't use the deprecated Exception.message attribute.
2275     - Support using the -f option to search for a different top-level
2276       file name when walking up with the -D, -U or -u options.
2278     - Fix use of VariantDir when the -n option is used and doesn't,
2279       therefore, actually create the variant directory.
2281     - Fix a stack trace from the --debug=includes option when passed a
2282       static or shared library as an argument.
2284     - Speed up the internal find_file() function (used for searching
2285       CPPPATH, LIBPATH, etc.).
2287     - Add support for using the Python "in" keyword on construction
2288       environments (for example, if "CPPPATH" in env: ...).
2290     - Fix use of Glob() when a repository or source directory contains
2291       an in-memory Node without a corresponding on-disk file or directory.
2293     - Add a warning about future reservation of $CHANGED_SOURCES,
2294       $CHANGED_TARGETS, $UNCHANGED_SOURCES and $UNCHANGED_TARGETS.
2296     - Enable by default the existing warnings about setting the resource
2297       $SOURCE, $SOURCES, $TARGET and $TARGETS variable.
2299   From Rob Managan:
2301     - Scan for TeX files in the paths specified in the $TEXINPUTS
2302       construction variable and the $TEXINPUTS environment variable.
2304     - Configure the PDF() and PostScript() Builders as single_source so
2305       they know each source file generates a separate target file.
2307     - Add $EPSTOPDF, $EPSTOPDFFLAGS and $EPSTOPDFCOM
2309     - Add .tex as a valid extension for the PDF() builder.
2311     - Add regular expressions to find \input, \include and
2312       \includegraphics.
2314     - Support generating a .pdf file from a .eps source.
2316     - Recursive scan included input TeX files.
2318     - Handle requiring searched-for TeX input graphics files to have
2319       extensions (to avoid trying to build a .eps from itself, e.g.).
2321   From Greg Noel:
2323     - Make the Action() function handle positional parameters consistently.
2325     - Clarify use of Configure.CheckType().
2327     - Make the File.{Dir,Entry,File}() methods create their entries
2328       relative to the calling File's directory, not the SConscript
2329       directory.
2331     - Use the Python os.devnull variable to discard error output when
2332       looking for the $CC or $CXX version.
2334     - Mention LoadableModule() in the SharedLibrary() documentation.
2336   From Gary Oberbrunner:
2338     - Update the User's Guide to clarify use of the site_scons/
2339       directory and the site_init.py module.
2341     - Make env.AppendUnique() and env.PrependUnique remove duplicates
2342       within a passed-in list being added, too.
2344   From Randall Spangler:
2346     - Fix Glob() so an on-disk file or directory beginning with '#'
2347       doesn't throw an exception.
2351 RELEASE 1.1.0 - Thu, 09 Oct 2008 08:33:47 -0700
2353   From Chris AtLee
2355     - Use the specified environment when checking for the GCC compiler
2356       version.
2358   From Ian P. Cardenas:
2360     - Fix Glob() polluting LIBPATH by returning copy of list
2362   From David Cournapeau:
2364     - Add CheckCC, CheckCXX, CheckSHCC and CheckSHCXX tests to
2365       configuration contexts.
2367     - Have the --profile= argument use the much faster cProfile module
2368       (if it's available in the running Python version).
2370     - Reorder MSVC compilation arguments so the /Fo is first.
2372   From Bill Deegan:
2374     - Add scanning Windows resource (.rc) files for implicit dependencies.
2376   From John Gozde:
2378     - When scanning for a #include file, don't use a directory that
2379       has the same name as the file.
2381   From Ralf W. Grosse-Kunstleve
2383     - Suppress error output when checking for the GCC compiler version.
2385   From Jared Grubb:
2387     - Fix VariantDir duplication of #included files in subdirectories.
2389   From Ludwig H�hne:
2391     - Reduce memory usage when a directory is used as a dependency of
2392       another Node (such as an Alias) by returning a concatenation
2393       of the children's signatures + names, not the children's contents,
2394       as the directory contents.
2396     - Raise AttributeError, not KeyError, when a Builder can't be found.
2398     - Invalidate cached Node information (such as the contenst returned
2399       by the get_contents() method) when calling actions with Execute().
2401     - Avoid object reference cycles from frame objects.
2403     - Reduce memory usage from Null Executor objects.
2405     - Compute MD5 checksums of large files without reading the entire
2406       file contents into memory.  Add a new --md5-chunksize option to
2407       control the size of each chunk read into memory.
2409   From Steven Knight:
2411     - Fix the ability of the add_src_builder() method to add a new
2412       source builder to any other builder.
2414     - Avoid an infinite loop on non-Windows systems trying to find the
2415       SCons library directory if the Python library directory does not
2416       begin with the string "python".
2418     - Search for the SCons library directory in "scons-local" (with
2419       no version number) after "scons-local-{VERSION}".
2421   From Rob Managan:
2423     - Fix the user's ability to interrupt the TeX build chain.
2425     - Fix the TeX builder's allowing the user to specify the target name,
2426       instead of always using its default output name based on the source.
2428     - Iterate building TeX output files until all warning are gone
2429       and the auxiliary files stop changing, or until we reach the
2430       (configurable) maximum number of retries.
2432     - Add TeX scanner support for:  glossaries, nomenclatures, lists of
2433       figures, lists of tables, hyperref and beamer.
2435     - Use the $BIBINPUTS, $BSTINPUTS, $TEXINPUTS and $TEXPICTS construction
2436       variables as search paths for the relevant types of input file.
2438     - Fix building TeX with VariantDir(duplicate=0) in effect.
2440     - Fix the LaTeX scanner to search for graphics on the TEXINPUTS path.
2442     - Have the PDFLaTeX scanner search for .gif files as well.
2444   From Greg Noel:
2446     - Fix typos and format bugs in the man page.
2448     - Add a first draft of a wrapper module for Python's subprocess
2449       module.
2451     - Refactor use of the SCons.compat module so other modules don't
2452       have to import it individually.
2454     - Add .sx as a suffix for assembly language files that use the
2455       C preprocessor.
2457   From Gary Oberbrunner:
2459     - Make Glob() sort the returned list of Files or Nodes
2460       to prevent spurious rebuilds.
2462     - Add a delete_existing keyword argument to the AppendENVPath()
2463       and PrependENVPath() Environment methods.
2465     - Add ability to use "$SOURCE" when specifying a target to a builder
2467   From Damyan Pepper:
2469     - Add a test case to verify that SConsignFile() files can be
2470       created in previously non-existent subdirectories.
2472   From Jim Randall:
2474     - Make the subdirectory in which the SConsignFile() file will
2475       live, if the subdirectory doesn't already exist.
2477   From Ali Tofigh:
2479     - Add a test to verify duplication of files in VariantDir subdirectories.
2483 RELEASE 1.0.1 - Sat, 06 Sep 2008 07:29:34 -0700
2485   From Greg Noel:
2487     - Add a FindFile() section to the User's Guide.
2489     - Fix the FindFile() documentation in the man page.
2491     - Fix formatting errors in the Package() description in the man page.
2493     - Escape parentheses that appear within variable names when spawning
2494       command lines using os.system().
2498 RELEASE 1.0.0 - XXX
2500   From Jared Grubb:
2502     - Clear the Node state when turning a generic Entry into a Dir.
2504   From Ludwig H�hne:
2506     - Fix sporadic output-order failures in test/GetBuildFailures/parallel.py.
2508     - Document the ParseDepends() function in the User's Guide.
2510   From khomenko:
2512     - Create a separate description and long_description for RPM packages.
2514   From Steven Knight:
2516     - Document the GetLaunchDir() function in the User's Guide.
2518     - Have the env.Execute() method print an error message if the
2519       executed command fails.
2521     - Add a script for creating a standard SCons development system on
2522       Ubuntu Hardy.  Rewrite subsidiary scripts for install Python and
2523       SCons versions in Python (from shell).
2525   From Greg Noel:
2527     - Handle yacc/bison on newer Mac OS X versions creating file.hpp,
2528       not file.cpp.h.
2530     - In RPCGEN tests, ignore stderr messages from older versions of
2531       rpcgen on some versions of Mac OS X.
2533     - Fix typos in man page descriptions of Tag() and Package(), and in
2534       the scons-time man page.
2536     - Fix documentation of SConf.CheckLibWithHeader and other SConf methods.
2538     - Update documentation of SConscript(variant_dir) usage.
2540     - Fix SWIG tests for (some versions of) Mac OS X.
2542   From Jonas Olsson:
2544     - Print the warning about -j on Windows being potentially unreliable if
2545       the pywin32 extensions are unavailable or lack file handle operations.
2547   From Jim Randall:
2549     - Fix the env.WhereIs() method to expand construction variables.
2551   From Rogier Schouten:
2553     - Enable building of shared libraries with the Bordand ilink32 linker.
2557 RELEASE 1.0.0 - Sat, 09 Aug 2008 12:19:44 -0700
2559   From Luca Falavigna:
2561     - Fix SCons man page indentation under Debian's man page macros.
2563   From Steven Knight:
2565     - Clarify the man page description of the SConscript(src_dir) argument.
2567     - User's Guide updates:
2569        -  Document the BUILD_TARGETS, COMMAND_LINE_TARGETS and
2570           DEFAULT_TARGETS variables.
2572        -  Document the AddOption(), GetOption() and SetOption() functions.
2574        -  Document the Requires() function; convert to the Variables
2575           object, its UnknownOptions() method, and its associated
2576           BoolVariable(), EnumVariable(), ListVariable(), PackageVariable()
2577           and PathVariable() functions.
2579        -  Document the Progress() function.
2581        -  Reorganize the chapter and sections describing the different
2582           types of environments and how they interact.  Document the
2583           SetDefault() method.  Document the PrependENVPath() and
2584           AppendENVPath() functions.
2586        -  Reorganize the command-line arguments chapter.  Document the
2587           ARGLIST variable.
2589        -  Collect some miscellaneous sections into a chapter about
2590           configuring build output.
2592     - Man page updates:
2594        -  Document suggested use of the Visual C/C++ /FC option to fix
2595           the ability to double-click on file names in compilation error
2596           messages.
2598        -  Document the need to use Clean() for any SideEffect() files that
2599           must be explicitly removed when their targets are removed.
2601        -  Explicitly document use of Node lists as input to Dependency().
2603   From Greg Noel:
2605     - Document MergeFlags(), ParseConfig(), ParseFlags() and SideEffect()
2606       in the User's Guide.
2608   From Gary Oberbrunner:
2610     - Document use of the GetBuildFailures() function in the User's Guide.
2612   From Adam Simpkins:
2614     - Add man page text clarifying the behavior of AddPreAction() and
2615       AddPostAction() when called with multiple targets.
2617   From Alexey Zezukin:
2619     - Fix incorrectly swapped man page descriptions of the --warn= options
2620       for duplicate-environment and missing-sconscript.
2624 RELEASE 0.98.5 - Sat, 07 Jun 2008 08:20:35 -0700
2626   From Benoit Belley:
2628   - Fix the Intel C++ compiler ABI specification for EMT64 processors.
2630   From David Cournapeau:
2632   - Issue a (suppressable) warning, not an error, when trying to link
2633     C++ and Fortran object files into the same executable.
2635   From Steven Knight:
2637   - Update the scons.bat file so that it returns the real exit status
2638     from SCons, even though it uses setlocal + endlocal.
2640   - Fix the --interactive post-build messages so it doesn't get stuck
2641     mistakenly reporting failures after any individual build fails.
2643   - Fix calling File() as a File object method in some circumstances.
2645   - Fix setup.py installation on Mac OS X so SCons gets installed
2646     under /usr/lcoal by default, not in the Mac OS X Python framework.
2650 RELEASE 0.98.4 - Sat, 17 May 2008 22:14:46 -0700
2652   From Benoit Belley:
2654   - Fix calculation of signatures for Python function actions with
2655     closures in Python versions before 2.5.
2657   From David Cournapeau:
2659   - Fix the initialization of $SHF77FLAGS so it includes $F77FLAGS.
2661   From Jonas Olsson:
2663   - Fix a syntax error in the Intel C compiler support on Windows.
2665   From Steven Knight:
2667   - Change how we represent Python Value Nodes when printing and when
2668     stored in .sconsign files (to avoid blowing out memory by storing
2669     huge strings in .sconsign files after multiple runs using Configure
2670     contexts cause the Value strings to be re-escaped each time).
2672   - Fix a regression in not executing configuration checks after failure
2673     of any configuration check that used the same compiler or other tool.
2675   - Handle multiple destinations in Visual Studio 8 settings for the
2676     analogues to the INCLUDE, LIBRARY and PATH variables.
2678   From Greg Noel:
2680   - Update man page text for VariantDir().
2684 RELEASE 0.98.3 - Tue, 29 Apr 2008 22:40:12 -0700
2686   From Greg Noel:
2688   - Fix use of $CXXFLAGS when building C++ shared object files.
2690   From Steven Knight:
2692   - Fix a regression when a Builder's source_scanner doesn't select
2693     a more specific scanner for the suffix of a specified source file.
2695   - Fix the Options object backwards compatibility so people can still
2696     "import SCons.Options.{Bool,Enum,List,Package,Path}Option" submodules.
2698   - Fix searching for implicit dependencies when an Entry Node shows up
2699     in the search path list.
2701   From Stefano:
2703   - Fix expansion of $FORTRANMODDIR in the default Fortran command line(s)
2704     when it's set to something like ${TARGET.dir}.
2708 RELEASE 0.98.2 - Sun, 20 Apr 2008 23:38:56 -0700
2710   From Steven Knight:
2712   - Fix a bug in Fortran suffix computation that would cause SCons to
2713     run out of memory on Windows systems.
2715   - Fix being able to specify --interactive mode command lines with
2716     \ (backslash) path name separators on Windows.
2718   From Gary Oberbrunner:
2720   - Document Glob() in the User's Guide.
2724 RELEASE 0.98.1 - Fri, 18 Apr 2008 19:11:58 -0700
2726   From Benoit Belley:
2728   - Speed up the SCons.Util.to_string*() functions.
2730   - Optimize various Node intialization and calculations.
2732   - Optimize Executor scanning code.
2734   - Optimize Taskmaster execution, including dependency-cycle checking.
2736   - Fix the --debug=stree option so it prints its tree once, not twice.
2738   From Johan Boul�:
2740   - Fix the ability to use LoadableModule() under MinGW.
2742   From David Cournapeau:
2744   - Various missing Fortran-related construction variables have been added.
2746   - SCons now uses the program specified in the $FORTRAN construction
2747     variable to link Fortran object files.
2749   - Fortran compilers on Linux (Intel, g77 and gfortran) now add the -fPIC
2750     option by default when compilling shared objects.
2752   - New 'sunf77', 'sunf90' and 'sunf95' Tool modules have been added to
2753     support Sun Fortran compilers.  On Solaris, the Sun Fortran compilers
2754     are used in preference to other compilers by default.
2756   - Fortran support now uses gfortran in preference to g77.
2758   - Fortran file suffixes are now configurable through the
2759     $F77FILESUFFIXES, $F90FILESUFFIXES, $F95FILESUFFIXES and
2760     $FORTRANFILESUFFIXES variables.
2762   From Steven Knight:
2764   - Make the -d, -e, -w and --no-print-directory options "Ignored for
2765     compatibility."  (We're not going to implement them.)
2767   - Fix a serious inefficiency in how SCons checks for whether any source
2768     files are missing when a Builder call creates many targets from many
2769     input source files.
2771   - In Java projects, make the target .class files depend only on the
2772     specific source .java files where the individual classes are defined.
2774   - Don't store duplicate source file entries  in the .sconsign file so
2775     we don't endlessly rebuild the target(s) for no reason.
2777   - Add a Variables object as the first step towards deprecating the
2778     Options object name.  Similarly, add BoolVariable(), EnumVariable(),
2779     ListVariable(), PackageVariable() and PathVariable() functions
2780     as first steps towards replacing BoolOption(), EnumOption(),
2781     ListOption(), PackageOption() and PathOption().
2783   - Change the options= keyword argument to the Environment() function
2784     to variables=, to avoid confusion with SCons command-line options.
2785     Continue supporting the options= keyword for backwards compatibility.
2787   - When $SWIGFLAGS contains the -python flag, expect the generated .py
2788     file to be in the same (sub)directory as the target.
2790   - When compiling C++ files, allow $CCFLAGS settings to show up on the
2791     command line even when $CXXFLAGS has been redefined.
2793   - Fix --interactive with -u/-U/-D when a VariantDir() is used.
2795   From Anatoly Techtonik:
2797   - Have the scons.bat file add the script execution directory to its
2798     local %PATH% on Windows, so the Python executable can be found.
2800   From Mike Wake:
2802   - Fix passing variable names as a list to the Return() function.
2804   From Matthew Wesley:
2806   - Add support for the GDC 'D' language compiler.
2810 RELEASE 0.98 - Sun, 30 Mar 2008 23:33:05 -0700
2812   From Benoit Belley:
2814   - Fix the --keep-going flag so it builds all possible targets even when
2815     a later top-level target depends on a child that failed its build.
2817   - Fix being able to use $PDB and $WINDWOWS_INSERT_MANIFEST together.
2819   - Don't crash if un-installing the Intel C compiler leaves left-over,
2820     dangling entries in the Windows registry.
2822   - Improve support for non-standard library prefixes and suffixes by
2823     stripping all prefixes/suffixes from file name string as appropriate.
2825   - Reduce the default stack size for -j worker threads to 256 Kbytes.
2826     Provide user control over this value by adding --stack-size and
2827     --warn=stack-size options, and a SetOption('stack_size') function.
2829   - Fix a crash on Linux systems when trying to use the Intel C compiler
2830     and no /opt/intel_cc_* directories are found.
2832   - Improve using Python functions as actions by incorporating into
2833     a FunctionAction's signature:
2834       - literal values referenced by the byte code.
2835       - values of default arguments
2836       - code of nested functions
2837       - values of variables captured by closures
2838       - names of referenced global variables and functions
2840   - Fix the closing message when --clean and --keep-going are both
2841     used and no errors occur.
2843   - Add support for the Intel C compiler on Mac OS X.
2845   - Speed up reading SConscript files by about 20% (for some
2846     configurations) by:  1) optimizing the SCons.Util.is_*() and
2847     SCons.Util.flatten() functions; 2) avoiding unnecessary os.stat()
2848     calls by using a File's .suffix attribute directly instead of
2849     stringifying it.
2851   From Jérôme Berger:
2853   - Have the D language scanner search for .di files as well as .d files.
2855   - Add a find_include_names() method to the Scanner.Classic class to
2856     abstract out how included names can be generated by subclasses.
2858   - Allow the D language scanner to detect multiple modules imported by
2859     a single statement.
2861   From Konstantin Bozhikov:
2863   - Support expansion of construction variables that contain or refer
2864     to lists of other variables or Nodes within expansions like $CPPPATH.
2866   - Change variable substitution (the env.subst() method) so that an
2867     input sequence (list or tuple) is preserved as a list in the output.
2869   From David Cournapeau:
2871   - Add a CheckDeclaration() call to configure contexts.
2873   - Improve the CheckTypeSize() code.
2875   - Add a Define() call to configure contexts, to add arbitrary #define
2876     lines to a generated configure header file.
2878   - Add a "gfortran" Tool module for the GNU F95/F2003 compiler.
2880   - Avoid use of -rpath with the Mac OS X linker.
2882   - Add comment lines to the generated config.h file to describe what
2883     the various #define/#undef lines are doing.
2885   From Steven Knight:
2887   - Support the ability to subclass the new-style "str" class as input
2888     to Builders.
2890   - Improve the performance of our type-checking by using isinstance()
2891     with new-style classes.
2893   - Fix #include (and other $*PATH variables searches) of files with
2894     absolute path names.  Don't die if they don't exist (due to being
2895     #ifdef'ed out or the like).
2897   - Fix --interactive mode when Default(None) is used.
2899   - Fix --debug=memoizer to work around a bug in base Python 2.2 metaclass
2900     initialization (by just not allowing Memoization in Python versions
2901     that have the bug).
2903   - Have the "scons-time time" subcommand handle empty log files, and
2904     log files that contain no results specified by the --which option.
2906   - Fix the max Y of vertical bars drawn by "scons-time --fmt=gnuplot".
2908   - On Mac OS X, account for the fact that the header file generated
2909     from a C++ file will be named (e.g.) file.cpp.h, not file.hpp.
2911   - Fix floating-point numbers confusing the Java parser about
2912     generated .class file names in some configurations.
2914   - Document (nearly) all the values you can now fetch with GetOption().
2916   - Fix use of file names containing strings of multiple spaces when
2917     using ActionFactory instances like the Copy() or Move() function.
2919   - Fix a 0.97 regression when using a variable expansion (like
2920     $OBJSUFFIX) in a source file name to a builder with attached source
2921     builders that match suffix (like Program()+Object()).
2923   - Have the Java parser recognize generics (surrounded by angle brackets)
2924     so they don't interfere with identifying anonymous inner classes.
2926   - Avoid an infinite loop when trying to use saved copies of the
2927     env.Install() or env.InstallAs() after replacing the method
2928     attributes.
2930   - Improve the performance of setting construction variables.
2932   - When cloning a construction environment, avoid over-writing an
2933     attribute for an added method if the user explicitly replaced it.
2935   - Add a warning about deprecated support for Python 1.5, 2.0 and 2.1.
2937   - Fix being able to SetOption('warn', ...) in SConscript files.
2939   - Add a warning about env.Copy() being deprecated.
2941   - Add warnings about the --debug={dtree,stree,tree} options
2942     being deprecated.
2944   - Add VariantDir() as the first step towards deprecating BuildDir().
2945     Add the keyword argument "variant_dir" as the replacement for
2946     "build_dir".
2948   - Add warnings about the {Target,Source}Signatures() methods and
2949     functions being deprecated.
2951   From Rob Managan:
2953   - Enhance TeX and LaTeX support to work with BuildDir(duplicate=0).
2955   - Re-run LaTeX when it issues a package warning that it must be re-run.
2957   From Leanid Nazdrynau:
2959   - Have the Copy() action factory preserve file modes and times
2960     when copying individual files.
2962   From Jan Nijtmans:
2964   - If $JARCHDIR isn't set explicitly, use the .java_classdir attribute
2965     that was set when the Java() Builder built the .class files.
2967   From Greg Noel:
2969   - Document the Dir(), File() and Entry() methods of Dir and File Nodes.
2971   - Add the parse_flags option when creating Environments
2973   From Gary Oberbrunner:
2975   - Make File(), Dir() and Entry() return a list of Nodes when passed
2976     a list of names, instead of trying to make a string from the name
2977     list and making a Node from that string.
2979   - Fix the ability to build an Alias in --interactive mode.
2981   - Fix the ability to hash the contents of actions for nested Python
2982     functions on Python versions where the inability to pickle them
2983     returns a TypeError (instead of the documented PicklingError).
2985   From Jonas Olsson:
2987   - Fix use of the Intel C compiler when the top compiler directory,
2988     but not the compiler version, is specified.
2990   - Handle Intel C compiler network license files (port@system).
2992   From Jim Randall:
2994   - Fix how Python Value Nodes are printed in --debug=explain output.
2996   From Adam Simpkins:
2998   - Add a --interactive option that starts a session for building (or
2999     cleaning) targets without re-reading the SConscript files every time.
3001   - Fix use of readline command-line editing in --interactive mode.
3003   - Have the --interactive mode "build" command with no arguments
3004     build the specified Default() targets.
3006   - Fix the Chmod(), Delete(), Mkdir() and Touch() Action factories to
3007     take a list (of Nodes or strings) as arguments.
3009   From Vaclav Smilauer:
3011   - Fix saving and restoring an Options value of 'all' on Python
3012     versions where all() is a builtin function.
3014   From Daniel Svensson:
3016   - Code correction in SCons.Util.is_List().
3018   From Ben Webb:
3020   - Support the SWIG %module statement with following modifiers in
3021     parenthese (e.g., '%module(directors="1")').
3025 RELEASE 0.97.0d20071212 - Wed, 12 Dec 2007 09:29:32 -0600
3027   From Benoit Belley:
3029   - Fix occasional spurious rebuilds and inefficiency when using
3030     --implicit-cache and Builders that produce multiple targets.
3032   - Allow SCons to not have to know about the builders of generated
3033     files when BuildDir(duplicate=0) is used, potentially allowing some
3034     SConscript files to be ignored for smaller builds.
3036   From David Cournapeau:
3038   - Add a CheckTypeSize() call to configure contexts.
3040   From Ken Deeter:
3042   - Make the "contents" of Alias Nodes a concatenation of the children's
3043     content signatures (MD5 checksums), not a concatenation of the
3044     children's contents, to avoid using large amounts of memory during
3045     signature calculation.
3047   From Malte Helmert:
3049   - Fix a lot of typos in the man page and User's Guide.
3051   From Geoffrey Irving:
3053   - Speed up conversion of paths in .sconsign files to File or Dir Nodes.
3055   From Steven Knight:
3057   - Add an Options.UnknownOptions() method that returns any settings
3058     (from the command line, or whatever dictionary was passed in)
3059     that aren't known to the Options object.
3061   - Add a Glob() function.
3063   - When removing targets with the -c option, use the absolute path (to
3064     avoid problems interpreting BuildDir() when the top-level directory
3065     is the source directory).
3067   - Fix problems with Install() and InstallAs() when called through a
3068     clone (of a clone, ...) of a cloned construction environment.
3070   - When executing a file containing Options() settings, add the file's
3071     directory to sys.path (so modules can be imported from there) and
3072     explicity set __name__ to the name of the file so the statement's
3073     in the file can deduce the location if they need to.
3075   - Fix an O(n^2) performance problem when adding sources to a target
3076     through calls to a multi Builder (including Aliases).
3078   - Redefine the $WINDOWSPROGMANIFESTSUFFIX and
3079     $WINDOWSSHLIBMANIFESTSUFFIX variables so they pick up changes to
3080     the underlying $SHLIBSUFFIX and $PROGSUFFIX variables.
3082   - Add a GetBuildFailures() function that can be called from functions
3083     registered with the Python atexit module to print summary information
3084     about any failures encountered while building.
3086   - Return a NodeList object, not a Python list, when a single_source
3087     Builder like Object() is called with more than one file.
3089   - When searching for implicit dependency files in the directories
3090     in a $*PATH list, don't create Dir Nodes for directories that
3091     don't actually exist on-disk.
3093   - Add a Requires() function to allow the specification of order-only
3094     prerequisites, which will be updated before specified "downstream"
3095     targets but which don't actually cause the target to be rebuilt.
3097   - Restore the FS.{Dir,File,Entry}.rel_path() method.
3099   - Make the default behavior of {Source,Target}Signatures('timestamp')
3100     be equivalent to 'timestamp-match', not 'timestamp-newer'.
3102   - Fix use of CacheDir with Decider('timestamp-newer') by updating
3103     the modification time when copying files from the cache.
3105   - Fix random issues with parallel (-j) builds on Windows when Python
3106     holds open file handles (especially for SCons temporary files,
3107     or targets built by Python function actions) across process creation.
3109   From Maxim Kartashev:
3111   - Fix test scripts when run on Solaris.
3113   From Gary Oberbrunner:
3115   - Fix Glob() when a pattern is in an explicitly-named subdirectory.
3117   From Philipp Scholl:
3119   - Fix setting up targets if multiple Package builders are specified
3120     at once.
3124 RELEASE 0.97.0d20070918 - Tue, 18 Sep 2007 10:51:27 -0500
3126   From Steven Knight:
3128   - Fix the wix Tool module to handle null entries in $PATH variables.
3130   - Move the documentation of Install() and InstallAs() from the list
3131     of functions to the list of Builders (now that they're implemented
3132     as such).
3134   - Allow env.CacheDir() to be set per construction environment.  The
3135     global CacheDir() function now sets an overridable global default.
3137   - Add an env.Decider() method and a Node.Decider() method that allow
3138     flexible specification of an arbitrary function to decide if a given
3139     dependency has changed since the last time a target was built.
3141   - Don't execute Configure actions (while reading SConscript files)
3142     when cleaning (-c) or getting help (-h or -H).
3144   - Add to each target an implicit dependency on the external command(s)
3145     used to build the target, as found by searching env['ENV']['PATH']
3146     for the first argument on each executed command line.
3148   - Add support for a $IMPLICIT_COMMAND_DEPENDENCIES construction
3149     variabe that can be used to disable the automatic implicit
3150     dependency on executed commands.
3152   - Add an "ensure_suffix" keyword to Builder() definitions that, when
3153     true, will add the configured suffix to the targets even if it looks
3154     like they already have a different suffix.
3156   - Add a Progress() function that allows for calling a function or string
3157     (or list of strings) to display progress while walking the DAG.
3159   - Allow ParseConfig(), MergeFlags() and ParseFlags() to handle output
3160     from a *config command with quoted path names that contain spaces.
3162   - Make the Return() function stop processing the SConscript file and
3163     return immediately.  Add a "stop=" keyword argument that can be set
3164     to False to preserve the old behavior.
3166   - Fix use of exitstatfunc on an Action.
3168   - Introduce all man page function examples with "Example:" or "Examples:".
3170   - When a file gets added to a directory, make sure the directory gets
3171     re-scanned for the new implicit dependency.
3173   - Fix handling a file that's specified multiple times in a target
3174     list so that it doesn't cause dependent Nodes to "disappear" from
3175     the dependency graph walk.
3177   From Carsten Koch:
3179   - Avoid race conditions with same-named files and directory creation
3180     when pushing copies of files to CacheDir().
3182   From Tzvetan Mikov:
3184   - Handle $ in Java class names.
3186   From Gary Oberbrunner:
3188   - Add support for the Intel C compiler on Windows64.
3190   - On SGI IRIX, have $SHCXX use $CXX by default (like other platforms).
3192   From Sohail Somani:
3194   - When Cloning a construction environment, set any variables before
3195     applying tools (so the tool module can access the configured settings)
3196     and re-set them after (so they end up matching what the user set).
3198   From Matthias Troffaes:
3200   - Make sure extra auxiliary files generated by some LaTeX packages
3201     and not ending in .aux also get deleted by scons -c.
3203   From Greg Ward:
3205   - Add a $JAVABOOTCLASSPATH variable for directories to be passed to the
3206     javac -bootclasspath option.
3208   From Christoph Wiedemann:
3210   - Add implicit dependencies on the commands used to build a target.
3215 RELEASE 0.97.0d20070809 - Fri, 10 Aug 2007 10:51:27 -0500
3217   From Lars Albertsson:
3219   - Don't error if a #include line happens to match a directory
3220     somewhere on a path (like $CPPPATH, $FORTRANPATH, etc.).
3222   From Mark Bertoglio:
3224   - Fix listing multiple projects in Visual Studio 7.[01] solution files,
3225     including generating individual project GUIDs instead of re-using
3226     the solution GUID.
3228   From Jean Brouwers:
3230   - Add /opt/SUNWspro/bin to the default execution PATH on Solaris.
3232   From Allan Erskine:
3234   - Only expect the Microsoft IDL compiler to emit *_p.c and *_data.c
3235     files if the /proxy and /dlldata switches are used (respectively).
3237   From Steven Knight:
3239   - Have --debug=explain report if a target is being rebuilt because
3240     AlwaysBuild() is specified (instead of "unknown reasons").
3242   - Support {Get,Set}Option('help') to make it easier for SConscript
3243     files to tell if a help option (-h, --help, etc.) has been specified.
3245   - Support {Get,Set}Option('random') so random-dependency interaction
3246     with CacheDir() is controllable from SConscript files.
3248   - Add a new AddOption() function to support user-defined command-
3249     line flags (like --prefix=, --force, etc.).
3251   - Replace modified Optik version with new optparse compatibility module
3252     for command line processing in Scripts/SConsOptions.py
3254   - Push and retrieve built symlinks to/from a CacheDir() as actual
3255     symlinks, not by copying the file contents.
3257   - Fix how the Action module handles stringifying the shared library
3258     generator in the Tool/mingw.py module.
3260   - When generating a config.h file, print "#define HAVE_{FEATURE} 1"
3261     instad of just "#define HAVE_{FEATURE}", for more compatibility
3262     with Autoconf-style projects.
3264   - Fix expansion of $TARGET, $TARGETS, $SOURCE and $SOURCES keywords in
3265     Visual C/C++ PDB file names.
3267   - Fix locating Visual C/C++ PDB files in build directories.
3269   - Support an env.AddMethod() method and an AddMethod() global function
3270     for adding a new method, respectively, to a construction environment
3271     or an arbitrary object (such as a class).
3273   - Fix the --debug=time option when the -j option is specified and all
3274     files are up to date.
3276   - Add a $SWIGOUTDIR variable to allow setting the swig -outdir option,
3277     and use it to identify files created by the swig -java option.
3279   - Add a $SWIGPATH variable that specifies the path to be searched
3280     for included SWIG files, Also add related $SWIGINCPREFIX and
3281     $SWIGINCSUFFIX variables that specify the prefix and suffix to
3282     be be added to each $SWIGPATH directory when expanded on the SWIG
3283     command line.
3285   - More efficient copying of construction environments (mostly borrowed
3286     from copy.deepcopy() in the standard Python library).
3288   - When printing --tree=prune output, don't print [brackets] around
3289     source files, only do so for built targets with children.
3291   - Fix interpretation of Builder source arguments when the Builder has
3292     a src_suffix *and* a source_builder and the argument has no suffix.
3294   - Fix use of expansions like ${TARGET.dir} or ${SOURCE.dir} in the
3295     following construction variables:  $FORTRANMODDIR, $JARCHDIR,
3296     $JARFLAGS, $LEXFLAGS, $SWIGFLAGS, $SWIGOUTDIR and $YACCFLAGS.
3298   - Fix dependencies on Java files generated by SWIG so they can be
3299     detected and built in one pass.
3301   - Fix SWIG when used with a BuildDir().
3303   From Leanid Nazdrynau:
3305   - When applying Tool modules after a construction environment has
3306     already been created, don't overwrite existing $CFILESUFFIX and
3307     $CXXFILESUFFIX value.
3309   - Support passing the Java() builder a list of explicit .java files
3310     (not only a list of directories to be scanned for .java files).
3312   - Support passing .java files to the Jar() and JavaH() builders, which
3313     then use the builder underlying the Java() builder to turn them into
3314     .class files.  (That is, the Jar()-Java() chain of builders become
3315     multi-step, like the Program()-Object()-CFile() builders.)
3317   - Support passing SWIG .i files to the Java builders (Java(),
3318     Jar(), JavaH()), to cause intermediate .java files to be created
3319     automatically.
3321   - Add $JAVACLASSPATH and $JAVASOURCEPATH variables, that get added to
3322     the javac "-classpath" and "-sourcepath" options.  (Note that SCons
3323     does *not* currently search these paths for implicit dependencies.)
3325   - Commonize initialization of Java-related builders.
3327   From Jan Nijtmans:
3329   - Find Java anonymous classes when the next token after the name is
3330     an open parenthesis.
3332   From Gary Oberbrunner:
3334   - Fix a code example in the man page.
3336   From Tilo Prutz:
3338   - Add support for the file names that Java 1.5 (and 1.6) generates for
3339     nested anonymous inner classes, which are different from Java 1.4.
3341   From Adam Simpkins:
3343   - Allow worker threads to terminate gracefully when all jobs are
3344     finished.
3346   From Sohail Somani:
3348   - Add LaTeX scanner support for finding dependencies specified with
3349     the \usepackage{} directive.
3353 RELEASE 0.97 - Thu, 17 May 2007 08:59:41 -0500
3355   From Steven Knight:
3357   - Fix a bug that would make parallel builds stop in their tracks if
3358     Nodes that depended on lists that contained some Nodes built together
3359     caused the reference count to drop below 0 if the Nodes were visited
3360     and commands finished in the wrong order.
3362   - Make sure the DirEntryScanner doesn't choke if it's handed something
3363     that's not a directory (Node.FS.Dir) Node.
3367 RELEASE 0.96.96 - Thu, 12 Apr 2007 12:36:25 -0500
3369   NOTE:  This is (Yet) a(nother) pre-release of 0.97 for testing purposes.
3371   From Joe Bloggs:
3373   - Man page fix:  remove cut-and-paste sentence in NoCache() description.
3375   From Dmitry Grigorenko and Gary Oberbrunner:
3377   - Use the Intel C++ compiler, not $CC, to link C++ source.
3379   From Helmut Grohne:
3381   - Fix the man page example of propagating a user's external environment.
3383   From Steven Knight:
3385   - Back out (most of) the Windows registry installer patch, which
3386     seems to not work on some versions of Windows.
3388   - Don't treat Java ".class" attributes as defining an inner class.
3390   - Fix detecting an erroneous Java anonymous class when the first
3391     non-skipped token after a "new" keyword is a closing brace.
3393   - Fix a regression when a CPPDEFINES list contains a tuple, the second
3394     item of which (the option value) is a construction variable expansion
3395     (e.g. $VALUE) and the value of the variable isn't a string.
3397   - Improve the error message if an IOError (like trying to read a
3398     directory as a file) occurs while deciding if a node is up-to-date.
3400   - Fix "maximum recursion" / "unhashable type" errors in $CPPPATH
3401     PathList expansion if a subsidiary expansion yields a stringable,
3402     non-Node object.
3404   - Generate API documentation from the docstrings (using epydoc).
3406   - Fix use of --debug=presub with Actions for out-of-the-box Builders.
3408   - Fix handling nested lists within $CPPPATH, $LIBPATH, etc.
3410   - Fix a "builders_used" AttributeError that real-world Qt initialization
3411     triggered in the refactored suffix handling for Builders.
3413   - Make the reported --debug=time timings meaningful when used with -j.
3414     Better documentation of what the times mean.
3416   - User Guide updates: --random, AlwaysBuild(), --tree=,
3417     --debug=findlibs, --debug=presub, --debug=stacktrace,
3418     --taskmastertrace.
3420   - Document (in both man page and User's Guide) that --implicit-cache
3421     ignores changes in $CPPPATH, $LIBPATH, etc.
3423   From Jean-Baptiste Lab:
3425   - Remove hard-coded dependency on Python 2.2 from Debian packaging files.
3427   From Jeff Mahovsky:
3429   - Handle spaces in the build target name in Visual Studio project files.
3431   From Rob Managan:
3433   - Re-run LaTeX after BibTeX has been re-run in response to a changed
3434     .bib file.
3436   From Joel B. Mohler:
3438   - Make additional TeX auxiliary files (.toc, .idx and .bbl files)
3439     Precious so their removal doesn't affect whether the necessary
3440     sections are included in output PDF or PostScript files.
3442   From Gary Oberbrunner:
3444   - Fix the ability to import modules in the site_scons directory from
3445     a subdirectory.
3447   From Adam Simpkins:
3449   - Make sure parallel (-j) builds all targets even if they show up
3450     multiple times in the child list (as a source and a dependency).
3452   From Matthias Troffaes:
3454   - Don't re-run TeX if the triggering strings (\makeindex, \bibliography
3455     \tableofcontents) are commented out.
3457   From Richard Viney:
3459   - Fix use of custom include and lib paths with Visual Studio 8.
3461   - Select the default .NET Framework SDK Dir based on the version of
3462     Visual Studio being used.
3466 RELEASE 0.96.95 - Mon, 12 Feb 2007 20:25:16 -0600
3468   From Anatoly Techtonik:
3470   - Add the scons.org URL and a package description to the setup.py
3471     arguments.
3473   - Have the Windows installer add a registry entry for scons.bat in the
3474     "App Paths" key, so scons.bat can be executed without adding the
3475     directory to the %PATH%.  (Python itself works this way.)
3477   From Anonymous:
3479   - Fix looking for default paths in Visual Studio 8.0 (and later).
3481   - Add -lm to the list of default D libraries for linking.
3483   From Matt Doar:
3485   - Provide a more complete write-your-own-Scanner example in the man page.
3487   From Ralf W. Grosse-Kunstleve:
3489   - Contributed upstream Python change to our copied subprocess.py module
3490     for more efficient standard input processing.
3492   From Steven Knight:
3494   - Fix the Node.FS.Base.rel_path() method when the two nodes are on
3495     different drive letters.  (This caused an infinite loop when
3496     trying to write .sconsign files.)
3498   - Fully support Scanners that use a dictionary to map file suffixes
3499     to other scanners.
3501   - Support delayed evaluation of the $SPAWN variable to allow selection
3502     of a function via ${} string expansions.
3504   - Add --srcdir as a synonym for -Y/--repository.
3506   - Document limitations of #include "file.h" with Repository().
3508   - Fix use of a toolpath under the source directory of a BuildDir().
3510   - Fix env.Install() with a file name portion that begins with '#'.
3512   - Fix ParseConfig()'s handling of multiple options in a string that's
3513     replaced a *FLAGS construction variable.
3515   - Have the C++ tools initialize common C compilation variables ($CCFLAGS,
3516     $SHCCFLAGS and $_CCCOMCOM) even if the 'cc' Tool isn't loaded.
3518   From Leanid Nazdrynau:
3520   - Fix detection of Java anonymous classes if a newline precedes the
3521     opening brace.
3523   From Gary Oberbrunner:
3525   - Document use of ${} to execute arbitrary Python code.
3527   - Add support for:
3528     1) automatically adding a site_scons subdirectory (in the top-level
3529        SConstruct directory) to sys.path (PYTHONPATH);
3530     2) automatically importing site_scons/site_init.py;
3531     3) automatically adding site_scons/site_tools to the toolpath.
3533   From John Pye:
3535   - Change ParseConfig() to preserve white space in arguments passed in
3536     as a list.
3538   From a smith:
3540   - Fix adding explicitly-named Java inner class files (and any
3541     other file names that may contain a '$') to Jar files.
3543   From David Vitek:
3545   - Add a NoCache() function to mark targets as unsuitable for propagating
3546     to (or retrieving from) a CacheDir().
3548   From Ben Webb:
3550   - If the swig -noproxy option is used, it won't generate a .py file,
3551     so don't emit it as a target that we expect to be built.
3555 RELEASE 0.96.94 - Sun, 07 Jan 2007 18:36:20 -0600
3557   NOTE:  This is a pre-release of 0.97 for testing purposes.
3559   From Anonymous:
3561   - Allow arbitrary white space after a SWIG %module declaration.
3563   From Paul:
3565   - When compiling resources under MinGW, make sure there's a space
3566     between the --include-dir option and its argument.
3568   From Jay Kint:
3570   - Alleviate long command line issues on Windows by executing command
3571     lines directly via os.spawnv() if the command line doesn't need
3572     shell interpretation (has no pipes, redirection, etc.).
3574   From Walter Franzini:
3576   - Exclude additional Debian packaging files from the copyright check.
3578   From Fawad Halim:
3580   - Handle the conflict between the impending Python 2.6 'as' keyword
3581     and our Tool/as.py module name.
3583   From Steven Knight:
3585   - Speed up the Node.FS.Dir.rel_path() method used to generate path names
3586     that get put into the .sconsign* file(s).
3588   - Optimize Node.FS.Base.get_suffix() by computing the suffix once, up
3589     front, when we set the Node's name.  (Duh...)
3591   - Reduce the Memoizer's responsibilities to simply counting hits and
3592     misses when the --debug=memoizer option is used, not to actually
3593     handling the key calculation and memoization itself.  This speeds
3594     up some configurations significantly, and should cause no functional
3595     differences.
3597   - Add a new scons-time script with subcommands for generating
3598     consistent timing output from SCons configurations, extracting
3599     various information from those timings, and displaying them in
3600     different formats.
3602   - Reduce some unnecessary stat() calls from on-disk entry type checks.
3604   - Fix SideEffect() when used with -j, which was badly broken in 0.96.93.
3606   - Propagate TypeError exceptions when evaluating construction variable
3607     expansions up the stack, so users can see what's going on.
3609   - When disambiguating a Node.FS.Entry into a Dir or File, don't look
3610     in the on-disk source directory until we've confirmed there's no
3611     on-disk entry locally and there *is* one in the srcdir.  This avoids
3612     creating a phantom Node that can interfere with dependencies on
3613     directory contents.
3615   - Add an AllowSubstExceptions() function that gives the SConscript
3616     files control over what exceptions cause a string to expand to ''
3617     vs. terminating processing with an error.
3619   - Allow the f90.py and f95.py Tool modules to compile earlier source
3620     source files of earlier Fortran version.
3622   - Fix storing signatures of files retrieved from CacheDir() so they're
3623     correctly identified as up-to-date next invocation.
3625   - Make sure lists of computed source suffixes cached by Builder objects
3626     don't persist across changes to the list of source Builders (so the
3627     addition of suffixes like .ui by the qt.py Tool module take effect).
3629   - Enhance the bootstrap.py script to allow it to be used to execute
3630     SCons more easily from a checked-out source tree.
3632   From Ben Leslie:
3634   - Fix post-Memoizer value caching misspellings in Node.FS._doLookup().
3636   From Rob Managan, Dmitry Mikhin and Joel B. Mohler:
3638   - Handle TeX/LaTeX files in subdirectories by changing directory
3639     before invoking TeX/LaTeX.
3641   - Scan LaTeX files for \bibliography lines.
3643   - Support multiple file names in a "\bibliography{file1,file2}" string.
3645   - Handle TeX warnings about undefined citations.
3647   - Support re-running LaTeX if necessary due to a Table of Contents.
3649   From Dmitry Mikhin:
3651   - Return LaTeX if "Rerun to get citations correct" shows up on the next
3652     line after the "Warning:" string.
3654   From Gary Oberbrunner:
3656   - Add #include lines to fix portability issues in two tests.
3658   - Eliminate some unnecessary os.path.normpath() calls.
3660   - Add a $CFLAGS variable for C-specific options, leaving $CCFLAGS
3661     for options common to C and C++.
3663   From Tom Parker:
3665   - Have the error message print the missing file that Qt can't find.
3667   From John Pye:
3669   - Fix env.MergeFlags() appending to construction variable value of None.
3671   From Steve Robbins:
3673   - Fix the "sconsign" script when the .sconsign.dblite file is explicitly
3674     specified on the command line (and not intuited from the old way of
3675     calling it with just ".sconsign").
3677   From Jose Pablo Ezequiel "Pupeno" Fernandez Silva:
3679   - Give the 'lex' tool knowledge of the additional target files produced
3680     by the flex "--header-file=" and "--tables-file=" options.
3682   - Give the 'yacc' tool knowledge of the additional target files produced
3683     by the bison "-g", "--defines=" and "--graph=" options.
3685   - Generate intermediate files with Objective C file suffixes (.m) when
3686     the lex and yacc source files have appropriate suffixes (.lm and .ym).
3688   From Sohail Somain:
3690   - Have the mslink.py Tool only look for a 'link' executable on Windows
3691     systems.
3693   From Vaclav Smilauer:
3695   - Add support for a "srcdir" keyword argument when calling a Builder,
3696     which will add a srcdir prefix to all non-relative string sources.
3698   From Jonathan Ultis:
3700   - Allow Options converters to take the construction environment as
3701     an optional argument.
3705 RELEASE 0.96.93 - Mon, 06 Nov 2006 00:44:11 -0600
3707   NOTE:  This is a pre-release of 0.97 for testing purposes.
3709   From Anonymous:
3711   - Allow Python Value Nodes to be Builder targets.
3713   From Matthias:
3715   - Only filter Visual Studio common filename prefixes on complete
3716     directory names.
3718   From Chad Austin:
3720   - Fix the build of the SCons documentation on systems that don't
3721     have "python" in the $PATH.
3723   From Ken Boortz:
3725   - Enhance ParseConfig() to recognize options that begin with '+'.
3727   From John Calcote, Elliot Murphy:
3729   - Document ways to override the CCPDBFLAGS variable to use the
3730     Microsoft linker's /Zi option instead of the default /Z7.
3732   From Christopher Drexler:
3734   - Make SCons aware bibtex must be called if any \include files
3735     cause creation of a bibliography.
3737   - Make SCons aware that "\bilbiography" in TeX source files means
3738     that related .bbl and .blg bibliography files will be created.
3739     (NOTE:  This still needs to search for the string in \include files.)
3741   From David Gruener:
3743   - Fix inconsistent handling of Action strfunction arguments.
3745   - Preserve white space in display Action strfunction strings.
3747   From James Y. Knight and Gerard Patel:
3749   - Support creation of shared object files from assembly language.
3751   From Steven Knight:
3753   - Speed up the Taskmaster significantly by avoiding unnecessary
3754     re-scans of Nodes to find out if there's work to be done, having it
3755     track the currently-executed top-level target directly and not
3756     through its presence on the target list, and eliminating some other
3757     minor list(s), method(s) and manipulation.
3759   - Fix the expansion of $TARGET and $SOURCE in the expansion of
3760     $INSTALLSTR displayed for non-environment calls to InstallAs().
3762   - Fix the ability to have an Alias() call refer to a directory
3763     name that's not identified as a directory until later.
3765   - Enhance runtest.py with an option to use QMTest as the harness.
3766     This will become the default behavior as we add more functionality
3767     to the QMTest side.
3769   - Let linking on mingw use the default function that chooses $CC (gcc)
3770     or $CXX (g++) depending on whether there are any C++ source files.
3772   - Work around a bug in early versions of the Python 2.4 profile module
3773     that caused the --profile= option to fail.
3775   - Only call Options validators and converters once when initializing a
3776     construction environment.
3778   - Fix the ability of env.Append() and env.Prepend(), in all known Python
3779     versions, to handle different input value types when the construction
3780     variable being updated is a dictionary.
3782   - Add a --cache-debug option for information about what files it's
3783     looking for in a CacheDir().
3785   - Document the difference in construction variable expansion between
3786     {Action,Builder}() and env.{Action,Builder}().
3788   - Change the name of env.Copy() to env.Clone(), keeping the old name
3789     around for backwards compatibility (with the intention of eventually
3790     phasing it out to avoid confusion with the Copy() Action factory).
3792   From Arve Knudsen:
3794   - Support cleaning and scanning SWIG-generated files.
3796   From Carsten Koch:
3798   - Allow selection of Visual Studio version by setting $MSVS_VERSION
3799     after construction environment initialization.
3801   From Jean-Baptiste Lab:
3803   - Try using zipimport if we can't import Tool or Platform modules
3804     using the normal "imp" module.  This allows SCons to be packaged
3805     using py2exe's all-in-one-zip-file approach.
3807   From Ben Liblit:
3809   - Do not re-scan files if the scanner returns no implicit dependencies.
3811   From Sanjoy Mahajan:
3813   - Change use of $SOURCES to $SOURCE in all TeX-related Tool modules.
3815   From Joel B. Mohler:
3817   - Make SCons aware that "\makeindex" in TeX source files means that
3818     related .ilg, .ind and .idx index files will be created.
3819     (NOTE:  This still needs to search for the string in \include files.)
3821   - Prevent scanning the TeX .aux file for additional files from
3822     trying to remove it twice when the -c option is used.
3824   From Leanid Nazdrynau:
3826   - Give the MSVC RES (resource) Builder a src_builder list and a .rc
3827     src_suffix so other builders can generate .rc files.
3829   From Matthew A. Nicholson:
3831   - Enhance Install() and InstallAs() to handle directory trees as sources.
3833   From Jan Nijtmans:
3835   - Don't use the -fPIC flag when using gcc on Windows (e.g. MinGW).
3837   From Greg Noel:
3839   - Add an env.ParseFlags() method that provides separate logic for
3840     parsing GNU tool chain flags into a dictionary.
3842   - Add an env.MergeFlags() method to apply an arbitrary dictionary
3843     of flags to a construction environment's variables.
3845   From Gary Oberbrunner:
3847   - Fix parsing tripartite Intel C compiler version numbers on Linux.
3849   - Extend the ParseConfig() function to recognize -arch and
3850     -isysroot options.
3852   - Have the error message list the known suffixes when a Builder call
3853     can't build a source file with an unknown suffix.
3855   From Karol Pietrzak:
3857   - Avoid recursive calls to main() in the program snippet used by the
3858     SConf subsystem to test linking against libraries.  This changes the
3859     default behavior of CheckLib() and CheckLibWithHeader() to print
3860     "Checking for C library foo..." instead of "Checking for main()
3861     in C library foo...".
3863   From John Pye:
3865   - Throw an exception if a command called by ParseConfig() or
3866     ParseFlags() returns an error.
3868   From Stefan Seefeld:
3870   - Initial infrastructure for running SCons tests under QMTest.
3872   From Sohail Somani:
3874   - Fix tests that fail due to gcc warnings.
3876   From Dobes Vandermeer:
3878   - In stack traces, print the full paths of SConscript files.
3880   From Atul Varma:
3882   - Fix detection of Visual C++ Express Edition.
3884   From Dobes Vandermeer:
3886   - Let the src_dir option to the SConscript() function affect all the
3887     the source file paths, instead of treating all source files paths
3888     as relative to the SConscript directory itself.
3890   From Nicolas Vigier:
3892   - Fix finding Fortran modules in build directories.
3894   - Fix use of BuildDir() when the source file in the source directory
3895     is a symlink with a relative path.
3897   From Edward Wang:
3899   - Fix the Memoizer when the SCons Python modules are executed from
3900     .pyo files at different locations from where they were compiled.
3902   From Johan Zander:
3904   - Fix missing os.path.join() when constructing the $FRAMEWORKSDKDIR/bin.
3908 RELEASE 0.96.92 - Mon, 10 Apr 2006 21:08:22 -0400
3910   NOTE:  This was a pre-release of 0.97 for testing purposes.
3912   From Anonymous:
3914   - Fix the intelc.py Tool module to not throw an exception if the
3915     only installed version is something other than ia32.
3917   - Set $CCVERSION when using gcc.
3919   From Matthias:
3921   - Support generating project and solution files for Microsoft
3922     Visual Studio version 8.
3924   - Support generating more than one project file for a Microsoft
3925     Visual Studio solution file.
3927   - Add support for a support "runfile" parameter to Microsoft
3928     Visual Studio project file creation.
3930   - Put the project GUID, not the solution GUID, in the right spot
3931     in the solution file.
3933   From Erling Andersen:
3935   - Fix interpretation of Node.FS objects wrapped in Proxy instances,
3936     allowing expansion of things like ${File(TARGET)} in command lines.
3938   From Stanislav Baranov:
3940   - Add a separate MSVSSolution() Builder, with support for the
3941     following new construction variables: $MSVSBUILDCOM, $MSVSCLEANCOM,
3942     $MSVSENCODING, $MSVSREBUILDCOM, $MSVSSCONS, $MSVSSCONSCOM,
3943     $MSVSSCONSFLAGS, $MSVSSCONSCRIPT and $MSVSSOLUTIONCOM.
3945   From Ralph W. Grosse-Kunstleve and Patrick Mezard:
3947   - Remove unneceesary (and incorrect) SCons.Util strings on some function
3948     calls in SCons.Util.
3950   From Bob Halley:
3952   - Fix C/C++ compiler selection on AIX to not always use the external $CC
3953     environment variable.
3955   From August Hörandl:
3957   - Add a scanner for \include and \import files, with support for
3958     searching a directory list in $TEXINPUTS (imported from the external
3959     environment).
3961   - Support $MAKEINDEX, $MAKEINDEXCOM, $MAKEINDEXCOMSTR and
3962     $MAKEINDEXFLAGS for generating indices from .idx files.
3964   From Steven Johnson:
3966   - Add a NoClean() Environment method and function to override removal
3967     of targets during a -c clean, including documentation and tests.
3969   From Steven Knight:
3971   - Check for whether files exist on disk by listing the directory
3972     contents, not calling os.path.exists() file by file.  This is
3973     somewhat more efficient in general, and may be significantly
3974     more efficient on Windows.
3976   - Minor speedups in the internal is_Dict(), is_List() and is_String()
3977     functions.
3979   - Fix a signature refactoring bug that caused Qt header files to
3980     get re-generated every time.
3982   - Don't fail when writing signatures if the .sconsign.dblite file is
3983     owned by a different user (e.g. root) from a previous run.
3985   - When deleting variables from stacked OverrideEnvironments, don't
3986     throw a KeyError if we were able to delte the variable from any
3987     Environment in the stack.
3989   - Get rid of the last indentation tabs in the SCons source files and
3990     add -tt to the Python invocations in the packaging build and the
3991     tests so they don't creep back in.
3993   - In Visual Studio project files, put quotes around the -C directory
3994     so everything works even if the path has spaces in it.
3996   - The Intel Fortran compiler uses -object:$TARGET, not "-o $TARGET",
3997     when building object files on Windows.  Have the the ifort Tool
3998     modify the default command lines appropriately.
4000   - Document the --debug=explain option in the man page.  (How did we
4001     miss this?)
4003   - Add a $LATEXRETRIES variable to allow configuration of the number of
4004     times LaTex can be re-called to try to resolve undefined references.
4006   - Change the order of the arguments to Configure.Checklib() to match
4007     the documentation.
4009   - Handle signature calculation properly when the Python function used
4010     for a FunctionAction is an object method.
4012   - On Windows, assume that absolute path names without a drive letter
4013     refer to the drive on which the SConstruct file lives.
4015   - Add /usr/ccs/bin to the end of the the default external execution
4016     PATH on Solaris.
4018   - Add $PKGCHK and $PKGINFO variables for use on Solaris when searching
4019     for the SunPRO C++ compiler.  Make the default value for $PKGCHK
4020     be /usr/sbin/pgkchk (since /usr/sbin isn't usually on the external
4021     execution $PATH).
4023   - Fix a man page example of overriding variables when calling
4024     SharedLibrary() to also set the $LIBSUFFIXES variable.
4026   - Add a --taskmastertrace=FILE option to give some insight on how
4027     the taskmaster decides what Node to build next.
4029   - Changed the names of the old $WIN32DEFPREFIX, $WIN32DEFSUFFIX,
4030     $WIN32DLLPREFIX and $WIN32IMPLIBPREFIX construction variables to
4031     new $WINDOWSDEFPREFIX, $WINDOWSDEFSUFFIX, $WINDOWSDLLPREFIX and
4032     $WINDOWSIMPLIBPREFIX construction variables.  The old names are now
4033     deprecated, but preserved for backwards compatibility.
4035   - Fix (?) a runtest.py hang on Windows when the --xml option is used.
4037   - Change the message when an error occurs trying to interact with the
4038     file system to report the target(s) in square brackets (as before) and
4039     the actual file or directory that encountered the error afterwards.
4041   From Chen Lee:
4043   - Add x64 support for Microsoft Visual Studio 8.
4045   From Baptiste Lepilleur:
4047   - Support the --debug=memory option on Windows when the Python version
4048     has the win32process and win32api modules.
4050   - Add support for Visual Studio 2005 Pro.
4052   - Fix portability issues in various tests: test/Case.py,
4053     Test/Java/{JAR,JARCHDIR,JARFLAGS,JAVAC,JAVACFLAGS,JAVAH,RMIC}.py,
4054     test/MSVS/vs-{6.0,7.0,7.1,8.0}-exec.py,
4055     test/Repository/{Java,JavaH,RMIC}.py,
4056     test/QT/{generated-ui,installed,up-to-date,warnings}.py,
4057     test/ZIP/ZIP.py.
4059   - Ignore pkgchk errors on Solaris when searching for the C++ compiler.
4061   - Speed up the SCons/EnvironmentTests.py unit tests.
4063   - Add a --verbose= option to runtest.py to print executed commands
4064     and their output at various levels.
4066   From Christian Maaser:
4068   - Add support for Visual Studio Express Editions.
4070   - Add support for Visual Studio 8 *.manifest files, includng
4071     new $WINDOWS_INSERT_MANIFEST, $WINDOWSPROGMANIFESTSUFFIX,
4072     $WINDOWSPROGMANIFESTPREFIX, $WINDOWSPROGMANIFESTSUFFIX,
4073     $WINDOWSSHLIBMANIFESTPREFIX and $WINDOWSSHLIBMANIFESTSUFFIX
4074     construction variables.
4076   From Adam MacBeth:
4078   - Fix detection of additional Java inner classes following use of a
4079     "new" keyword inside an inner class.
4081   From Sanjoy Mahajan:
4083   - Correct TeX-related command lines to just $SOURCE, not $SOURCES
4085   From Patrick Mezard:
4087   - Execute build commands for a command-line target if any of the
4088     files built along with the target is out of date or non-existent,
4089     not just if the command-line target itself is out of date.
4091   - Fix the -n option when used with -c to print all of the targets
4092     that will be removed for a multi-target Builder call.
4094   - If there's no file in the source directory, make sure there isn't
4095     one in the build directory, too, to avoid dangling files left
4096     over from previous runs when a source file is removed.
4098   - Allow AppendUnique() and PrependUnique() to append strings (and
4099     other atomic objects) to lists.
4101   From Joel B. Mohler:
4103   - Extend latex.py, pdflatex.py, pdftex.py and tex.py so that building
4104     from both TeX and LaTeX files uses the same logic to call $BIBTEX
4105     when it's necessary, to call $MAKEINDEX when it's necessary, and to
4106     call $TEX or $LATEX multiple times to handle undefined references.
4108   - Add an emitter to the various TeX builders so that the generated
4109     .aux and .log files also get deleted by the -c option.
4111   From Leanid Nazdrynau:
4113   - Fix the Qt UIC scanner to work with generated .ui files (by using
4114     the FindFile() function instead of checking by-hand for the file).
4116   From Jan Nieuwenhuizen:
4118   - Fix a problem with interpreting quoted argument lists on command lines.
4120   From Greg Noel:
4122   - Add /sw/bin to the default execution PATH on Mac OS X.
4124   From Kian Win Ong:
4126   - When building a .jar file and there is a $JARCHDIR, put the -C
4127     in front of each .class file on the command line.
4129   - Recognize the Java 1.5 enum keyword.
4131   From Asfand Yar Qazi:
4133   - Add /opt/bin to the default execution PATH on all POSIX platforms
4134     (between /usr/local/bin and /bin).
4136   From Jon Rafkind:
4138   - Fix the use of Configure() contexts from nested subsidiary
4139     SConscript files.
4141   From Christoph Schulz:
4143   - Add support for $CONFIGUREDIR and $CONFIGURELOG variables to control
4144     the directory and logs for configuration tests.
4146   - Add support for a $INSTALLSTR variable.
4148   - Add support for $RANLIBCOM and $RANLIBCOMSTR variables (which fixes
4149     a bug when setting $ARCOMSTR).
4151   From Amir Szekely:
4153   - Add use of $CPPDEFINES to $RCCOM (resource file compilation) on MinGW.
4155   From Erick Tryzelaar:
4157   - Fix the error message when trying to report that a given option is
4158     not gettable/settable from an SConscript file.
4160   From Dobes Vandermeer:
4162   - Add support for SCC and other settings in Microsoft Visual
4163     Studio project and solution files:  $MSVS_PROJECT_BASE_PATH,
4164     $MSVS_PROJECT_GUID, $MSVS_SCC_AUX_PATH, $MSVS_SCC_LOCAL_PATH,
4165     $MSVS_SCC_PROJECT_NAME, $MSVS_SCC_PROVIDER,
4167   - Add support for using a $SCONS_HOME variable (imported from the
4168     external environment, or settable internally) to put a shortened
4169     SCons execution line in the Visual Studio project file.
4171   From David J. Van Maren:
4173   - Only filter common prefixes from source files names in Visual Studio
4174     project files if the prefix is a complete (sub)directory name.
4176   From Thad Ward:
4178   - If $MSVSVERSIONS is already set, don't overwrite it with
4179     information from the registry.
4183 RELEASE 0.96.91 - Thu, 08 Sep 2005 07:18:23 -0400
4185   NOTE:  This was a pre-release of 0.97 for testing purposes.
4187   From Chad Austin:
4189   - Have the environment store the toolpath and re-use it to find Tools
4190     modules during later Copy() or Tool() calls (unless overridden).
4192   - Normalize the directory path names in SConsignFile() database
4193     files so the same signature file can interoperate on Windows and
4194     non-Windows systems.
4196   - Make --debug=stacktrace print a stacktrace when a UserError is thrown.
4198   - Remove an old, erroneous cut-and-paste comment in Scanner/Dir.py.
4200   From Stanislav Baranov:
4202   - Make it possible to support with custom Alias (sub-)classes.
4204   - Allow Builders to take empty source lists when called.
4206   - Allow access to both TARGET and SOURCE in $*PATH expansions.
4208   - Allow SConscript files to modify BUILD_TARGETS.
4210   From Timothee Besset:
4212   - Add support for Objective C/C++ .m and .mm file suffixes (for
4213     Mac OS X).
4215   From Charles Crain
4217   - Fix the PharLap linkloc.py module to use target+source arguments
4218     when calling env.subst().
4220   From Bjorn Eriksson:
4222   - Fix an incorrect Command() keyword argument in the man page.
4224   - Add a $TEMPFILEPREFIX variable to control the prefix or flag used
4225     to pass a long-command-line-execution tempfile to a command.
4227   From Steven Knight:
4229   - Enhanced the SCons setup.py script to install man pages on
4230     UNIX/Linux systems.
4232   - Add support for an Options.FormatOptionHelpText() method that can
4233     be overridden to customize the format of Options help text.
4235   - Add a global name for the Entry class (which had already been
4236     documented).
4238   - Fix re-scanning of generated source files for implicit dependencies
4239     when the -j option is used.
4241   - Fix a dependency problem that caused $LIBS scans to not be added
4242     to all of the targets in a multiple-target builder call, which
4243     could cause out-of-order builds when the -j option is used.
4245   - Store the paths of source files and dependencies in the .sconsign*
4246     file(s) relative to the target's directory, not relative to the
4247     top-level SConstruct directory.  This starts to make it possible to
4248     subdivide the dependency tree arbitrarily by putting an SConstruct
4249     file in every directory and using content signatures.
4251   - Add support for $YACCHFILESUFFIX and $YACCHXXFILESUFFIX variables
4252     that accomodate parser generators that write header files to a
4253     different suffix than the hard-coded .hpp when the -d option is used.
4255   - The default behavior is now to store signature information in a
4256     single .sconsign.dblite file in the top-level SConstruct directory.
4257     The old behavior of a separate .sconsign file in each directory can
4258     be specified by calling SConsignFile(None).
4260   - Remove line number byte codes within the signature calculation
4261     of Python function actions, so that changing the location of an
4262     otherwise unmodified Python function doesn't cause rebuilds.
4264   - Fix AddPreAction() and AddPostAction() when an action has more than
4265     one target file:  attach the actions to the Executor, not the Node.
4267   - Allow the source directory of a BuildDir / build_dir to be outside
4268     of the top-level SConstruct directory tree.
4270   - Add a --debug=nomemoizer option that disables the Memoizer for clearer
4271     looks at the counts and profiles of the underlying function calls,
4272     not the Memoizer wrappers.
4274   - Print various --debug= stats even if we exit early (e.g. using -h).
4276   - Really only use the cached content signature value if the file
4277     is older than --max-drift, not just if --max-drift is set.
4279   - Remove support for conversion from old (pre 0.96) .sconsign formats.
4281   - Add support for a --diskcheck option to enable or disable various
4282     on-disk checks:  that File and Dir nodes match on-disk entries;
4283     whether an RCS file exists for a missing source file; whether an
4284     SCCS file exists for a missing source file.
4286   - Add a --raw argument to the sconsign script, so it can print a
4287     raw representation of each entry's NodeInfo dictionary.
4289   - Add the 'f90' and 'f95' tools to the list of Fortran compilers
4290     searched for by default.
4292   - Add the +Z option by default when compiling shared objects on
4293     HP-UX.
4295   From Chen Lee:
4297   - Handle Visual Studio project and solution files in Unicode.
4299   From Sanjoy Mahajan:
4301   - Fix a bad use of Copy() in an example in the man page, and a
4302     bad regular expression example in the man page and User's Guide.
4304   From Shannon Mann:
4306   - Have the Visual Studio project file(s) echo "Starting SCons" before
4307     executing SCons, mainly to work around a quote-stripping bug in
4308     (some versions of?) the Windows cmd command executor.
4310   From Georg Mischler:
4312   - Remove the space after the -o option when invoking the Borland
4313     BCC compiler; some versions apparently require that the file name
4314     argument be concatenated with the option.
4316   From Leanid Nazdrynau:
4318   - Fix the Java parser's handling of backslashes in strings.
4320   From Greg Noel:
4322   - Add construction variables to support frameworks on Mac OS X:
4323     $FRAMEWORKS, $FRAMEWORKPREFIX, $FRAMEWORKPATH, $FRAMEWORKPATHPREFIX.
4325   - Re-order link lines so the -o option always comes right after the
4326     command name.
4328   From Gary Oberbrunner:
4330   - Add support for Intel C++ beta 9.0 (both 32 and 64 bit versions).
4332   - Document the new $FRAMEWORK* variables for Mac OS X.
4334   From Karol Pietrzak:
4336   - Add $RPATH (-R) support to the Sun linker Tool (sunlink).
4338   - Add a description of env.subst() to the man page.
4340   From Chris Prince:
4342   - Look in the right directory, not always the local directory, for a
4343     same-named file or directory conflict on disk.
4345   - On Windows, preserve the external environment's %SYSTEMDRIVE%
4346     variable, too.
4348   From Craig Scott:
4350   - Have the Fortran module emitter look for Fortan modules to be created
4351     relative to $FORTRANMODDIR, not the top-level directory.
4353   - When saving Options to a file, run default values through the
4354     converter before comparing them with the set values.  This correctly
4355     suppresses Boolean Option values from getting written to the saved
4356     file when they're one of the many synonyms for a default True or
4357     False value.
4359   - Fix the Fortran Scanner's ability to handle a module being used
4360     in the same file in which it is defined.
4362   From Steve-o:
4364   - Add the -KPIC option by default when compiling shared objects on
4365     Solaris.
4367   - Change the default suffix for Solaris objects to .o, to conform to
4368     Sun WorkShop's expectations.  Change the profix to so_ so they can
4369     still be differentiated from static objects in the same directory.
4371   From Amir Szekely:
4373   - When calling the resource compiler on MinGW, add --include-dir and
4374     the source directory so it finds the source file.
4376   - Update EnsureSConsVersion() to support revision numbers.
4378   From Greg Ward:
4380   - Fix a misplaced line in the man page.
4384 RELEASE 0.96.90 - Tue, 15 Feb 2005 21:21:12 +0000
4386   NOTE:  This was a pre-release of 0.97 for testing purposes.
4388   From Anonymous:
4390   - Fix Java parsing to avoid erroneously identifying a new array
4391     of class instances as an anonymous inner class.
4393   - Fix a typo in the man page description of PathIsDirCreate.
4395   From Chad Austin:
4397   - Allow Help() to be called multiple times, appending to the help
4398     text each call.
4400   - Allow Tools found on a toolpath to import Python modules from
4401     their local directory.
4403   From Steve Christensen:
4405   - Handle exceptions from Python functions as build actions.
4407   - Add a set of canned PathOption validators:  PathExists (the default),
4408     PathIsFile, PathIsDir and PathIsDirCreate.
4410   From Matthew Doar:
4412   - Add support for .lex and .yacc file suffixes for Lex and Yacc files.
4414   From Eric Frias:
4416   - Huge performance improvement:  wrap the tuples representing an
4417     include path in an object, so that the time it takes to hash the
4418     path doesn't grow porportionally to the length of the path.
4420   From Gottfried Ganssauge:
4422   - Fix SCons on SuSE/AMD-64 Linux by having the wrapper script also
4423     check for the build engine in the parent directory of the Python
4424     library directory (/usr/lib64 instead of /usr/lib).
4426   From Stephen Kennedy:
4428   - Speed up writing the .sconsign file at the end of a run by only
4429     calling sync() once at the end, not after every entry.
4431   From Steven Knight:
4433   - When compiling with Microsoft Visual Studio, don't include the ATL and
4434     MFC directories in the default INCLUDE and LIB environment variables.
4436   - Remove the following deprecated features:  the ParseConfig()
4437     global function (deprecated in 0.93); the misspelled "validater"
4438     keyword to the Options.Add() method (deprecated in 0.91); the
4439     SetBuildSignatureType(), SetContentSignatureType(), SetJobs() and
4440     GetJobs() global functions (deprecated in 0.14).
4442   - Fix problems with corrupting the .sconsign.dblite file when
4443     interrupting builds by writing to a temporary file and renaming,
4444     not writing the file directly.
4446   - Fix a 0.96 regression where when running with -k, targets built from
4447     walking dependencies later on the command line would not realize
4448     that a dependency had failed an earlier build attempt, and would
4449     try to rebuild the dependent targets.
4451   - Change the final messages when using -k and errors occur from
4452     "{building,cleaning} terminated because of errors" to "done
4453     {building,cleaning} targets (errors occurred during {build,clean})."
4455   - Allow Configure.CheckFunc() to take an optional header argument
4456     (already supported by Conftest.py) to specify text at the top of
4457     the compiled test file.
4459   - Fix the --debug=explain output when a Python function action changed
4460     so it prints a meaningful string, not the binary representation of
4461     the function contents.
4463   - Allow a ListOption's default value(s) to be a Python list of specified
4464     values, not just a string containing a comma-separated list of names.
4466   - Add a ParseDepends() function that will parse up a list of explicit
4467     dependencies from a "make depend" style file.
4469   - Support the ability to change directory when executing an Action
4470     through "chdir" keyword arguments to Action and Builder creation
4471     and calls.
4473   - Fix handling of Action ojects (and other callables that don't match
4474     our calling arguments) in construction variable expansions.
4476   - On Win32, install scons.bat in the Python directory when installing
4477     from setup.py.  (The bdist_wininst installer was already doing this.)
4479   - Fix env.SConscript() when called with a list of SConscipt files.
4480     (The SConscript() global function already worked properly.)
4482   - Add a missing newline to the end of the --debug=explain "unknown
4483     reasons" message.
4485   - Enhance ParseConfig() to work properly for spaces in between the -I,
4486     -L and -l options and their arguments.
4488   - Packaging build fix:  Rebuild the files that are use to report the
4489     --version of SCons whenever the development version number changes.
4491   - Fix the ability to specify a target_factory of Dir() to a Builder,
4492     which the default create-a-directory Builder was interfering with.
4494   - Mark a directory as built if it's created as part of the preparation
4495     for another target, to avoid trying to build it again when it comes
4496     up in the target list.
4498   - Allow a function with the right calling signature to be put directly
4499     in an Environment's BUILDERS dictionary, making for easier creation
4500     and use of wrappers (pseudo-Builders) that call other Builders.
4502   - On Python 2.x, wrap lists of Nodes returned by Builders in a UserList
4503     object that adds a method that makes str() object return a string
4504     with all of the Nodes expanded to their path names.  (Builders under
4505     Python 1.5.2 still return lists to avoid TypeErrors when trying
4506     to extend() list, so Python 1.5.2 doesn't get pretty-printing of Node
4507     lists, but everything should still function.)
4509   - Allow Aliases to have actions that will be executed whenever
4510     any of the expanded Alias targets are out of date.
4512   - Fix expansion of env.Command() overrides within target and
4513     source file names.
4515   - Support easier customization of what's displayed by various default
4516     actions by adding lots of new construction variables: $ARCOMSTR,
4517     $ASCOMSTR, $ASPPCOMSTR, $BIBTEXCOMSTR, $BITKEEPERCOMSTR, $CCCOMSTR,
4518     $CVSCOMSTR, $CXXCOMSTR, $DCOMSTR, $DVIPDFCOMSTR, $F77COMSTR,
4519     $F90COMSTR, $F95COMSTR, $FORTRANCOMSTR, $GSCOMSTR, $JARCOMSTR,
4520     $JAVACCOMSTR, $JAVAHCOMSTR, $LATEXCOMSTR, $LEXCOMSTR, $LINKCOMSTR,
4521     $M4COMSTR, $MIDLCOMSTR, $P4COMSTR, $PCHCOMSTR, $PDFLATEXCOMSTR,
4522     $PDFTEXCOMSTR, $PSCOMSTR, $QT_MOCFROMCXXCOMSTR, $QT_MOCFROMHCOMSTR,
4523     $QT_UICCOMSTR, $RCCOMSTR, $REGSVRCOMSTR, $RCS_COCOMSTR, $RMICCOMSTR,
4524     $SCCSCOMSTR, $SHCCCOMSTR, $SHCXXCOMSTR, $SHF77COMSTR, $SHF90COMSTR,
4525     $SHF95COMSTR, $SHFORTRANCOMSTR, $SHLINKCOMSTR, $SWIGCOMSTR,
4526     $TARCOMSTR, $TEXCOMSTR, $YACCCOMSTR and $ZIPCOMSTR.
4528   - Add an optional "map" keyword argument to ListOption() that takes a
4529     dictionary to map user-specified values to legal values from the list
4530     (like EnumOption() already doee).
4532   - Add specific exceptions to try:-except: blocks without any listed,
4533     so that they won't catch and mask keyboard interrupts.
4535   - Make --debug={tree,dtree,stree} print something even when there's
4536     a build failure.
4538   - Fix how Scanners sort the found dependencies so that it doesn't
4539     matter whether the dependency file is in a Repository or not.
4540     This may cause recompilations upon upgrade to this version.
4542   - Make AlwaysBuild() work with Alias and Python value Nodes (making
4543     it much simpler to support aliases like "clean" that just invoke
4544     an arbitrary action).
4546   - Have env.ParseConfig() use AppendUnique() by default to suppress
4547     duplicate entries from multiple calls.  Add a "unique" keyword
4548     argument to allow the old behavior to be specified.
4550   - Allow the library modules imported by an SConscript file to get at
4551     all of the normally-available global functions and variables by saying
4552     "from SCons.Script import *".
4554   - Add a --debug=memoizer option to print Memoizer hit/mass statistics.
4556   - Allow more than one --debug= option to be set at a time.
4558   - Change --debug=count to report object counts before and after
4559     reading SConscript files and before and after building targets.
4561   - Change --debug=memory output to line up the numbers and to better
4562     match (more or less) the headers on the --debug=count columns.
4564   - Speed things up when there are lists of targets and/or sources by
4565     getting rid of some N^2 walks of the lists involved.
4567   - Cache evaluation of LazyActions so we don't create a new object
4568     for each invocation.
4570   - When scanning, don't create Nodes for include files that don't
4571     actually exist on disk.
4573   - Make supported global variables CScanner, DScanner, ProgramScanner and
4574     SourceFileScanner.  Make SourceFileScanner.add_scanner() a supported
4575     part of the public interface.  Keep the old SCons.Defaults.*Scan names
4576     around for a while longer since some people were already using them.
4578   - By default, don't scan directories for on-disk files.  Add a
4579     DirScanner global scanner that can be used in Builders or Command()
4580     calls that want source directory trees scanned for on-disk changes.
4581     Have the Tar() and Zip() Builders use the new DirScanner to preserve
4582     the behavior of rebuilding a .tar or .zip file if any file or
4583     directory under a source tree changes.  Add Command() support for
4584     a source_scanner keyword argument to Command() that can be set to
4585     DirScanner to get this behavior.
4587   - Documentation changes:  Explain that $CXXFLAGS contains $CCFLAGS
4588     by default.  Fix a bad target_factory example in the man page.
4589     Add appendices to the User's Guide to cover the available Tools,
4590     Builders and construction variables.  Comment out the build of
4591     the old Python 10 paper, which doesn't build on all systems and
4592     is old enough at this point that it probably isn't worth the
4593     effort to make it do so.
4595   From Wayne Lee:
4597   - Avoid "maximum recursion limit" errors when removing $(-$) pairs
4598     from long command lines.
4600   From Clive Levinson:
4602   - Make ParseConfig() recognize and add -mno-cygwin to $LINKFLAGS and
4603     $CCFLAGS, and -mwindows to $LINKFLAGS.
4605   From Michael McCracken:
4607   - Add a new "applelink" tool to handle the things like Frameworks and
4608     bundles that Apple has added to gcc for linking.
4610   - Use more appropriate default search lists of linkers, compilers and
4611     and other tools for the 'darwin' platform.
4613   - Add a LoadableModule Builder that builds a bundle on Mac OS X (Darwin)
4614     and a shared library on other systems.
4616   - Improve SWIG tests for use on Mac OS X (Darwin).
4618   From Elliot Murphy:
4620   - Enhance the tests to guarantee persistence of ListOption
4621     values in saved options files.
4623   - Supply the help text when -h is used with the -u, -U or -D options.
4625   From Christian Neeb:
4627   - Fix the Java parser's handling of string definitions to avoid ignoring
4628     subsequent code.
4630   From Han-Wen Nienhuys:
4632   - Optimize variable expansion by:  using the re.sub() method (when
4633     possible); not using "eval" for variables for which we can fetch the
4634     value directory; avoiding slowing substitution logic when there's no
4635     '$' in the string.
4637   From Gary Oberbrunner:
4639   - Add an Environment.Dump() method to print the contents of a
4640     construction environment.
4642   - Allow $LIBS (and similar variables) to contain explicit File Nodes.
4644   - Change ParseConfig to add the found library names directly to the
4645     $LIBS variable, instead of returning them.
4647   - Add ParseConfig() support for the -framework GNU linker option.
4649   - Add a PRINT_CMD_LINE_FUNC construction variable to allow people
4650     to filter (or log) command-line output.
4652   - Print an internal Python stack trace in response to an otherwise
4653     unexplained error when --debug=stacktrace is specified.
4655   - Add a --debug=findlibs option to print what's happening when
4656     the scanner is searching for libraries.
4658   - Allow Tool specifications to be passed a dictionary of keyword
4659     arguments.
4661   - Support an Options default value of None, in which case the variable
4662     will not be added to the construction environment unless it's set
4663     explicitly by the user or from an Options file.
4665   - Avoid copying __builtin__ values into a construction environment's
4666     dictionary when evaluating construction variables.
4668   - Add a new cross-platform intelc.py Tool that can detect and
4669     configure the Intel C++ v8 compiler on both Windows, where it's
4670     named icl, and Linux, where it's named icc.  It also checks that
4671     the directory specified in the Windows registry exists, and sets a
4672     new $INTEL_C_COMPILER_VERSION construction variable to identify the
4673     version being used.  (Niall Douglas contributed an early prototype
4674     of parts of this module.)
4676   - Fix the private Conftest._Have() function so it doesn't change
4677     non-alphanumeric characters to underscores.
4679   - Supply a better error message when a construction variable expansion
4680     has an unknown attribute.
4682   - Documentation changes:  Update the man page to describe use of
4683     filenames or Nodes in $LIBS.
4685   From Chris Pawling:
4687   - Have the linkloc tool use $MSVS_VERSION to select the Microsoft
4688     Visual Studio version to use.
4690   From Kevin Quick:
4692   - Fix the Builder name returned from ListBuilders and other instances
4693     of subclasses of the BuilderBase class.
4695   - Add Builders and construction variables to support rpcgen:
4696     RPCGenClient(), RPCGenHeader(), RPCGenService(), RPCGenXDR(),
4697     $RPCGEN, $RPCGENFLAGS, $RPCGENCLIENTFLAGS, $RPCGENHEADERFLAGS,
4698     $RPCGENSERVICEFLAGS, $RPCGENXDRFLAGS.
4700   - Update the man page to document that prefix and suffix Builder
4701     keyword arguments can be strings, callables or dictionaries.
4703   - Provide more info in the error message when a user tries to build
4704     a target multiple ways.
4706   - Fix Delete() when a file doesn't exist and must_exist=1.  (We were
4707     unintentionally dependent on a bug in versions of the Python shutil.py
4708     module prior to Python 2.3, which would generate an exception for
4709     a nonexistent file even when ignore_errors was set.)
4711   - Only replace a Node's builder with a non-null source builder.
4713   - Fix a stack trace when a suffix selection dictionary is passed
4714     an empty source file list.
4716   - Allow optional names to be attached to Builders, for default
4717     Builders that don't get attached to construction environments.
4719   - Fix problems with Parallel Task Exception handling.
4721   - Build targets in an associated BuildDir even if there are targets
4722     or subdirectories locally in the source directory.
4724   - If a FunctionAction has a callable class as its underlying Python
4725     function, use its strfunction() method (if any) to display the
4726     action.
4728   - Fix handling when BuildDir() exists but is unwriteable.  Add
4729     "Stop." to those error messages for consistency.
4731   - Catch incidents of bad builder creation (without an action) and
4732     supply meaningful error messages.
4734   - Fix handling of src_suffix values that aren't extensions (don't
4735     begin with a '.').
4737   - Don't retrieve files from a CacheDir, but report what would happen,
4738     when the -n option is used.
4740   - Use the source_scanner from the target Node, not the source node
4741     itself.
4743   - Internal Scanners fixes:  Make sure Scanners are only passed Nodes.
4744     Fix how a Scanner.Selector called its base class initialization.
4745     Make comparisons of Scanner objects more robust.  Add a name to
4746     an internal default ObjSourceScanner.
4748   - Add a deprecated warning for use of the old "scanner" keyword argument
4749     to Builder creation.
4751   - Improve the --debug=explain message when the build action changes.
4753   - Test enhancements in SourceCode.py, option-n.py, midl.py.  Better
4754     Command() and Scanner test coverage.  Improved test infrastructure
4755     for -c output.
4757   - Refactor the interface between Action and Executor objects to treat
4758     Actions atomically.
4760   - The --debug=presub option will now report the pre-substitution
4761     each action seprately, instead of reporting the entire list before
4762     executing the actions one by one.
4764   - The --debug=explain option explaining a changed action will now
4765     (more correctly) show pre-substitution action strings, instead of
4766     the commands with substituted file names.
4768   - A Node (file) will now be rebuilt if its PreAction or PostAction
4769     actions change.
4771   - Python Function actions now have their calling signature (target,
4772     source, env) reported correctly when displayed.
4774   - Fix BuildDir()/build_dir handling when the build_dir is underneath
4775     the source directory and trying to use entries from the build_dir
4776     as sources for other targets in the build-dir.
4778   - Fix hard-coding of JDK path names in various Java tests.
4780   - Handle Python stack traces consistently (stop at the SConscript stack
4781     frame, by default) even if the Python source code isn't available.
4783   - Improve the performance of the --debug={tree,dtree} options.
4785   - Add --debug=objects logging of creation of OverrideWarner,
4786     EnvironmentCopy and EnvironmentOverride objects.
4788   - Fix command-line expansion of Python Value Nodes.
4790   - Internal cleanups:  Remove an unnecessary scan argument.  Associate
4791     Scanners only with Builders, not nodes.  Apply overrides once when
4792     a Builder is called, not in multiple places.  Cache results from the
4793     Node.FS.get_suffix() and Node.get_build_env() methods.  Use the Python
4794     md5 modules' hexdigest() method, if there is one.  Have Taskmaster
4795     call get_stat() once for each Node and re-use the value instead of
4796     calling it each time it needs the value.  Have Node.depends_on()
4797     re-use the list from the children() method instead of calling it
4798     multiple times.
4800   - Use the correct scanner if the same source file is used for targets in
4801     two different environments with the same path but different scanners.
4803   - Collect logic for caching values in memory in a Memoizer class,
4804     which cleans up a lot of special-case code in various methods and
4805     caches additional values to speed up most configurations.
4807   - Add a PathAccept validator to the list of new canned PathOption
4808     validators.
4810   From Jeff Squyres:
4812   - Documentation changes:  Use $CPPDEFINES instead of $CCFLAGS in man
4813     page examples.
4815   From Levi Stephen:
4817   - Allow $JARCHDIR to be expanded to other construction variables.
4819   From Christoph Wiedemann:
4821   - Add an Environment.SetDefault() method that only sets values if
4822     they aren't already set.
4824   - Have the qt.py Tool not override variables already set by the user.
4826   - Add separate $QT_BINPATH, $QT_CPPPATH and $QT_LIBPATH variables
4827     so these can be set individually, instead of being hard-wired
4828     relative to $QTDIR.
4830   - The %TEMP% and %TMP% external environment variables are now propagated
4831     automatically to the command execution environment on Windows systems.
4833   - A new --config= command-line option allows explicit control of
4834     of when the Configure() tests are run:  --config=force forces all
4835     checks to be run, --config=cache uses all previously cached values,
4836     --config=auto (the default) runs tests only when dependency analysis
4837     determines it's necessary.
4839   - The Configure() subsystem can now write a config.h file with values
4840     like HAVE_STDIO_H, HAVE_LIBM, etc.
4842   - The Configure() subsystem now executes its checks silently when the
4843     -Q option is specified.
4845   - The Configure() subsystem now reports if a test result is being
4846     taken from cache, and prints the standard output and error output
4847     of tests even when cached.
4849   - Configure() test results are now reported as "yes" or "no" instead of
4850     "ok" or "failed."
4852   - Fixed traceback printing when calling the env.Configure() method
4853     instead of the Configure() global function.
4855   - The Configure() subsystem now caches build failures in a .sconsign
4856     file in the subdirectory, not a .cache file.  This may cause
4857     tests to be re-executed the first time after you install 0.97.
4859   - Additional significant internal cleanups in the Configure() subsystem
4860     and its tests.
4862   - Have the Qt Builder make uic-generated files dependent on the .ui.h
4863     file, if one exists.
4865   - Add a test to make sure that SCons source code does not contain
4866     try:-except: blocks that catch all errors, which potentially catch
4867     and mask keyboard interrupts.
4869   - Fix us of TargetSignatures('content') with the SConf subsystem.
4871   From Russell Yanofsky:
4873   - Add support for the Metrowerks Codewarrior compiler and linker
4874     (mwcc and mwld).
4878 RELEASE 0.96.1 - Mon, 23 Aug 2004 12:55:50 +0000
4880   From Craig Bachelor:
4882   - Handle white space in the executable Python path name within in MSVS
4883     project files by quoting the path.
4885   - Correct the format of a GUID string in a solution (.dsw) file so
4886     MSVS can correctly "build enable" a project.
4888   From Steven Knight:
4890   - Add a must_exist flag to Delete() to let the user control whether
4891     it's an error if the specified entry doesn't exist.  The default
4892     behavior is now to silently do nothing if it doesn't exist.
4894   - Package up the new Platform/darwin.py, mistakenly left out of 0.96.
4896   - Make the scons.bat REM statements into @REM so they aren't printed.
4898   - Make the SCons packaging SConscript files platform independent.
4900   From Anthony Roach:
4902   - Fix scanning of pre-compiled header (.pch) files for #includes,
4903     broken in 0.96.
4907 RELEASE 0.96 - Wed, 18 Aug 2004 13:36:40 +0000
4909   From Chad Austin:
4911   - Make the CacheDir() directory if it doesn't already exist.
4913   - Allow construction variable substitutions in $LIBS specifications.
4915   - Allow the emitter argument to a Builder() to be or expand to a list
4916     of emitter functions, which will be called in sequence.
4918   - Suppress null values in construction variables like $LIBS that use
4919     the internal _concat() function.
4921   - Remove .dll files from the construction variables searched for
4922     libraries that can be fed to Win32 compilers.
4924   From Chad Austin and Christoph Wiedemann:
4926   - Add support for a $RPATH variable to supply a list of directories
4927     to search for shared libraries when linking a program.  Used by
4928     the GNU and IRIX linkers (gnulink and sgilink).
4930   From Charles Crain:
4932   - Restore the ability to do construction variable substitutions in all
4933     kinds of *PATH variables, even when the substitution returns a Node
4934     or other object.
4936   From Tom Epperly:
4938   - Allow the Java() Builder to take more than one source directory.
4940   From Ralf W. Grosse-Kunstleve:
4942   - Have SConsignFile() use, by default, a custom "dblite.py" that we can
4943     control and guarantee to work on all Python versions (or nearly so).
4945   From Jonathan Gurley:
4947   - Add support for the newer "ifort" versions of the Intel Fortran
4948     Compiler for Linux.
4950   From Bob Halley:
4952   - Make the new *FLAGS variable type work with copied Environments.
4954   From Chris Hoeppler:
4956   - Initialize the name of a Scanner.Classic scanner correctly.
4958   From James Juhasz:
4960   - Add support for the .dylib shared library suffix and the -dynamiclib
4961     linker option on Mac OS X.
4963   From Steven Knight:
4965   - Add an Execute() method for executing actions directly.
4967   - Support passing environment override keyword arguments to Command().
4969   - Fix use of $MSVS_IGNORE_IDE_PATHS, which was broken when we added
4970     support for $MSVS_USE_MFC_DIRS last release.
4972   - Make env.Append() and env.Prepend() act like the underlying Python
4973     behavior when the variable being appended to is a UserList object.
4975   - Fix a regression that prevented the Command() global function in
4976     0.95 from working with command-line strings as actions.
4978   - Fix checking out a file from a source code management system when
4979     the env.SourceCode() method was called with an individual file name
4980     or node, not a directory name or node.
4982   - Enhance the Task.make_ready() method to create a list of the
4983     out-of-date Nodes for the task for use by the wrapping interface.
4985   - Allow Scanners to pull the list of suffixes from the construction
4986     environment when the "skeys" keyword argument is a string containing
4987     a construction variable to be expanded.
4989   - Support new $CPPSUFFIXES, $DSUFFIXES $FORTRANSUFFIXES, and
4990     $IDLSUFFIXES.  construction variables that contain the default list
4991     of suffixes to be scanned by a given type of scanner, allowing these
4992     suffix lists to be easily added to or overridden.
4994   - Speed up Node creation when calling a Builder by comparing whether two
4995     Environments are the same object, not if their underlying dictionaries
4996     are equivalent.
4998   - Add a --debug=explain option that reports the reason(s) why SCons
4999     thinks it must rebuild something.
5001   - Add support for functions that return platform-independent Actions
5002     to Chmod(), Copy(), Delete(), Mkdir(), Move() and Touch() files
5003     and/or directories.  Like any other Actions, the returned Action
5004     object may be executed directly using the Execute() global function
5005     or env.Execute() environment method, or may be used as a Builder
5006     action or in an env.Command() action list.
5008   - Add support for the strfunction argument to all types of Actions:
5009     CommandAction, ListAction, and CommandGeneratorAction.
5011   - Speed up turning file system Nodes into strings by caching the
5012     values after we're finished reading the SConscript files.
5014   - Have ParseConfig() recognize and supporting adding the -Wa, -Wl,
5015     and -Wp, flags to ASFLAGS, LINKFLAGS and CPPFLAGS, respectively.
5017   - Change the .sconsign format and the checks for whether a Node is
5018     up-to-date to make dependency checks more efficient and correct.
5020   - Add wrapper Actions to SCons.Defaults for $ASCOM, $ASPPCOM, $LINKCOM,
5021     $SHLINKCOM, $ARCOM, $LEXCOM and $YACCCOM.  This makes it possible
5022     to replace the default print behavior with a custom strfunction()
5023     for each of these.
5025   - When a Node has been built, don't walk the whole tree back to delete
5026     the parents's implicit dependencies, let returning up the normal
5027     Taskmaster descent take care of it for us.
5029   - Add documented support for separate target_scanner and source_scanner
5030     arguments to Builder creation, which allows different scanners to
5031     be applied to source files
5033   - Don't re-install or (re-generate) .h files when a subsidiary #included
5034     .h file changes.  This eliminates incorrect circular dependencies
5035     with .h files generated from other source files.
5037   - Slim down the internal Sig.Calculator class by eliminating methods
5038     whose functionality is now covered by Node methods.
5040   - Document use of the target_factory and source_factory keyword
5041     arguments when creating Builder objects.  Enhance Dir Nodes so that
5042     they can be created with user-specified Builder objects.
5044   - Don't blow up with stack trace when the external $PATH environment
5045     variable isn't set.
5047   - Make Builder calls return lists all the time, even if there's only
5048     one target.  This keeps things consistent and easier to program to
5049     across platforms.
5051   - Add a Flatten() function to make it easier to deal with the Builders
5052     all returning lists of targets, not individual targets.
5054   - Performance optimizations in Node.FS.__doLookup().
5056   - Man page fixes:  formatting typos, misspellings, bad example.
5058   - User's Guide fixes: Fix the signatures of the various example
5059     *Options() calls.  Triple-quote properly a multi-line Split example.
5061   - User's Guide additions:  Chapter describing File and Directory
5062     Nodes.  Section describing declarative nature of SCons functions in
5063     SConscript files.  Better organization and clarification of points
5064     raised by Robert P. J. Day.  Chapter describing SConf (Autoconf-like)
5065     functionality.  Chapter describing how to install Python and
5066     SCons.  Chapter describing Java builds.
5068   From Chris Murray:
5070   - Add a .win32 attribute to force file names to expand with
5071     Windows backslash path separators.
5073   - Fix escaping file names on command lines when the expansion is
5074     concatenated with another string.
5076   - Add support for Fortran 90 and Fortran 95.  This adds $FORTRAN*
5077     variables that specify a default compiler, command-line, flags,
5078     etc. for all Fortran versions, plus separate $F90* and $F95*
5079     variables for when different compilers/flags/etc. must be specified
5080     for different Fortran versions.
5082   - Have individual tools that create libraries override the default
5083     $LIBPREFIX and $LIBSUFFIX values set by the platform.  This makes
5084     it easier to use Microsoft Visual Studio tools on a CygWin platform.
5086   From Gary Oberbrunner:
5088   - Add a --debug=presub option to print actions prior to substitution.
5090   - Add a warning upon use of the override keywords "targets" and
5091     "sources" when calling Builders.  These are usually mistakes which
5092     are otherwise silently (and confusingly) turned into construction
5093     variable overrides.
5095   - Try to find the ICL license file path name in the external environment
5096     and the registry before resorting to the hard-coded path name.
5098   - Add support for fetching command-line keyword=value arguments in
5099     order from an ARGLIST list.
5101   - Avoid stack traces when trying to read dangling symlinks.
5103   - Treat file "extensions" that only contain digits as part of the
5104     file basename.  This supports version numbers as part of shared
5105     library names, for example.
5107   - Avoid problems when there are null entries (None or '') in tool
5108     lists or CPPPATH.
5110   - Add an example and explanation of how to use "tools = ['default', ..."
5111     when creating a construction environment.
5113   - Add a section describing File and Directory Nodes and some of their
5114     attributes and methods.
5116   - Have ParseConfig() add a returned -pthread flag to both $CCFLAGS
5117     and $LINKFLAGS.
5119   - Fix some test portability issues on Mac OS X (darwin).
5121   From Simon Perkins:
5123   - Fix a bug introduced in building shared libraries under MinGW.
5125   From Kevin Quick:
5127   - Handling SCons exceptions according to Pythonic standards.
5129   - Fix test/chained-build.py on systems that execute within one second.
5131   - Fix tests on systems where 'ar' warns about archive creation.
5133   From Anthony Roach:
5135   - Fix use of the --implicit-cache option with timestamp signatures.
5137   - If Visual Studio is installed, assume the C/C++ compiler, the linker
5138     and the MIDL compiler that comes with it are available, too.
5140   - Better error messages when evaluating a construction variable
5141     expansion yields a Python syntax error.
5143   - Change the generation of PDB files when using Visual Studio from
5144     compile time to link time.
5146   From sam th:
5148   - Allow SConf.CheckLib() to search a list of libraries, like the
5149     Autoconf AC_SEARCH_LIBS macro.
5151   - Allow the env.WhereIs() method to take a "reject" argument to
5152     let it weed out specific path names.
5154   From Christoph Wiedemann:
5156   - Add new Moc() and Uic() Builders for more explicit control over
5157     Qt builds, plus new construction variables to control them:
5158     $QT_AUTOSCAN, $QT_DEBUG, $QT_MOCCXXPREFIX, $QT_MOCCXXSUFFIX,
5159     $QT_MOCHPREFIX, $QT_MOCHSUFFIX, $QT_UICDECLPREFIX, $QT_UICDECLSUFFIX,
5160     $QT_UICIMPLPREFIX, $QT_UICIMPLSUFFIX and $QT_UISUFFIX.
5162   - Add a new single_source keyword argument for Builders that enforces
5163     a single source file on calls to the Builder.
5167 RELEASE 0.95 - Mon, 08 Mar 2004 06:43:20 -0600
5169   From Chad Austin:
5171   - Replace print statements with calls to sys.stdout.write() so output
5172     lines stay together when -j is used.
5174   - Add portability fixes for a number of tests.
5176   - Accomodate the fact that Cygwin's os.path.normcase() lies about
5177     the underlying system being case-sensitive.
5179   - Fix an incorrect _concat() call in the $RCINCFLAGS definition for
5180     the mingw Tool.
5182   - Fix a problem with the msvc tool with Python versions prior to 2.3.
5184   - Add support for a "toolpath" Tool() and Environment keyword that
5185     allows Tool modules to be found in specified local directories.
5187   - Work around Cygwin Python's silly fiction that it's using a
5188     case-sensitive file system.
5190   - More robust handling of data in VCComponents.dat.
5192   - If the "env" command is available, spawn commands with the more
5193     general "env -" instead of "env -i".
5195   From Kerim Borchaev:
5197   - Fix a typo in a msvc.py's registry lookup:  "VCComponents.dat", not
5198     "VSComponents.dat".
5200   From Chris Burghart:
5202   - Fix the ability to save/restore a PackageOption to a file.
5204   From Steve Christensen:
5206   - Update the MSVS .NET and MSVC 6.0/7.0 path detection.
5208   From David M. Cooke:
5210   - Make the Fortran scanner case-insensitive for the INCLUDE string.
5212   From Charles Crain:
5214   - If no version of MSVC is detected but the tool is specified,
5215     use the MSVC 6.0 paths by default.
5217   - Ignore any "6.1" version of MSVC found in the registry; this is a
5218     phony version number (created by later service packs?) and would
5219     throw off the logic if the user had any non-default paths configure.
5221   - Correctly detect if the user has independently configured the MSVC
5222     "include," "lib" or "path" in the registry and use the appropriate
5223     values.  Previously, SCons would only use the values if all three
5224     were set in the registry.
5226   - Make sure side-effect nodes are prepare()d before building their
5227     corresponding target.
5229   - Preserve the ability to call BuildDir() multiple times with the
5230     same target and source directory arguments.
5232   From Andy Friesen:
5234   - Add support for the Digital Mars "D" programming language.
5236   From Scott Lystig Fritchie:
5238   - Fix the ability to use a custom _concat() function in the
5239     construction environment when calling _stripixes().
5241   - Make the message about ignoring a missing SConscript file into a
5242     suppressable Warning, not a hard-coded sys.stderr.write().
5244   - If a builder can be called multiple times for a target (because
5245     the sources and overrides are identical, or it's a builder with the
5246     "multi" flag set), allow the builder to be called through multiple
5247     environments so long as the builders have the same signature for
5248     the environments in questions (that is, they're the same action).
5250   From Bob Halley:
5252   - When multiple targets are built by a single action, retrieve all
5253     of them from cache, not just the first target, and exec the build
5254     command if any of the targets isn't present in the cache.
5256   From Zephaniah Hull:
5258   - Fix command-line ARGUMENTS with multiple = in them.
5260   From Steven Knight:
5262   - Fix EnsureSConsVersion() so it checks against the SCons version,
5263     not the Python version, on Pythons with sys.version_info.
5265   - Don't swallow the AttributeError when someone uses an expansion like
5266     $TARGET.bak, so we can supply a more informative error message.
5268   - Fix an odd double-quote escape sequence in the man page.
5270   - Fix looking up a naked drive letter as a directory (Dir('C:')).
5272   - Support using File nodes in the LIBS construction variable.
5274   - Allow the LIBS construction variable to be a single string or File
5275     node, not a list, when only one library is needed.
5277   - Fix typos in the man page:  JAVACHDIR => JARCHDIR; add "for_signature"
5278     to the __call__() example in the "Variable Substitution" section.
5280   - Correct error message spellings of "non-existant" to "non-existent."
5282   - When scanning for libraries to link with, don't append $LIBPREFIXES
5283     or $LIBSUFFIXES values to the $LIBS values if they're already present.
5285   - Add a ZIPCOMPRESSION construction variable to control whether the
5286     internal Python action for the Zip Builder compresses the file or
5287     not.  The default value is zipfile.ZIP_DEFLATED, which generates
5288     a compressed file.
5290   - Refactor construction variable expansion to support recursive
5291     expansion of variables (e.g. CCFLAGS = "$CCFLAGS -g") without going
5292     into an infinite loop.  Support this in all construction variable
5293     overrides, as well as when copying Environments.
5295   - Fix calling Configure() from more than one subsidiary SConscript file.
5297   - Fix the env.Action() method so it returns the correct type of
5298     Action for its argument(s).
5300   - Fix specifying .class files as input to JavaH with the .class suffix
5301     when they weren't generated using the Java Builder.
5303   - Make the check for whether all of the objects going into a
5304     SharedLibrary() are shared work even if the object was built in a
5305     previous run.
5307   - Supply meaningful error messages, not stack traces, if we try to add
5308     a non-Node as a source, dependency, or ignored dependency of a Node.
5310   - Generate MSVS Project files that re-invoke SCons properly regardless
5311     of whether the file was built via scons.bat or scons.py.
5312     (Thanks to Niall Douglas for contributing code and testing.)
5314   - Fix TestCmd.py, runtest.py and specific tests to accomodate being
5315     run from directories whose paths include white space.
5317   - Provide a more useful error message if a construction variable
5318     expansion contains a syntax error during evaluation.
5320   - Fix transparent checkout of implicit dependency files from SCCS
5321     and RCS.
5323   - Added new --debug=count, --debug=memory and --debug=objects options.
5324     --debug=count and --debug=objects only print anything when run
5325     under Python 2.1 or later.
5327   - Deprecate the "overrides" keyword argument to Builder() creation
5328     in favor of using keyword argument values directly (like we do
5329     for builder execution and the like).
5331   - Always use the Builder overrides in substitutions, not just if
5332     there isn't a target-specific environment.
5334   - Add new "rsrcpath" and "rsrcdir" and attributes to $TARGET/$SOURCE,
5335     so Builder command lines can find things in Repository source
5336     directories when using BuildDir.
5338   - Fix the M4 Builder so that it chdirs to the Repository directory
5339     when the input file is in the source directory of a BuildDir.
5341   - Save memory at build time by allowing Nodes to delete their build
5342     environments after they've been built.
5344   - Add AppendUnique() and PrependUnique() Environment methods, which
5345     add values to construction variables like Append() and Prepend()
5346     do, but suppress any duplicate elements in the list.
5348   - Allow the 'qt' tool to still be used successfully from a copied
5349     Environment.  The include and library directories previously ended up
5350     having the same string re-appended to the end, yielding an incorrect
5351     path name.
5353   - Supply a more descriptive error message when the source for a target
5354     can't be found.
5356   - Initialize all *FLAGS variables with objects do the right thing with
5357     appending flags as strings or lists.
5359   - Make things like ${TARGET.dir} work in *PATH construction variables.
5361   - Allow a $MSVS_USE_MFC_DIRS construction variable to control whether
5362     ATL and MFC directories are included in the default INCLUDE and
5363     LIB paths.
5365   - Document the dbm_module argument to the SConsignFile() function.
5367   From Vincent Risi:
5369   - Add support for the bcc32, ilink32 and tlib Borland tools.
5371   From Anthony Roach:
5373   - Supply an error message if the user tries to configure a BuildDir
5374     for a directory that already has one.
5376   - Remove documentation of the still-unimplemented -e option.
5378   - Add -H help text listing the legal --debug values.
5380   - Don't choke if a construction variable is a non-string value.
5382   - Build Type Libraries in the target directory, not the source
5383     directory.
5385   - Add an appendix to the User's Guide showing how to accomplish
5386     various common tasks in Python.
5388   From Greg Spencer:
5390   - Add support for Microsoft Visual Studio 2003 (version 7.1).
5392   - Evaluate $MSVSPROJECTSUFFIX and $MSVSSOLUTIONSUFFIX when the Builder
5393     is invoked, not when the tool is initialized.
5395   From Christoph Wiedemann:
5397   - When compiling Qt, make sure the moc_*.cc files are compiled using
5398     the flags from the environment used to specify the target, not
5399     the environment that first has the Qt Builders attached.
5403 RELEASE 0.94 - Fri, 07 Nov 2003 05:29:48 -0600
5405   From Hartmut Goebel:
5407   - Add several new types of canned functions to help create options:
5408     BoolOption(), EnumOption(), ListOption(), PackageOption(),
5409     PathOption().
5411   From Steven Knight:
5413   - Fix use of CPPDEFINES with C++ source files.
5415   - Fix env.Append() when the operand is an object with a __cmp__()
5416     method (like a Scanner instance).
5418   - Fix subclassing the Environment and Scanner classes.
5420   - Add BUILD_TARGETS, COMMAND_LINE_TARGETS and DEFAULT_TARGETS variables.
5422   From Steve Leblanc:
5424   - SGI fixes:  Fix C++ compilation, add a separate Tool/sgic++.py module.
5426   From Gary Oberbrunner:
5428   - Fix how the man page un-indents after examples in some browsers.
5430   From Vincent Risi:
5432   - Fix the C and C++ tool specifications for AIX.
5436 RELEASE 0.93 - Thu, 23 Oct 2003 07:26:55 -0500
5438   From J.T. Conklin:
5440   - On POSIX, execute commands with the more modern os.spawnvpe()
5441     function, if it's available.
5443   - Scan .S, .spp and .SPP files for C preprocessor dependencies.
5445   - Refactor the Job.Parallel() class to use a thread pool without a
5446     condition variable.  This improves parallel build performance and
5447     handles keyboard interrupts properly when -j is used.
5449   From Charles Crain:
5451   - Add support for a JARCHDIR variable to control changing to a
5452     directory using the jar -C option.
5454   - Add support for detecting Java manifest files when using jar,
5455     and specifying them using the jar m flag.
5457   - Fix some Python 2.2 specific things in various tool modules.
5459   - Support directories as build sources, so that a rebuild of a target
5460     can be triggered if anything underneath the directory changes.
5462   - Have the scons.bat and scons.py files look for the SCons modules
5463     in site-packages as well.
5465   From Christian Engel:
5467   - Support more flexible inclusion of separate C and C++ compilers.
5469   - Use package management tools on AIX and Solaris to find where
5470     the comilers are installed, and what version they are.
5472   - Add support for CCVERSION and CXXVERSION variables for a number
5473     of C and C++ compilers.
5475   From Sergey Fogel:
5477   - Add test cases for the new capabilities to run bibtex and to rerun
5478     latex as needed.
5480   From Ralf W. Grosse-Kunstleve:
5482   - Accomodate anydbm modules that don't have a sync() method.
5484   - Allow SConsignFile() to take an argument specifying the DBM
5485     module to be used.
5487   From Stephen Kennedy:
5489   - Add support for a configurable global .sconsign.dbm file which
5490     can be used to avoid cluttering each directory with an individual
5491     .sconsign file.
5493   From John Johnson:
5495   - Fix (re-)scanning of dependencies in generated or installed
5496     header files.
5498   From Steven Knight:
5500   - The -Q option suppressed too many messages; fix it so that it only
5501     suppresses the Reading/Building messages.
5503   - Support #include when there's no space before the opening quote
5504     or angle bracket.
5506   - Accomodate alphanumeric version strings in EnsurePythonVersion().
5508   - Support arbitrary expansion of construction variables within
5509     file and directory arguments to Builder calls and Environment methods.
5511   - Add Environment-method versions of the following global functions:
5512     Action(), AddPostAction(), AddPreAction(), Alias(), Builder(),
5513     BuildDir(), CacheDir(), Clean(), Configure(), Default(),
5514     EnsurePythonVersion(), EnsureSConsVersion(), Environment(),
5515     Exit(), Export(), FindFile(), GetBuildPath(), GetOption(), Help(),
5516     Import(), Literal(), Local(), Platform(), Repository(), Scanner(),
5517     SConscriptChdir(), SConsignFile(), SetOption(), SourceSignatures(),
5518     Split(), TargetSignatures(), Tool(), Value().
5520   - Add the following global functions that correspond to the same-named
5521     Environment methods:  AlwaysBuild(), Command(), Depends(), Ignore(),
5522     Install(), InstallAs(), Precious(), SideEffect() and SourceCode().
5524   - Add the following global functions that correspond to the default
5525     Builder methods supported by SCons: CFile(), CXXFile(), DVI(), Jar(),
5526     Java(), JavaH(), Library(), M4(), MSVSProject(), Object(), PCH(),
5527     PDF(), PostScript(), Program(), RES(), RMIC(), SharedLibrary(),
5528     SharedObject(), StaticLibrary(), StaticObject(), Tar(), TypeLibrary()
5529     and Zip().
5531   - Rearrange the man page to show construction environment methods and
5532     global functions in the same list, and to explain the difference.
5534   - Alphabetize the explanations of the builder methods in the man page.
5536   - Rename the Environment.Environment class to Enviroment.Base.
5537     Allow the wrapping interface to extend an Environment by using its own
5538     subclass of Environment.Base and setting a new Environment.Environment
5539     variable as the calling entry point.
5541   - Deprecate the ParseConfig() global function in favor of a same-named
5542     construction environment method.
5544   - Allow the Environment.WhereIs() method to take explicit path and
5545     pathext arguments (like the underlying SCons.Util.WhereIs() function).
5547   - Remove the long-obsolete {Get,Set}CommandHandler() functions.
5549   - Enhance env.Append() to suppress null values when appropriate.
5551   - Fix ParseConfig() so it works regardless of initial construction
5552     variable values.
5554     Extend CheckHeader(), CheckCHeader(), CheckCXXHeader() and
5555     CheckLibWithHeader() to accept a list of header files that will be
5556     #included in the test.  The last one in the list is assumed to be
5557     the one being checked for.  (Prototype code contributed by Gerard
5558     Patel and Niall Douglas).
5560   - Supply a warning when -j is used and threading isn't built in to
5561     the current version of Python.
5563   - First release of the User's Guide (finally, and despite a lot
5564     of things still missing from it...).
5566   From Clark McGrew:
5568   - Generalize the action for .tex files so that it will decide whether
5569     a file is TeX or LaTeX, check the .aux output to decide if it should
5570     run bibtex, and check the .log output to re-run LaTeX if needed.
5572   From Bram Moolenaar:
5574   - Split the non-SCons-specific functionality from SConf.py to a new,
5575     re-usable Conftest.py module.
5577   From Gary Oberbrunner:
5579   - Allow a directory to be the target or source or dependency of a
5580     Depends(), Ignore(), Precious() or SideEffect() call.
5582   From Gerard Patel:
5584   - Use the %{_mandir} macro when building our RPM package.
5586   From Marko Rauhamaa:
5588   - Have the closing message say "...terminated because of errors" if
5589     there were any.
5591   From Anthony Roach:
5593   - On Win32 systems, only use "rm" to delete files if Cygwin is being
5594     used.   ("rm" doesn't understand Win32-format path names.)
5596   From Christoph Wiedemann:
5598   - Fix test/SWIG.py to find the Python include directory in all cases.
5600   - Fix a bug in detection of Qt installed on the local system.
5602   - Support returning Python 2.3 BooleanType values from Configure checks.
5604   - Provide an error message if someone mistakenly tries to call a
5605     Configure check from within a Builder function.
5607   - Support calling a Builder when a Configure context is still open.
5609   - Handle interrupts better by eliminating all try:-except: blocks
5610     which caught any and all exceptions, including KeyboardInterrupt.
5612   - Add a --duplicate= option to control how files are duplicated.
5616 RELEASE 0.92 - Wed, 20 Aug 2003 03:45:28 -0500
5618   From Charles Crain and Gary Oberbrunner:
5620   - Fix Tool import problems with the Intel and PharLap linkers.
5622   From Steven Knight
5624   - Refactor the DictCmdGenerator class to be a Selector subclass.
5626   - Allow the DefaultEnvironment() function to take arguments and pass
5627     them to instantiation of the default construction environment.
5629   - Update the Debian package so it uses Python 2.2 and more closely
5630     resembles the currently official Debian packaging info.
5632   From Gerard Patel
5634   - When the yacc -d flag is used, take the .h file base name from the
5635     target .c file, not the source (matching what yacc does).
5639 RELEASE 0.91 - Thu, 14 Aug 2003 13:00:44 -0500
5641   From Chad Austin:
5643   - Support specifying a list of tools when calling Environment.Copy().
5645   - Give a Value Nodes a timestamp of the system time when they're
5646     created, so they'll work when using timestamp-based signatures.
5648   - Add a DefaultEnvironment() function that only creates a default
5649     environment on-demand (for fetching source files, e.g.).
5651   - Portability fix for test/M4.py.
5653   From Steven Knight:
5655   - Tighten up the scons -H help output.
5657   - When the input yacc file ends in .yy and the -d flag is specified,
5658     recognize that a .hpp file (not a .h file) will be created.
5660   - Make builder prefixes work correctly when deducing a target
5661     from a source file name in another directory.
5663   - Documentation fixes: typo in the man page; explain up-front about
5664     not propagating the external environment.
5666   - Use "cvs co -d" instead of "cvs co -p >" when checking out something
5667     from CVS with a specified module name.  This avoids zero-length
5668     files when there is a checkout error.
5670   - Add an "sconsign" script to print the contents of .sconsign files.
5672   - Speed up maintaining the various lists of Node children by using
5673     dictionaries to avoid "x in list" searches.
5675   - Cache the computed list of Node children minus those being Ignored
5676     so it's only calculated once.
5678   - Fix use of the --cache-show option when building a Program()
5679     (or using any other arbitrary action) by making sure all Action
5680     instances have strfunction() methods.
5682   - Allow the source of Command() to be a directory.
5684   - Better error handling of things like raw TypeErrors in SConscripts.
5686   - When installing using "setup.py install --prefix=", suppress the
5687     distutils warning message about adding the (incorrect) library
5688     directory to your search path.
5690   - Correct the spelling of the "validater" option to "validator."
5691     Add a DeprecatedWarning when the old spelling is used.
5693   - Allow a Builder's emitter to be a dictionary that maps source file
5694     suffixes to emitter functions, using the suffix of the first file
5695     in the source list to pick the right one.
5697   - Refactor the creation of the Program, *Object and *Library Builders
5698     so that they're moved out of SCons.Defaults and created on demand.
5700   - Don't split SConscript file names on white space.
5702   - Document the SConscript function's "dirs" and "name" keywords.
5704   - Remove the internal (and superfluous) SCons.Util.argmunge() function.
5706   - Add /TP to the default CXXFLAGS for msvc, so it can compile all
5707     of the suffixes we use as C++ files.
5709   - Allow the "prefix" and "suffix" attributes of a Builder to be
5710     callable objects that return generated strings, or dictionaries
5711     that map a source file suffix to the right prefix/suffix.
5713   - Support a MAXLINELINELENGTH construction variable on Win32 systems
5714     to control when a temporary file is used for long command lines.
5716   - Make how we build .rpm packages not depend on the installation
5717     locations from the distutils being used.
5719   - When deducing a target Node, create it directly from the first
5720     source Node, not by trying to create the right string to pass to
5721     arg2nodes().
5723   - Add support for SWIG.
5725   From Bram Moolenaar:
5727   - Test portability fixes for FreeBSD.
5729   From Gary Oberbrunner:
5731   - Report the target being built in error messages when building
5732     multiple sources from different extensions, or when the target file
5733     extension can't be deduced, or when we don't have an action for a
5734     file suffix.
5736   - Provide helpful error messages when the arguments to env.Install()
5737     are incorrect.
5739   - Fix the value returned by the Node.prevsiginfo() method to conform
5740     to a previous change when checking whether a node is current.
5742   - Supply a stack trace if the Taskmaster catches an exception.
5744   - When using a temporary file for a long link line on Win32 systems,
5745     (also) print the command line that is being executed through the
5746     temporary file.
5748   - Initialize the LIB environment variable when using the Intel
5749     compiler (icl).
5751   - Documentation fixes:  better explain the AlwaysBuild() function.
5753   From Laurent Pelecq:
5755   - When the -debug=pdb option is specified, use pdb.Pdb().runcall() to
5756     call pdb directly, don't call Python recursively.
5758   From Ben Scott:
5760   - Add support for a platform-independent CPPDEFINES variable.
5762   From Christoph Wiedemann:
5764   - Have the g++ Tool actually use g++ in preference to c++.
5766   - Have the gcc Tool actually use gcc in preference to cc.
5768   - Add a gnutools.py test of the GNU tool chain.
5770   - Be smarter about linking: use $CC by default and $CXX only if we're
5771     linking with any C++ objects.
5773   - Avoid SCons hanging when a piped command has a lot of output to read.
5775   - Add QT support for preprocessing .ui files into .c files.
5779 RELEASE 0.90 - Wed, 25 Jun 2003 14:24:52 -0500
5781   From Chad Austin:
5783   - Fix the _concat() documentation, and add a test for it.
5785   - Portability fixes for non-GNU versions of lex and yacc.
5787   From Matt Balvin:
5789   - Fix handling of library prefixes when the subdirectory matches
5790     the prefix.
5792   From Timothee Bessett:
5794   - Add an M4 Builder.
5796   From Charles Crain:
5798   - Use '.lnk' as the suffix on the temporary file for linking long
5799     command lines (necessary for the Phar Lap linkloc linker).
5801   - Save non-string Options values as their actual type.
5803   - Save Options string values that contain a single quote correctly.
5805   - Save any Options values that are changed from the default
5806     Environment values, not just ones changed on the command line or in
5807     an Options file.
5809   - Make closing the Options file descriptor exception-safe.
5811   From Steven Knight:
5813   - SCons now enforces (with an error) that construction variables
5814     must have the same form as valid Python identifiers.
5816   - Fix man page bugs: remove duplicate AddPostAction() description;
5817     document no_import_lib; mention that CPPFLAGS does not contain
5818     $_CPPINCFLAGS; mention that F77FLAGS does not contain $_F77INCFLAGS;
5819     mention that LINKFLAGS and SHLINKFLAGS contains neither $_LIBFLAGS
5820     nor $_LIBDIRFLAGS.
5822   - Eliminate a dependency on the distutils.fancy_getopt module by
5823     copying and pasting its wrap_text() function directly.
5825   - Make the Script.Options() subclass match the underlying base class
5826     implementation.
5828   - When reporting a target is up to date, quote the target like make
5829     (backquote-quote) instead of with double quotes.
5831   - Fix handling of ../* targets when using -U, -D or -u.
5833   From Steve Leblanc:
5835   - Don't update the .sconsign files when run with -n.
5837   From Gary Oberbrunner:
5839   - Add support for the Intel C Compiler (icl.exe).
5841   From Anthony Roach
5843   - Fix Import('*').
5845   From David Snopek
5847   - Fix use of SConf in paths with white space in them.
5849   - Add CheckFunc and CheckType functionality to SConf.
5851   - Fix use of SConf with Builders that return a list of nodes.
5853   From David Snopek and Christoph Wiedemann
5855   - Fix use of the SConf subsystem with SConscriptChdir().
5857   From Greg Spencer
5859   - Check for the existence of MS Visual Studio on disk before using it,
5860     to avoid getting fooled by leftover junk in the registry.
5862   - Add support for MSVC++ .NET.
5864   - Add support for MS Visual Studio project files (DSP, DSW,
5865     SLN and VCPROJ files).
5867   From Christoph Wiedemann
5869   - SConf now works correctly when the -n and -q options are used.
5873 RELEASE 0.14 - Wed, 21 May 2003 05:16:32 -0500
5875   From Chad Austin:
5877   - Use .dll (not .so) for shared libraries on Cygwin; use -fPIC
5878     when compiling them.
5880   - Use 'rm' to remove files under Cygwin.
5882   - Add a PLATFORM variable to construction environments.
5884   - Remove the "platform" argument from tool specifications.
5886   - Propogate PYTHONPATH when running the regression tests so distutils
5887     can be found in non-standard locations.
5889   - Using MSVC long command-line linking when running Cygwin.
5891   - Portability fixes for a lot of tests.
5893   - Add a Value Node class for dependencies on in-core Python values.
5895   From Allen Bierbaum:
5897   - Pass an Environment to the Options validator method, and
5898     add an Options.Save() method.
5900   From Steve Christensen:
5902   - Add an optional sort function argument to the GenerateHelpText()
5903     Options function.
5905   - Evaluate the "varlist" variables when computing the signature of a
5906     function action.
5908   From Charles Crain:
5910   - Parse the source .java files for class names (including inner class
5911     names) to figure out the target .class files that will be created.
5913   - Make Java support work with Repositories and SConscriptChdir(0).
5915   - Pass Nodes, not strings, to Builder emitter functions.
5917   - Refactor command-line interpolation and signature calculation
5918     so we can use real Node attributes.
5920   From Steven Knight:
5922   - Add Java support (javac, javah, jar and rmic).
5924   - Propagate the external SYSTEMROOT environment variable into ENV on
5925     Win32 systems, so external commands that use sockets will work.
5927   - Add a .posix attribute to PathList expansions.
5929   - Check out CVS source files using POSIX path names (forward slashes
5930     as separators) even on Win32.
5932   - Add Node.clear() and Node.FS.Entry.clear() methods to wipe out a
5933     Node's state, allowing it to be re-evaluated by continuous
5934     integration build interfaces.
5936   - Change the name of the Set{Build,Content}SignatureType() functions
5937     to {Target,Source}Signatures().  Deprecate the old names but support
5938     them for backwards compatibility.
5940   - Add internal SCons.Node.FS.{Dir,File}.Entry() methods.
5942   - Interpolate the null string if an out-of-range subscript is used
5943     for a construction variable.
5945   - Fix the internal Link function so that it properly links or copies
5946     files in subsidiary BuildDir directories.
5948   - Refactor the internal representation of a single execution instance
5949     of an action to eliminate redundant signature calculations.
5951   - Eliminate redundant signature calculations for Nodes.
5953   - Optimize out calling hasattr() before accessing attributes.
5955   - Say "Cleaning targets" (not "Building...") when the -c option is
5956     used.
5958   From Damyan Pepper:
5960   - Quote the "Entering directory" message like Make.
5962   From Stefan Reichor:
5964   - Add support for using Ghostscript to convert Postscript to PDF files.
5966   From Anthony Roach:
5968   - Add a standalone "Alias" function (separate from an Environment).
5970   - Make Export() work for local variables.
5972   - Support passing a dictionary to Export().
5974   - Support Import('*') to import everything that's been Export()ed.
5976   - Fix an undefined exitvalmap on Win32 systems.
5978   - Support new SetOption() and GetOption() functions for setting
5979     various command-line options from with an SConscript file.
5981   - Deprecate the old SetJobs() and GetJobs() functions in favor of
5982     using the new generic {Set,Get}Option() functions.
5984   - Fix a number of tests that searched for a Fortran compiler using the
5985     external PATH instead of what SCons would use.
5987   - Fix the interaction of SideEffect() and BuildDir() so that (for
5988     example) PDB files get put correctly in a BuildDir().
5990   From David Snopek:
5992   - Contribute the "Autoscons" code for Autoconf-like checking for
5993     the existence of libraries, header files and the like.
5995   - Have the Tool() function add the tool name to the $TOOLS
5996     construction variable.
5998   From Greg Spencer:
6000   - Support the C preprocessor #import statement.
6002   - Allow the SharedLibrary() Builder on Win32 systems to be able to
6003     register a newly-built dll using regsvr32.
6005   - Add a Builder for Windows type library (.tlb) files from IDL files.
6007   - Add an IDL scanner.
6009   - Refactor the Fortran, C and IDL scanners to share common logic.
6011   - Add .srcpath and .srcdir attributes to $TARGET and $SOURCE.
6013   From Christoph Wiedemann:
6015   - Integrate David Snopek's "Autoscons" code as the new SConf
6016     configuration subsystem, including caching of values between
6017     runs (using normal SCons dependency mechanisms), tests, and
6018     documentation.
6022 RELEASE 0.13 - Mon, 31 Mar 2003 20:22:00 -0600
6024   From Charles Crain:
6026   - Fix a bug when BuildDir(duplicate=0) is used and SConscript
6027     files are called from within other SConscript files.
6029   - Support (older) versions of Perforce which don't set the Windows
6030     registry.
6034 RELEASE 0.12 - Thu, 27 Mar 2003 23:52:09 -0600
6036   From Charles Crain:
6038   - Added support for the Perforce source code management system.
6040   - Fix str(Node.FS) so that it returns a path relative to the calling
6041     SConscript file's directory, not the top-level directory.
6043   - Added support for a separate src_dir argument to SConscript()
6044     that allows explicit specification of where the source files
6045     for an SConscript file can be found.
6047   - Support more easily re-usable flavors of command generators by
6048     calling callable variables when strings are expanded.
6050   From Steven Knight:
6052   - Added an INSTALL construction variable that can be set to a function
6053     to control how the Install() and InstallAs() Builders install files.
6054     The default INSTALL function now copies, not links, files.
6056   - Remove deprecated features:  the "name" argument to Builder objects,
6057     and the Environment.Update() method.
6059   - Add an Environment.SourceCode() method to support fetching files
6060     from source code systems.  Add factory methods that create Builders
6061     to support BitKeeper, CVS, RCS, and SCCS.  Add support for fetching
6062     files from RCS or SCCS transparently (like GNU Make).
6064   - Make the internal to_String() function more efficient.
6066   - Make the error message the same as other build errors when there's a
6067     problem unlinking a target file in preparation for it being built.
6069   - Make TARGET, TARGETS, SOURCE and SOURCES reserved variable names and
6070     warn if the user tries to set them in a construction environment.
6072   - Add support for Tar and Zip files.
6074   - Better documentation of the different ways to export variables to a
6075     subsidiary SConscript file.  Fix documentation bugs in a tools
6076     example, places that still assumed SCons split strings on white
6077     space, and typos.
6079   - Support fetching arbitrary files from the TARGETS or SOURCES lists
6080     (e.g. ${SOURCES[2]}) when calculating the build signature of a
6081     command.
6083   - Don't silently swallow exceptions thrown by Scanners (or other
6084     exceptions while finding a node's dependent children).
6086   - Push files to CacheDir() before calling the superclass built()
6087     method (which may clear the build signature as part of clearing
6088     cached implicit dependencies, if the file has a source scanner).
6089     (Bug reported by Jeff Petkau.)
6091   - Raise an internal error if we attempt to push a file to CacheDir()
6092     with a build signature of None.
6094   - Add an explicit Exit() function for terminating early.
6096   - Change the documentation to correctly describe that the -f option
6097     doesn't change to the directory in which the specified file lives.
6099   - Support changing directories locally with SConscript directory
6100     path names relative to any SConstruct file specified with -f.
6101     This allows you to build in another directory by simply changing
6102     there and pointing at the SConstruct file in another directory.
6104   - Change the default SConscriptChdir() behavior to change to the
6105     SConscript directory while it's being read.
6107   - Fix an exception thrown when the -U option was used with no
6108     Default() target specified.
6110   - Fix -u so that it builds things in corresponding build directories
6111     when used in a source directory.
6113   From Lachlan O'Dea:
6115   - Add SharedObject() support to the masm tool.
6117   - Fix WhereIs() to return normalized paths.
6119   From Jeff Petkau:
6121   - Don't copy a built file to a CacheDir() if it's already there.
6123   - Avoid partial copies of built files in a CacheDir() by copying
6124     to a temporary file and renaming.
6126   From Anthony Roach:
6128   - Fix incorrect dependency-cycle errors when an Aliased source doesn't
6129     exist.
6133 RELEASE 0.11 - Tue, 11 Feb 2003 05:24:33 -0600
6135   From Chad Austin:
6137   - Add support for IRIX and the SGI MIPSPro tool chain.
6139   - Support using the MSVC tool chain when running Cygwin Python.
6141   From Michael Cook:
6143   - Avoid losing signal bits in the exit status from a command,
6144     helping terminate builds on interrupt (CTRL+C).
6146   From Charles Crain:
6148   - Added new AddPreAction() and AddPostAction() functions that support
6149     taking additional actions before or after building specific targets.
6151   - Add support for the PharLap ETS tool chain.
6153   From Steven Knight:
6155   - Allow Python function Actions to specify a list of construction
6156     variables that should be included in the Action's signature.
6158   - Allow libraries in the LIBS variable to explicitly include the prefix
6159     and suffix, even when using the GNU linker.
6160     (Bug reported by Neal Becker.)
6162   - Use DOS-standard CR-LF line endings in the scons.bat file.
6163     (Bug reported by Gary Ruben.)
6165   - Doc changes:  Eliminate description of deprecated "name" keyword
6166     argument from Builder definition (reported by Gary Ruben).
6168   - Support using env.Append() on BUILDERS (and other dictionaries).
6169     (Bug reported by Bj=F6rn Bylander.)
6171   - Setting the BUILDERS construction variable now properly clears
6172     the previous Builder attributes from the construction Environment.
6173     (Bug reported by Bj=F6rn Bylander.)
6175   - Fix adding a prefix to a file when the target isn't specified.
6176     (Bug reported by Esa Ilari Vuokko.)
6178   - Clean up error messages from problems duplicating into read-only
6179     BuildDir directories or into read-only files.
6181   - Add a CommandAction.strfunction() method, and add an "env" argument
6182     to the FunctionAction.strfunction() method, so that all Action
6183     objects have strfunction() methods, and the functions for building
6184     and returning a string both take the same arguments.
6186   - Add support for new CacheDir() functionality to share derived files
6187     between builds, with related options --cache-disable, --cache-force,
6188     and --cache-show.
6190   - Change the default behavior when no targets are specified to build
6191     everything in the current directory and below (like Make).  This
6192     can be disabled by specifying Default(None) in an SConscript.
6194   - Revamp SCons installation to fix a case-sensitive installation
6195     on Win32 systems, and to add SCons-specific --standard-lib,
6196     --standalone-lib, and --version-lib options for easier user
6197     control of where the libraries get installed.
6199   - Fix the ability to directly import and use Platform and Tool modules
6200     that have been implicitly imported into an Environment().
6202   - Add support for allowing an embedding interface to annotate a node
6203     when it's created.
6205   - Extend the SConscript() function to accept build_dir and duplicate
6206     keyword arguments that function like a BuildDir() call.
6208   From Steve Leblanc:
6210   - Fix the output of -c -n when directories are involved, so it
6211     matches -c.
6213   From Anthony Roach:
6215   - Use a different shared object suffix (.os) when using gcc so shared
6216     and static objects can exist side-by-side in the same directory.
6218   - Allow the same object files on Win32 to be linked into either
6219     shared or static libraries.
6221   - Cache implicit cache values when using --implicit-cache.
6225 RELEASE 0.10 - Thu, 16 Jan 2003 04:11:46 -0600
6227   From Derrick 'dman' Hudson:
6229   - Support Repositories on other file systems by symlinking or
6230     copying files when hard linking won't work.
6232   From Steven Knight:
6234   - Remove Python bytecode (*.pyc) files from the scons-local packages.
6236   - Have FunctionActions print a description of what they're doing
6237     (a representation of the Python call).
6239   - Fix the Install() method so that, like other actions, it prints
6240     what would have happened when the -n option is used.
6242   - Don't create duplicate source files in a BuildDir when the -n
6243     option is used.
6245   - Refactor the Scanner interface to eliminate unnecessary Scanner
6246     calls and make it easier to write efficient scanners.
6248   - Added a "recursive" flag to Scanner creation that specifies the
6249     Scanner should be invoked recursively on dependency files returned
6250     by the scanner.
6252   - Significant performance improvement from using a more efficient
6253     check, throughout the code, for whether a Node has a Builder.
6255   - Fix specifying only the source file to MultiStepBuilders such as
6256     the Program Builder.  (Bug reported by Dean Bair.)
6258   - Fix an exception when building from a file with the same basename as
6259     the subdirectory in which it lives.  (Bug reported by Gerard Patel.)
6261   - Fix automatic deduction of a target file name when there are
6262     multiple source files specified; the target is now deduced from just
6263     the first source file in the list.
6265   - Documentation fixes: better initial explanation of SConscript files;
6266     fix a misformatted "table" in the StaticObject explanation.
6268   From Steven Knight and Steve Leblanc:
6270   - Fix the -c option so it will remove symlinks.
6272   From Steve Leblanc:
6274   - Add a Clean() method to support removing user-specified targets
6275     when using the -c option.
6277   - Add a development script for running SCons through PyChecker.
6279   - Clean up things found by PyChecker (mostly unnecessary imports).
6281   - Add a script to use HappyDoc to create HTML class documentation.
6283   From Lachlan O'Dea:
6285   - Make the Environment.get() method return None by default.
6287   From Anthony Roach:
6289   - Add SetJobs() and GetJobs() methods to allow configuration of the
6290     number of default jobs (still overridden by -j).
6292   - Convert the .sconsign file format from ASCII to a pickled Python
6293     data structure.
6295   - Error message cleanups:  Made consistent the format of error
6296     messages (now all start with "scons: ***") and warning messages (now
6297     all start with "scons: warning:").  Caught more cases with the "Do
6298     not know how to build" error message.
6300   - Added support for the MinGW tool chain.
6302   - Added a --debug=includes option.
6306 RELEASE 0.09 - Thu,  5 Dec 2002 04:48:25 -0600
6308   From Chad Austin:
6310   - Add a Prepend() method to Environments, to append values to
6311     the beginning of construction variables.
6313   From Matt Balvin:
6315   - Add long command-line support to the "lib" Tool (Microsoft library
6316     archiver), too.
6318   From Charles Crain:
6320   - Allow $$ in a string to be passed through as $.
6322   - Support file names with odd characters in them.
6324   - Add support for construction variable substition on scanner
6325     directories (in CPPPATH, F77PATH, LIBPATH, etc.).
6327   From Charles Crain and Steven Knight:
6329   - Add Repository() functionality, including the -Y option.
6331   From Steven Knight:
6333   - Fix auto-deduction of target names so that deduced targets end
6334     up in the same subdirectory as the source.
6336   - Don't remove source files specified on the command line!
6338   - Suport the Intel Fortran Compiler (ifl.exe).
6340   - Supply an error message if there are no command-line or
6341     Default() targets specified.
6343   - Fix the ASPPCOM values for the GNU assembler.
6344     (Bug reported by Brett Polivka.)
6346   - Fix an exception thrown when a Default() directory was specified
6347     when using the -U option.
6349   - Issue a warning when -c can't remove a target.
6351   - Eliminate unnecessary Scanner calls by checking for the
6352     existence of a file before scanning it.  (This adds a generic
6353     hook to check an arbitrary condition before scanning.)
6355   - Add explicit messages to tell when we're "Reading SConscript files
6356     ...," "done reading SConscript files," "Building targets," and
6357     "done building targets."  Add a -Q option to supress these.
6359   - Add separate $SHOBJPREFIX and $SHOBJSUFFIX construction variables
6360     (by default, the same as $OBJPREFIX and $OBJSUFFIX).
6362   - Add Make-like error messages when asked to build a source file,
6363     and before trying to build a file that doesn't have all its source
6364     files (including when an invalid drive letter is used on WIN32).
6366   - Add an scons-local-{version} package (in both .tar.gz and .zip
6367     flavors) to help people who want to ship SCons as a stand-alone
6368     build tool in their software packages.
6370   - Prevent SCons from unlinking files in certain situations when
6371     the -n option is used.
6373   - Change the name of Tool/lib.py to Tool/mslib.py.
6375   From Steven Knight and Anthony Roach:
6377   - Man page:  document the fact that Builder calls return Node objects.
6379   From Steve LeBlanc:
6381   - Refactor option processing to use our own version of Greg Ward's
6382     Optik module, modified to run under Python 1.5.2.
6384   - Add a ParseConfig() command to modify an environment based on
6385     parsing output from a *-config command.
6387   From Jeff Petkau:
6389   - Fix interpretation of '#/../foo' on Win32 systems.
6391   From Anthony Roach:
6393   - Fixed use of command lines with spaces in their arguments,
6394     and use of Nodes with spaces in their string representation.
6396   - Make access and modification times of files in a BuildDir match
6397     the source file, even when hard linking isn't available.
6399   - Make -U be case insensitive on Win32 systems.
6401   - Issue a warning and continue when finding a corrupt .sconsign file.
6403   - Fix using an alias as a dependency of a target so that if one of the
6404     alias' dependencies gets rebuilt, the resulting target will, too.
6406   - Fix differently ordered targets causing unnecessary rebuilds
6407     on case insensitive systems.
6409   - Use os.system() to execute external commands whenever the "env"
6410     utility is available, which is much faster than fork()/exec(),
6411     and fixes the -j option on several platforms.
6413   - Fix use of -j with multiple targets.
6415   - Add an Options() object for friendlier accomodation of command-
6416     line arguments.
6418   - Add support for Microsoft VC++ precompiled header (.pch) files,
6419     debugger (.pdb) files, and resource (.rc) files.
6421   - Don't compute the $_CPPINCFLAGS, $_F77INCFLAGS, $_LIBFLAGS and
6422     $_LIBDIRFLAGS variables each time a command is executed, define
6423     them so they're computed only as needed.  Add a new _concat
6424     function to the Environment that allows people to define their
6425     own similar variables.
6427   - Fix dependency scans when $LIBS is overridden.
6429   - Add EnsurePythonVersion() and EnsureSConsVersion() functions.
6431   - Fix the overly-verbose stack trace on ListBuilder build errors.
6433   - Add a SetContentSignatureType() function, allowing use of file
6434     timestamps instead of MD5 signatures.
6436   - Make -U and Default('source') fail gracefully.
6438   - Allow the File() and Dir() methods to take a path-name string as
6439     the starting directory, in addition to a Dir object.
6441   - Allow the command handler to be selected via the SPAWN, SHELL
6442     and ESCAPE construction variables.
6444   - Allow construction variables to be overridden when a Builder
6445     is called.
6447   From sam th:
6449   - Dynamically check for the existence of utilities with which to
6450     initialize Environments by default.
6454 RELEASE 0.08 - Mon, 15 Jul 2002 12:08:51 -0500
6456   From Charles Crain:
6458   - Fixed a bug with relative CPPPATH dirs when using BuildDir().
6459     (Bug reported by Bob Summerwill.)
6461   - Added a warnings framework and a --warn option to enable or
6462     disable warnings.
6464   - Make the C scanner warn users if files referenced by #include
6465     directives cannot be found and --warn=dependency is specified.
6467   - The BUILDERS construction variable should now be a dictionary
6468     that maps builder names to actions.  Existing uses of lists,
6469     and the Builder name= keyword argument, generate warnings
6470     about use of deprecated features.
6472   - Removed the "shared" keyword argument from the Object and
6473     Library builders.
6475   - Added separated StaticObject, SharedObject, StaticLibrary and
6476     SharedLibrary builders.  Made Object and Library synonyms for
6477     StaticObject and StaticLibrary, respectively.
6479   - Add LIBS and LIBPATH dependencies for shared libraries.
6481   - Removed support for the prefix, suffix and src_suffix arguments
6482     to Builder() to be callable functions.
6484   - Fix handling file names with multiple dots.
6486   - Allow a build directory to be outside of the SConstruct tree.
6488   - Add a FindFile() function that searches for a file node with a
6489     specified name.
6491   - Add $CPPFLAGS to the shared-object command lines for g++ and gcc.
6493   From Charles Crain and Steven Knight:
6495   - Add a "tools=" keyword argument to Environment instantiation,
6496     and a separate Tools() method, for more flexible specification
6497     of tool-specific environment changes.
6499   From Steven Knight:
6501   - Add a "platform=" keyword argument to Environment instantiation,
6502     and a separate Platform() method, for more flexible specification
6503     of platform-specific environment changes.
6505   - Updated README instructions and setup.py code to catch an
6506     installation failure from not having distutils installed.
6508   - Add descriptions to the -H help text for -D, -u and -U so
6509     people can tell them apart.
6511   - Remove the old feature of automatically splitting strings
6512     of file names on white space.
6514   - Add a dependency Scanner for native Fortran "include" statements,
6515     using a new "F77PATH" construction variable.
6517   - Fix C #include scanning to detect file names with characters like
6518     '-' in them.
6520   - Add more specific version / build output to the -v option.
6522   - Add support for the GNU as, Microsoft masm, and nasm assemblers.
6524   - Allow the "target" argument to a Builder call to be omitted, in
6525     which case the target(s) are deduced from the source file(s) and the
6526     Builder's specified suffix.
6528   - Add a tar archive builder.
6530   - Add preliminary support for the OS/2 Platform, including the icc
6531     and ilink Tools.
6533   From Jeff Petkau:
6535   - Fix --implicit-cache if the scanner returns an empty list.
6537   From Anthony Roach:
6539   - Add a "multi" keyword argument to Builder creation that specifies
6540     it's okay to call the builder multiple times for a target.
6542   - Set a "multi" on Aliases so multiple calls will append to an Alias.
6544   - Fix emitter functions' use of path names when using BuildDir or
6545     in subdirectories.
6547   - Fix --implicit-cache causing redundant rebuilds when the header
6548     file list changed.
6550   - Fix --implicit-cache when a file has no implicit dependencies and
6551     its source is generated.
6553   - Make the drive letters on Windows always be the same case, so that
6554     changes in the case of drive letters don't cause a rebuild.
6556   - Fall back to importing the SCons.TimeStamp module if the SCons.MD5
6557     module can't be imported.
6559   - Fix interrupt handling to guarantee that a single interrupt will
6560     halt SCons both when using -j and not.
6562   - Fix .sconsign signature storage so that output files of one build
6563     can be safely used as input files to another build.
6565   - Added a --debug=time option to print SCons execution times.
6567   - Print an error message if a file can't be unlinked before being
6568     built, rather than just silently terminating the build.
6570   - Add a SideEffect() method that can be used to tell the build
6571     engine that a given file is created as a side effect of building
6572     a target.  A file can be specified as a side effect of more than
6573     one build comand, in which case the commands will not be executed
6574     simultaneously.
6576   - Significant performance gains from not using our own version of
6577     the inefficient stock os.path.splitext() method, caching source
6578     suffix computation, code cleanup in MultiStepBuilder.__call__(),
6579     and replicating some logic in scons_subst().
6581   - Add --implicit-deps-changed and --implicit-deps-unchanged options.
6583   - Add a GetLaunchDir() function.
6585   - Add a SetBuildSignatureType() function.
6587   From Zed Shaw:
6589   - Add an Append() method to Environments, to append values to
6590     construction variables.
6592   - Change the name of Update() to Replace().  Keep Update() as a
6593     deprecated synonym, at least for now.
6595   From Terrel Shumway:
6597   - Use a $PYTHON construction variable, initialized to sys.executable,
6598     when using Python to build parts of the SCons packages.
6600   - Use sys.prefix, not sys.exec_prefix, to find pdb.py.
6604 RELEASE 0.07 - Thu,  2 May 2002 13:37:16 -0500
6606   From Chad Austin:
6608   - Changes to build SCons packages on IRIX (and other *NIces).
6610   - Don't create a directory Node when a file already exists there,
6611     and vice versa.
6613   - Add 'dirs' and 'names' keyword arguments to SConscript for
6614     easier specification of subsidiary SConscript files.
6616   From Charles Crain:
6618   - Internal cleanup of environment passing to function Actions.
6620   - Builders can now take arbitrary keyword arguments to create
6621     attributes to be passed to: command generator functions,
6622     FunctionAction functions, Builder emitter functions (below),
6623     and prefix/suffix generator functions (below).
6625   - Command generator functions can now return ANYTHING that can be
6626     converted into an Action (a function, a string, a CommandGenerator
6627     instance, even an ActionBase instance).
6629   - Actions now call get_contents() with the actual target and source
6630     nodes used for the build.
6632   - A new DictCmdGenerator class replaces CompositeBuilder to support
6633     more flexible Builder behavior internally.
6635   - Builders can now take an emitter= keyword argument.  An emitter
6636     is a function that takes target, source, and env argument, then
6637     return a 2-tuple of (new sources, new targets).  The emitter is
6638     called when the Builder is __call__'ed, allowing a user to modify
6639     source and target lists.
6641   - The prefix, suffix and src_suffix Builder arguments now take a
6642     callable as well a string.  The callable is passed the Environment
6643     and any extra Builder keyword arguments and is expected to return
6644     the appropriate prefix or suffix.
6646   - CommandActions can now be a string, a list of command + argument
6647     strings, or a list of commands (strings or lists).
6649   - Added shared library support.  The Object and Library Builders now
6650     take a "shared=1" keyword argument to specify that a shared object
6651     or shared library should be built.  It is an error to try to build
6652     static objects into a shared library or vice versa.
6654   - Win32 support for .def files has been added.  Added the Win32-specific
6655     construction variables $WIN32DEFPREFIX, $WIN32DEFSUFFIX,
6656     $WIN32DLLPREFIX and $WIN32IMPLIBPREFIX.  When building a .dll,
6657     the new construction variable $WIN32_INSERT_DEF, controls whether
6658     the appropriately-named .def file is inserted into the target
6659     list (if not already present).  A .lib file is always added to
6660     a Library build if not present in the list of targets.
6662   - ListBuilder now passes all targets to the action, not just the first.
6664   - Fix so that -c now deletes generated yacc .h files.
6666   - Builder actions and emitter functions can now be initialized, through
6667     construction variables, to things other than strings.
6669   - Make top-relative '#/dir' lookups work like '#dir'.
6671   - Fix for relative CPPPATH directories in subsidiary SConscript files
6672     (broken in 0.06).
6674   - Add a for_signature argument to command generators, so that
6675     generators that need to can return distinct values for the
6676     command signature and for executing the command.
6678   From Alex Jacques:
6680   - Create a better scons.bat file from a py2bat.py script on the Python
6681     mailing list two years ago (modeled after pl2bat.pl).
6683   From Steven Knight:
6685   - Fix so that -c -n does *not* remove the targets!
6687   - Man page:  Add a hierarchical libraries + Program example.
6689   - Support long MSVC linker command lines through a builder action
6690     that writes to a temporary file and uses the magic MSVC "link @file"
6691     argument syntax if the line is longer than 2K characters.
6693   - Fix F77 command-line options on Win32 (use /Fo instead of -o).
6695   - Use the same action to build from .c (lower case) and .C (upper
6696     case) files on case-insensitive systems like Win32.
6698   - Support building a PDF file directly from a TeX or LaTeX file
6699     using pdftex or pdflatex.
6701   - Add a -x option to runtest.py to specify the script being tested.
6702     A -X option indicates it's an executable, not a script to feed
6703     to the Python interpreter.
6705   - Add a Split() function (identical to SCons.Util.argmunge()) for use
6706     in the next release, when Builders will no longer automatically split
6707     strings on white space.
6709   From Steve Leblanc:
6711   - Add the SConscriptChdir() method.
6713   From Anthony Roach:
6715   - Fix --debug=tree when used with directory targets.
6717   - Significant internal restructuring of Scanners and Taskmaster.
6719   - Added new --debug=dtree option.
6721   - Fixes for --profile option.
6723   - Performance improvement in construction variable substitution.
6725   - Implemented caching of content signatures, plus added --max-drift
6726     option to control caching.
6728   - Implemented caching of dependency signatures, enabled by new
6729     --implicit-cache option.
6731   - Added abspath construction variable modifier.
6733   - Added $SOURCE variable as a synonym for $SOURCES[0].
6735   - Write out .sconsign files on error or interrupt so intermediate
6736     build results are saved.
6738   - Change the -U option to -D.  Make a new -U that builds just the
6739     targets from the local SConscript file.
6741   - Fixed use of sys.path so Python modules can be imported from
6742     the SConscript directory.
6744   - Fix for using Aliases with the -u, -U and -D options.
6746   - Fix so that Nodes can be passed to SConscript files.
6748   From Moshe Zadka:
6750   - Changes for official Debian packaging.
6754 RELEASE 0.06 - Thu, 28 Mar 2002 01:24:29 -0600
6756   From Charles Crain:
6758   - Fix command generators to expand construction variables.
6760   - Make FunctionAction arguments be Nodes, not strings.
6762   From Stephen Kennedy:
6764   - Performance:  Use a dictionary, not a list, for a Node's parents.
6766   From Steven Knight:
6768   - Add .zip files to the packages we build.
6770   - Man page:  document LIBS, fix a typo, document ARGUMENTS.
6772   - Added RANLIB and RANLIBFLAGS construction variables.  Only use them
6773     in ARCOM if there's a "ranlib" program on the system.
6775   - Add a configurable CFILESUFFIX for the Builder of .l and .y files
6776     into C files.
6778   - Add a CXXFile Builder that turns .ll and .yy files into .cc files
6779     (configurable via a CXXFILESUFFIX construction variable).
6781   - Use the POSIX-standard lex -t flag, not the GNU-specific -o flag.
6782     (Bug reported by Russell Christensen.)
6784   - Fixed an exception when CPPPATH or LIBPATH is a null string.
6785     (Bug reported by Richard Kiss.)
6787   - Add a --profile=FILE option to make profiling SCons easier.
6789   - Modify the new DVI builder to create .dvi files from LaTeX (.ltx
6790     and .latex) files.
6792   - Add support for Aliases (phony targets).
6794   - Add a WhereIs() method for searching for path names to executables.
6796   - Add PDF and PostScript document builders.
6798   - Add support for compiling Fortran programs from a variety of
6799     suffixes (a la GNU Make):  .f, .F, .for, .FOR, .fpp and .FPP
6801   - Support a CPPFLAGS variable on all default commands that use the
6802     C preprocessor.
6804   From Steve Leblanc:
6806   - Add support for the -U option.
6808   - Allow CPPPATH, LIBPATH and LIBS to be specified as white-space
6809     separated strings.
6811   - Add a document builder to create .dvi files from TeX (.tex) files.
6813   From Anthony Roach:
6815   - Fix:  Construction variables with values of 0 were incorrectly
6816     interpolated as ''.
6818   - Support env['VAR'] to fetch construction variable values.
6820   - Man page:  document Precious().
6824 RELEASE 0.05 - Thu, 21 Feb 2002 16:50:03 -0600
6826   From Chad Austin:
6828   - Set PROGSUFFIX to .exe under Cygwin.
6830   From Charles Crain:
6832   - Allow a library to specified as a command-line source file, not just
6833     in the LIBS construction variable.
6835   - Compensate for a bug in os.path.normpath() that returns '' for './'
6836     on WIN32.
6838   - More performance optimizations:  cache #include lines from files,
6839     eliminate unnecessary calls.
6841   - If a prefix or suffix contains white space, treat the resulting
6842     concatenation as separate arguments.
6844   - Fix irregularities in the way we fetch DevStudio information from
6845     the Windows registry, and in our registry error handling.
6847   From Steven Knight:
6849   - Flush stdout after print so it intermixes correctly with stderr
6850     when redirected.
6852   - Allow Scanners to return a list of strings, and document how to
6853     write your own Scanners.
6855   - Look up implicit (scanned) dependencies relative to the directory
6856     of file being scanned.
6858   - Make writing .sconsign files more robust by first trying to write
6859     to a temp file that gets renamed.
6861   - Create all of the directories for a list of targets before trying
6862     to build any of the targets.
6864   - WIN32 portability fixes in tests.
6866   - Allow the list of variables exported to an SConscript file to be
6867     a UserList, too.
6869   - Document the overlooked LIBPATH construction variable.
6870     (Bug reported by Eicke Godehardt.)
6872   - Fix so that Ignore() ignores indirect, implicit dependencies
6873     (included files), not just direct dependencies.
6875   - Put the man page in the Debian distribution.
6877   - Run HTML docs through tidy to clean up the HTML (for Konqueror).
6879   - Add preliminary support for Unicode strings.
6881   - Efficiency:  don't scan dependencies more than once during the
6882     walk of a tree.
6884   - Fix the -c option so it doesn't stop removing targets if one doesn't
6885     already exist.
6886     (Bug reported by Paul Connell.)
6888   - Fix the --debug=pdb option when run on Windows NT.
6889     (Bug reported by Paul Connell.)
6891   - Add support for the -q option.
6893   From Steve Leblanc:
6895   - Add support for the -u option.
6897   - Add .cc and .hh file suffixes to the C Scanner.
6899   From Anthony Roach:
6901   - Make the scons script return an error code on failures.
6903   - Add support for using code to generate a command to build a target.
6907 RELEASE 0.04 - Wed, 30 Jan 2002 11:09:42 -0600
6909   From Charles Crain:
6911   - Significant performance improvements in the Node.FS and
6912     Scanner subsystems.
6914   - Fix signatures of binary files on Win32 systems.
6916   - Allow LIBS and LIBPATH to be strings, not just arrays.
6918   - Print a traceback if a Python-function builder throws an exception.
6920   From Steven Knight:
6922   - Fix using a directory as a Default(), and allow Default() to
6923     support white space in file names for strings in arrays.
6925   - Man page updates:  corrected some mistakes, documented various
6926     missing Environment methods, alphabetized the construction
6927     variables and other functions, defined begin and end macros for
6928     the example sections, regularized white space separation, fixed
6929     the use of Export() in the Multiple Variants example.
6931   - Function action fixes:  None is now a successful return value.
6932     Exceptions are now reported.  Document function actions.
6934   - Add 'Action' and 'Scanner' to the global keywords so SConscript
6935     files can use them too.
6937   - Removed the Wrapper class between Nodes and Walkers.
6939   - Add examples using Library, LIBS, and LIBPATH.
6941   - The C Scanner now always returns a sorted list of dependencies
6942     so order changes don't cause unnecessary rebuilds.
6944   - Strip $(-$) bracketed text from command lines.  Use this to
6945     surround $_INCDIRS and $_LIBDIRS so we don't rebuild in response
6946     to changes to -I or -L options.
6948   - Add the Ignore() method to ignore dependencies.
6950   - Provide an error message when a nonexistent target is specified
6951     on the command line.
6953   - Remove targets before building them, and add an Environment
6954     Precious() method to override that.
6956   - Eliminate redundant calls to the same builder when the target is a
6957     list of targets:  Add a ListBuilder class that wraps Builders to
6958     handle lists atomically.  Extend the Task class to support building
6959     and updating multiple targets in a single Task.  Simplify the
6960     interface between Task and Taskmaster.
6962   - Add a --debug=pdb option to re-run SCons under the Python debugger.
6964   - Only compute a build signature once for each node.
6966   - Changes to our sys.path[] manipulation to support installation into
6967     an arbitrary --prefix value.
6969   From Steve Leblanc:
6971   - Add var=value command-line arguments.
6975 RELEASE 0.03 - Fri, 11 Jan 2002 01:09:30 -0600
6977   From Charles Crain:
6979   - Performance improvements in the Node.FS and Sig.Calculator classes.
6981   - Add the InstallAs() method.
6983   - Execute commands through an external interpreter (sh, cmd.exe, or
6984     command.com) to handle redirection metacharacters.
6986   - Allow the user to supply a command handler.
6988   From Steven Knight:
6990   - Search both /usr/lib and /usr/local/lib for scons directories by
6991     adding them both to sys.path, with whichever is in sys.prefix first.
6993   - Fix interpreting strings of multiple white-space separated file names
6994     as separate file names, allowing prefixes and suffixes to be appended
6995     to each individually.
6997   - Refactor to move CompositeBuilder initialization logic from the
6998     factory wrapper to the __init__() method, and allow a Builder to
6999     have both an action and a src_builder (or array of them).
7001   - Refactor BuilderBase.__call__() to separate Node creation/lookup
7002     from initialization of the Node's builder information.
7004   - Add a CFile Builder object that supports turning lex (.l) and
7005     yacc (.y) files into .c files.
7007   - Document: variable interpretation attributes; how to propogate
7008     the user's environment variables to executed commands; how to
7009     build variants in multiple BuildDirs.
7011   - Collect String, Dict, and List type-checking in common utility
7012     routines so we can accept User{String,Dict,List}s all over.
7014   - Put the Action factory and classes into their own module.
7016   - Use one CPlusPlusAction in the Object Builder's action dictionary,
7017     instead of letting it create multiple identical instances.
7019   - Document the Install() and InstallAs() methods.
7021   From Steve Leblanc:
7023   - Require that a Builder be given a name argument, supplying a
7024     useful error message when it isn't.
7026   From Anthony Roach:
7028   - Add a "duplicate" keyword argument to BuildDir() that can be set
7029     to prevent linking/copying source files into build directories.
7031   - Add a "--debug=tree" option to print an ASCII dependency tree.
7033   - Fetch the location of the Microsoft Visual C++ compiler(s) from
7034     the Registry, instead of hard-coding the location.
7036   - Made Scanner objects take Nodes, not path names.
7038   - Have the C Scanner cache the #include file names instead of
7039     (re-)scanning the file each time it's called.
7041   - Created a separate class for parent "nodes" of file system roots,
7042     eliminating the need for separate is-parent-null checks everywhere.
7044   - Removed defined __hash__() and __cmp() methods from FS.Entry, in
7045     favor of Python's more efficient built-in identity comparisons.
7049 RELEASE 0.02 - Sun, 23 Dec 2001 19:05:09 -0600
7051   From Charles Crain:
7053   - Added the Install(), BuildDir(), and Export() methods.
7055   - Fix the -C option by delaying setting the top of the FS tree.
7057   - Avoid putting the directory path on the libraries in the LIBS
7058     construction variable.
7060   - Added a GetBuildPath() method to return the full path to the
7061     Node for a specified string.
7063   - Fixed variable substitution in CPPPATH and LIBPATH.
7065   From Steven Knight:
7067   - Fixed the version comment in the scons.bat (the UNIX geek used
7068     # instead of @rem).
7070   - Fix to setup.py so it doesn't require a sys.argv[1] argument.
7072   - Provide make-like warning message for "command not found" and
7073     similar errors.
7075   - Added an EXAMPLES section to the man page.
7077   - Make Default() targets properly relative to their SConscript
7078     file's subdirectory.
7080   From Anthony Roach:
7082   - Documented CXXFLAGS, CXXCOM, and CPPPATH.
7084   - Fixed SCONS_LIB_DIR to work as documented.
7086   - Made Default() accept Nodes as arguments.
7088   - Changed Export() to make it easier to use.
7090   - Added the Import() and Return() methods.
7094 RELEASE 0.01 - Thu Dec 13 19:25:23 CST 2001
7096 A brief overview of important functionality available in release 0.01:
7098   - C and C++ compilation on POSIX and Windows NT.
7100   - Automatic scanning of C/C++ source files for #include dependencies.
7102   - Support for building libraries; setting construction variables
7103     allows creation of shared libraries.
7105   - Library and C preprocessor search paths.
7107   - File changes detected using MD5 signatures.
7109   - User-definable Builder objects for building files.
7111   - User-definable Scanner objects for scanning for dependencies.
7113   - Parallel build (-j) support.
7115   - Dependency cycles detected.
7117   - Linux packages available in RPM and Debian format.
7119   - Windows installer available.