Fix indent problem in Install test fix
[scons.git] / CHANGES.txt
blobdefd0e385e23431937db7887aa6529ba6b7bbbe4
3                  SCons - a software construction tool
5                             Change Log
7 NOTE: The 4.0.0 release of SCons dropped Python 2.7 support. Use 3.1.2 if
8   Python 2.7 support is required (but note old SCons releases are unsupported).
9 NOTE: Since SCons 4.3.0, Python 3.6.0 or above is required.
10 NOTE: Python 3.6 support is deprecated and will be dropped in a future release.
11   python.org no longer supports 3.6 or 3.7, and will drop 3.8 in Oct. 2024.
13 RELEASE  VERSION/DATE TO BE FILLED IN LATER
15   From Joseph Brill:
16     - Added error handling when creating MS VC detection debug log file specified by
17       SCONS_MSCOMMON_DEBUG
19   From Dillan Mills:
20     - Fix support for short options (`-x`).
22   From Mats Wichmann:
23     - PackageVariable now does what the documentation always said it does
24       if the variable is used on the command line with one of the enabling
25       string as the value: the variable's default value is produced (previously
26       it always produced True in this case).
27     - Minor updates to test framework. The functional change is that
28       test.must_exist() and test.must_exist_one_of() now take an optional
29       'message' keyword argument which is passed on to fail_test() if
30       the test fails. The rest is cleanup and type annotations. Be more
31       careful that the returns from stderr() and stdout(), which *can*
32       return None, are not used without checking.
33     - The optparse add_option method supports an additional calling style
34       that is not directly described in SCons docs, but is included
35       by reference ("see the optparse documentation for details"):
36       a single arg consisting of a premade option object. Because optparse
37       detects that case based on seeing zero kwargs and we always
38       added at least one (default=) that would fail for AddOption. Fix
39       for consistency, but don't advertise it further - not addewd to
40       manpage synoposis/description.
41     - Temporary files created by TempFileMunge() are now cleaned up on
42       scons exit, instead of at the time they're used.  Fixes #4595.
43     - Override envirionments, created when giving construction environment
44       keyword arguments to Builder calls (or manually, through the undocumented
45       Override method), were modified not to "leak" on item deletion.  The item
46       will now not be deleted from the base environment. Override Environments
47       now also pretend to have a _dict attribute so that regular environment
48       methods don't have a problem if passed an OE instance.
49     - Fix a problem with compilation_db component initialization - the
50       entries for assembler files were not being set up correctly.
51     - Add clang and clang++ to the default tool search orders for POSIX
52       and Windows platforms. These will be searched for after gcc and g++,
53       respectively. Does not affect expliclity requested tool lists.
54       Note: on Windows, SCons currently only has builtin support for
55       clang, not for clang-cl, the version of the frontend that uses
56       cl.exe-compatible command line switches.
57     - Some manpage cleanup for the gettext and pdf/ps builders.
58     - Some clarifications in the User Guide "Environments" chapter.
59     - Fix nasm test for missing include file, cleanup.
60     - Change long-standing irritant in Environment tests - instead of using
61       a while loop to pull test info from a list of tests and then delete
62       the test, structure the test data as a list of tuples and iterate it.
63     - Skip running a few validation tests if the user is root and the test is
64       not designed to work for the root user.
66   From Alex James:
67     - On Darwin, PermissionErrors are now handled while trying to access
68       /etc/paths.d. This may occur if SCons is invoked in a sandboxed
69       environment (such as Nix).
72 RELEASE 4.8.1 -  Tue, 03 Sep 2024 17:22:20 -0700
74   From Thaddeus Crews:
75     - Add explicit return types to sctypes `is_*` functions. For Python <=3.9,
76       the return type is simply `bool`, same as before. Python 3.10 and later
77       will benefit from `TypeGuard`/`TypeIs`, to produce intellisense similar
78       to using `isinstance` directly.
80   From Anthony Siegrist;
81     - On win32 platform, handle piped process output more robustly. Output encoding
82       now uses 'oem' which should be the systems default encoding for the shell where
83       the process is being spawned.
85   From Mats Wichmann:
86     - env.Dump() now considers the "key" positional argument to be a varargs
87       type (zero, one or many). However called, it returns a serialized
88       result that looks like a dict. Previously, only a single "key" was
89       accepted, and unlike the zero-args case, it was serialized to a
90       string containing just the value (without the key). For example, if
91       "print(repr(env.Dump('CC'))" previously returned "'gcc'", it will now
92       return "{'CC': 'gcc'}".
93     - Add a timeout to test/ninja/default_targets.py - it's gotten stuck on
94       the GitHub Windows action and taken the run to the full six hour timeout.
95       Usually runs in a few second, so set the timeout to 3min (120).
96     - SCons 4.8.0 added an `__all__`  specifier at the top of the Variables
97       module (`Variables/__init__.py`) to control what is made available in
98       a star import. However, there was existing usage of doing
99       `from SCons.Variables import *` which expected the variable *types*
100       to be avaiable. While we never advertised this usage, there's no
101       real reason it shouldn't keep working - add to `__all__`.
102     - Switch SCons build to use setuptools' supported version fetcher from
103       the old homegrown one.
104     - Improve wording of manpage "Functions and Environment Methods" section.
105       Make doc function signature style more consistent - tweaks to AddOption,
106       DefaultEnvironment and Tool,.
107     - Fix a problem with AppendUnique and PrependUnique where a value could
108       be erroneously removed due to a substring match.
109     - Fix handling of ListVariable when supplying a quoted choice containing
110       a space character (issue #4585).
113 RELEASE 4.8.0 -  Sun, 07 Jul 2024 17:22:20 -0700
115   From Joseph Brill:
116     - For msvc version specifications without an 'Exp' suffix, an express installation
117       is used when no other edition is detected for the msvc version.  Similarly, an
118       express installation of the IDE binary is used when no other IDE edition is
119       detected.
120     - VS2015 Express (14.0Exp) does not support the sdk version argument.  VS2015 Express
121       does not support the store argument for target architectures other than x86.
122       Script argument validation now takes into account these restrictions.
123     - VS2015 BuildTools (14.0) does not support the sdk version argument and does not
124       support the store argument.  Script argument validation now takes into account
125       these restrictions.
126     - The Windows SDK for Windows 7 and .NET Framework 4" (SDK 7.1) populates the
127       registry keys in a manner in which the msvc detection would report that VS2010
128       (10.0) is installed when only the SDK was installed.  The installed files are
129       intended to be used via the sdk batch file setenv.cmd. The installed msvc
130       batch files will fail. The msvc detection logic now ignores SDK-only VS2010
131       installations.  Similar protection is implemented for the sdk-only installs that
132       populate the installation folder and registry keys for VS2008 (9.0), if necessary.
133     - For VS2005 (8.0) to VS2015 (14.0), vsvarsall.bat is employed to dispatch to a
134       dependent batch file when configuring the msvc environment.  Previously, only the
135       existence of the compiler executable was verified. In certain installations, the
136       dependent batch file (e.g., vcvars64.bat) may not exist while the compiler
137       executable does exist resulting in build failures.  The existence of vcvarsall.bat,
138       the dependent batch file, and the compiler executable are now validated.
139     - MSVC configuration data specific to versions VS2005 (8.0) to VS2008 (9.0) was added
140       as the dependent batch files have different names than the batch file names used
141       for VS2010 (10.0) and later.  The VS2008 (9.0) Visual C++ For Python installation
142       is handled as a special case as the dependent batch files are: (a) not used and (b)
143       in different locations.
144     - When VS2008 (9.0) Visual C++ For Python is installed using the ALLUSERS=1 option
145       (i.e., msiexec /i VCForPython27.msi ALLUSERS=1), the registry keys are written to
146       HKEY_LOCAL_MACHINE rather than HKEY_CURRENT_USER.  An entry was added to query the
147       Visual C++ For Python keys in HKLM following the HKCU query, if necessary.
148     - For VS2008, a full development edition (e.g., Professional) is now selected before
149       a Visual C++ For Python edition.  Prior to this change, Visual C++ For Python was
150       selected before a full development edition when both editions are installed.
151     - The registry detection of VS2015 (14.0), and earlier, is now cached at runtime and
152       is only evaluated once for each msvc version.
153     - The vswhere executable is frozen upon initial detection.  Specifying a different
154       vswhere executable via the construction variable VSWHERE after the initial
155       detection now results in an exception.  Multiple bugs in the implementation of
156       specifying a vswhere executable via the construction variable VSWHERE have been
157       fixed.  Previously, when a user specified vswhere executable detects new msvc
158       installations after the initial detection, the internal msvc installation cache
159       and the default msvc version based on the initial detection are no longer valid.
160       For example, when no vswhere executable is found for the initial detection
161       and then later an environment is constructed with a user specified vswhere
162       executable that detects new msvc installations.
163     - The vswhere detection of VS2017 (14.1), and later, is now cached at runtime and is
164       only evaluated once using a single vswhere invocation for all msvc versions.
165       Previously, the vswhere executable was invoked for each supported msvc version.
166     - The vswhere executable locations for the WinGet and Scoop package managers were
167       added to the default vswhere executable search list after the Chocolatey
168       installation location.
169     - Fix issue #4543: add support for msvc toolset versions 14.4X installed as the
170       latest msvc toolset versions for msvc buildtools v143.  The v143 msvc buildtools
171       may contain msvc toolset versions from 14.30 to 14.4X.
173   From Thaddeus Crews:
174     - GetSConsVersion() to grab the latest SCons version without needing to
175       access SCons internals.
176     - Migrate setup.cfg logic to pyproject.toml; remove setup.cfg.
177     - Update .gitattributes to match .editorconfig; enforce eol settings.
178     - Replace black/flake8 with ruff for more efficient formatting & linting.
179     - When debugging (--debug=pdb), the filename SCsub is now recognized when
180       manipulating breakpoints.
182   From Raymond Li:
183     - Fix issue #3935: OSErrors are now no longer hidden during execution of
184       Actions. All exceptions during the execution of an Action are now
185       returned by value rather than by raising an exception, for more
186       consistent behavior.
187       NOTE: With this change, user created Actions should now catch and handle
188       expected exceptions (whereas previously many of these were silently
189       caught and suppressed by the SCons Action exection code).
191   From Ryan Carsten Schmidt:
192     - Teach ParseFlags to put a --stdlib=libname argument into CXXFLAGS.
193       If placed in CCFLAGS (the default location), it could be fed to the
194       C compiler (gcc, clang) where it is not applicable and causes a
195       warning message.
197   From Mats Wichmann:
198     - Updated Value Node docs and tests.
199     - Python 3.13 compat: re.sub deprecated count, flags as positional args,
200       caused update-release-info test to fail.
201     - Dump() with json format selected now recognizes additional compound types
202       (UserDict and UserList), which improves the detail of the display.
203       json output is also sorted, to match the default display.
204     - Python 3.13 (alpha) changes the behavior of isabs() on Windows. Adjust
205       SCons usage of in NodeInfo classes to match.  Fixes #4502, #4504.
206     - Drop duplicated __getstate__ and __setstate__ methods in AliasNodeInfo,
207       FileNodeInfo and ValueNodeInfo classes, as they are identical to the
208       ones in parent NodeInfoBase and can just be inherited.
209     - Update manpage for Tools, and for TOOL, which also gets a minor
210       tweak for how it's handled (should be more accurate in a few situations).
211     - Test framework now uses a subdirectory named "scons" below the base
212       temporary directory. This gives something invariant to tell antivirus
213       to ignore without having to exclude tmpdir itself. Fixes #4509.
214     - MSVS "live" tests of project files adjusted to look for the generated
215       executable with an exe sufffix
216     - Documentation build now properly passes through skipping the PDF
217       (and EPUB) builds of manpage and user guide; this can also be done
218       manually if directly calling doc/man/SConstruct and doc/user/SConstruct
219       by adding SKIP_PDF=1.  This should help with distro packaging of SCons,
220       which now does not need "fop" and other tools to be set up in order to
221       build pdf versions which are then ignored.
222     - Add the ability to print a Variables object for debugging purposes
223       (provides a __str__ method in the class).
224     - Mark Python 3.6 support as deprecated.
225     - Clean up Variables: more consistently call them variables (finish the
226       old change from Options) in docstrings, etc.; some typing and other
227       tweaks.  Update manpage and user guide for Variables usage.
228     - Regularize internal usage of Python version strings and drop one
229       old Python 2-only code block in a test.
230     - scons-time tests now supply a "filter" argument to tarfile.extract
231       to quiet a warning which was added in Python 3.13 beta 1.
232     - Improved the conversion of a "foreign" exception from an action
233       into BuildError by making sure our defaults get applied even in
234       corner cases. Fixes #4530.
235     - Restructured API docs build (Sphinx) so main module contents appear
236       on a given page *before* the submodule docs, not after. Also
237       tweaked the Util package doc build so it's structured more like the
238       other packages (a missed part of the transition when it was split).
239     - Updated manpage description of Command "builder" and function.
240     - Framework for scons-time tests adjusted so a path with a long username
241       Windows has squashed doesn't get re-expanded. Fixes a problem seen
242       on GitHub Windows runner which uses a name "runneradmin".
243     - SCons.Environment.is_valid_construction_var() now returns a boolean to
244       match the convention that functions beginning with "is" have yes/no
245       answers (previously returned either None or an re.match object).
246       Now matches the annotation and docstring (which were prematurely
247       updated in 4.6). All SCons usage except unit test was already fully
248       consistent with a bool.
249     - When a variable is added to a Variables object, it can now be flagged
250       as "don't perform substitution" by setting the argument subst.
251       This allows variables to contain characters which would otherwise
252       cause expansion. Fixes #4241.
253     - The test runner now recognizes the unittest module's return code of 5,
254       which means no tests were run. SCons/Script/MainTests.py currently
255       has no tests, so this particular error code is expected - should not
256       cause runtest to give up with an "unknown error code".
257     - Updated the notes about reproducible builds with SCons and the example.
258     - The Clone() method now respects the variables argument (fixes #3590)
259     - is_valid_construction_var() (not part of the public API) moved from
260       SCons.Environment to SCons.Util to avoid the chance of import loops. Variables
261       and Environment both use the routine and Environment() uses a Variables()
262       object so better to move to a safer location.
263     - Performance tweak: the __setitem__ method of an Environment, used for
264       setting construction variables, now uses the string method isidentifier
265       to validate the name (updated from microbenchmark results).
266     - AddOption and the internal add_local_option which AddOption calls now
267       recognize a "settable" keyword argument to indicate a project-added
268       option can also be modified using SetOption. Fixes #3983.
269       NOTE: If you were using ninja and using SetOption() for ninja options
270       in your SConscripts prior to loading the ninja tool, you will now
271       see an error. The fix is to move the SetOption() to after you've loaded
272       the ninja tool.
273     - ListVariable now has a separate validator, with the functionality
274       that was previously part of the converter. The main effect is to
275       allow a developer to supply a custom validator, which previously
276       could be inhibited by the converter failing before the validator
277       is reached.
278     - Regularized header (copyright, licens) at top of documentation files
279       using SPDX.
280     - Updated introductory section of manual page.
281     - Minor cleanups in tests - drop unused "% locals()" stanzas.
284 RELEASE 4.7.0 -  Sun, 17 Mar 2024 17:22:20 -0700
286   From Ataf Fazledin Ahamed:
287     - Use of NotImplemented instead of NotImplementedError for special methods
288       of _ListVariable class
290   From Joseph Brill:
291     - Fix issue #2755: the msvs tool no longer writes the OS environment SCONS_HOME
292       value into the SCons environment when the SCONS_HOME variable already exists
293       in the SCons environment.  Prior to this change, a valid user-defined SCons
294       environment value for SCONS_HOME would be overwritten with the OS environment
295       value of SCONS_HOME which could be None (i.e., undefined).
296     - Update the windows registry keys for detection of Visual Studio 2015 Express
297       ('14.0Exp'): the VS2015 registry key ('WDExpress') appears to be different
298       than the registry key ('VCExpress') for earlier Visual Studio express
299       versions.  The registry key value is relative to the installation root rather
300       than the VC folder and requires additional path components during evaluation.
301     - Fix the vs-6.0-exec.py test script: the msvs generated project is 'foo.dsp'
302       and the command-line invocation of the Visual Studio development environment
303       program was attempting to build 'test.dsp'.  The command-line invocation was
304       changed to build 'foo.dsp'.
305     - Update the msvs project generation test scripts: the msvs project execution
306       tests could produce a "false positive" test result when the test executable is
307       correctly built via the SConstruct env.Program() call and the command-line
308       invocation of the Visual Studio development environment program fails.  The
309       test passes due to the existence of the test executable from the initial
310       build.  The tests were modified to delete the test executable, object file,
311       and sconsign file prior to the command-line invocation of the VS development
312       binary.
313     - Method unlink_files was added to the TestCmd class that unlinks a list of
314       files from a specified directory.  An attempt to unlink a file is made only
315       when the file exists; otherwise, the file is ignored.
316     - Fix issue #4320: add an optional argument list string to configure's CheckFunc
317       method so that the generated function argument list matches the function's
318       prototype when including a header file.
320   From Thaddeus Crews:
321     - Explicitly wrap non-serializable values in json dump
322     - Implemented SCons.Util.sctyping as a safe means of hinting complex types. Currently
323       only implemented for `Executor` as a proof-of-concept.
325   From William Deegan:
326     - Fix sphinx config to handle SCons versions with post such as: 4.6.0.post1
328   From MichaÅ‚ Górny:
329     - Remove unnecessary dependencies on pypi packages from setup.cfg
331   From Sten Grüner:
332     - Fix of the --debug=sconscript option to return exist statements when using return
333       statement with stop flag enabled
335   From Prabhu S. Khalsa:
336     - Fix typo in user documentation (issue #4458)
338   From Andrew Morrow:
339     - The NewParallel scheduler is now the default, the `tm_v2` flag is removed,
340       and the old scheduler is opt-in under `--experimental=legacy_sched`. Additionally,
341       the new scheduler is now used for -j1 builds as well.
342     - A python interpreter with support for the `threading` package is now required,
343       and this is enforced on startup. SCons currently sets its minimum supported
344       Python to 3.6, and it was not until Python 3.7 where `threading` became
345       default supported. In practice, we expect most real world Python 3.6 deployments
346       will have `threading` support enabled, so this will not be an issue.
347     - CacheDir writes no longer happen within the taskmaster critical section,
348       and therefore can run in parallel with both other CacheDir writes and the
349       taskmaster DAG walk.
350     - The NewParallel scheduler now only adds threads as new work requiring execution
351       is discovered, up to the limit set by -j. This should reduce resource utilization
352       when the achievable parallelism in the DAG is less than the -j limit.
354   From Mats Wichmann:
355     - Add support for Python 3.13 (as of alpha 2). So far only affects
356       expected bytecodes in ActionTests.py.
357     - sconsign cleanup - remove some dead code, minor manpage tweaks.
358     - Be more cautious about encodings fetching command output on Windows.
359       Problem occurs in piped-spawn scenario, used by Configure tests.
360       Fixes #3529.
361     - Clarify/fix documentation of Scanners in User Guide and Manpage.
362       Fixes #4468.
363     - Fix bad typing in Action.py: process() and strfunction().
364     - Add Pseudo() to global functions, had been omitted. Fixes #4474.
365     - Improve handling of file data that SCons itself processes - try
366       harder to decode non-UTF-8 text. SCons.Util.to_Text now exists
367       to convert a byte stream, such as "raw" file data.  Fixes #3569, #4462.
368       The Pseudo manpage entry was updated to provide more clarity.
369     - Clarify how SCons finds the project top directory, and what that is used for.
370     - The internal routine which implements the PyPackageDir function
371       would fail with an exception if called with a module which is
372       not found.  It will now return None.  Updated manpage entry and
373       docstring..
374     - Doc update: standardized on the use of a new entity &MSVC; to
375       describe the Microsoft C++ compiler. Update the version table slightly.
376       Amplified the usage of MSVC_VERSION.
377     - Improve SharedLibrary docs a bit.
378     - More consistent use of &Python; in the manpage.  A few links added.
379       A warning about overwriting env['ENV'] and one about Configure
380       checks possibly not running in in no-exec mode also added.
381     - Update warnings module: adds docstrings, drop three unused warnings
382       (DeprecatedSourceCodeWarning, TaskmasterNeedsExecuteWarning,
383       DeprecatedMissingSConscriptWarning) add two warnings to manpage
384       (cache-cleanup-error, future-reserved-variable), improve unittest, tweak
385       Sphinx build.
386     - Add locking around creation of CacheDir config file. Fixes #4489.
387     - Clarify MergeFlags usage of a dict argument.
388     - SCons documentation build can now be controlled through SKIP_DOC
389       variable - rather than just true/false can now specify
390       skip none, skip all, skip pdf docs, skip api docs.
393 RELEASE 4.6.0 -  Sun, 19 Nov 2023 17:22:20 -0700
395   From Max Bachmann:
396     - Add missing directories to searched paths for mingw installs
398   From Joseph Brill:
399     - Fix issue #4312: the cached installed msvc list had an indirect dependency
400       on the target architecture in the environment dictionary.  The first call
401       to construct the installed msvc list now forces the target architecture to be
402       undefined, constructs the installed msvc list, and then restores the original
403       target architecture.
404       Note: an indirect dependency on the VSWHERE construction variable in the
405       environment remains.
406     - Fix issue #4312: explicitly guard against an empty regular expression list
407       when msvc is not installed.
408     - When trying to find a valid msvc batch file, check that the compiler executable
409       (cl.exe) exists for VS6 to VS2015 to avoid executing the msvc batch file.  Always
410       check that the compiler executable is found on the msvc script environment path
411       after running the msvc batch file.  Only use the sdk batch files when all of the
412       msvc script host/target combinations have been exhausted and a valid script was
413       not found.
414     - Add ARM64 host configurations for windows and msvc.
415       Note: VS2013 and earlier has not been tested on ARM64.
416     - If necessary, automatically define VSCMD_SKIP_SENDTELEMETRY for VS2019 and later
417       on ARM64 hosts when using an arm32 build of python to prevent a powershell dll
418       not found error pop-up window.
419     - Fix an issue where test SConfTests.py would fail when mscommon debugging
420       was enabled.  The mscommon debug filter class registered with the logging
421       module was refactored.
422     - Add arm64 to the MSVS supported architectures list for VS2017 and later to be
423       consistent with the current documentation of MSVS_ARCH.
424     - Fix an issue with an unhandled MissingConfiguration exception due to an msvc
425       registry query that returns a path that does not exist.  Multiple invocation
426       paths were not prepared to handle the MissingConfiguration exception.  The
427       MissingConfiguration exception type was removed.
428     - The MSCommon module import was changed from a relative import to a top-level
429       absolute import in the following Microsoft tools: midl, mslib, mslink, mssdk, msvc,
430       msvs. Moving any of these tools that used relative imports to the scons site tools
431       folder would fail on import (i.e., the relative import paths become invalid when
432       moved).
433     - The detection of the msvc compiler executable (cl.exe) has been modified:
434         * The host os environment path is no longer evaluated for the existence of the
435           msvc compiler executable when searching the detection dictionary.
436         * The existence of the msvc compiler executable is checked in the detection
437           dictionary and the scons ENV path before the detection dictionary is merged
438           into the scons ENV.
439         * Different warnings are produced when the msvc compiler is not detected in the
440           detection dictionary based on whether or not an msvc compiler was detected in
441           the scons ENV path (i.e., a msvc compiler executable already exists in the
442           user's ENV path prior to detection).
443         * The warning message issued when a msvc compiler executable is not found in the
444           detection dictionary was modified by adding the word "requested":
445             Old warning: "Could not find MSVC compiler 'cl'."
446             New warning: "Could not find requested MSVC compiler 'cl'.".
447         * An additonal sentence is appended to the warning message issued when an msvc
448           compiler executable is not found in the msvc detection dictionary and is found
449           in the user's ENV path prior to detection:
450             " A 'cl' was found on the scons ENV path which may be erroneous."
452   From Vitaly Cheptsov:
453     - Fix race condition in `Mkdir` which can happen when two `SConscript`
454       are processed simultaneously by two separate build commands.
456   From William Deegan:
457     - The --debug flag now has a 'json' option which will write information
458       generated by --debug={count, memory, time, action-timestamps} and about
459       the build.
460     - Obsoleted YACCVCGFILESUFFIX, being replaced by YACC_GRAPH_FILE_SUFFIX.
461       If YACC_GRAPH_FILE_SUFFIX is not set, it will respect YACCVCGFILESUFFIX.
463   From Sten Grüner
464     - The newly added --debug=sconscript option (new) will output notices when
465       entering an exiting each SConscript as they are processed.
467   From Philipp Maierhöfer:
468     - Fix gfortran tool initialization. Defaults to using binary named gfortran
469       as would be expected, and properly set's SHFORTRAN flags to include -fPIC
470       where previously it was only doing so for the other fortran versions (F77,..)
472   From Jonathon Reinhart:
473     - Fix another instance of `int main()` in CheckLib() causing failures
474       when using -Wstrict-prototypes.
476   From Mats Wichmann
477     - C scanner's dictifyCPPDEFINES routine did not understand the possible
478       combinations of CPPDEFINES - not aware of a "name=value" string either
479       embedded in a sequence, or by itself.  The conditional C scanner thus
480       did not always properly apply the defines. The regular C scanner does
481       not use these, so was not affected.  [fixes #4193]
482     - Minor cleanup for ValidateOptions - docs and docstring tweaked,
483       add missed versionadded indicator.
484     - Added some typing annotations generated by a tool, to eliminate manual
485       work in future on things which are safe for the tool to produce.
486       Then manually fixed up some things related to bool that the tool did
487       not handly ideally. For example, simple functions which just did
488       "return 1" were interpreted by the tool as returning int, when bool
489       was really the intent.  Functions/methods named like "is_*", "has_*",
490       "exists" are now pretty consistently marked as "-> bool".
491     - Simplify some code due to pylint observation: "C2801: Unnecessarily
492       calls dunder method __call__. Invoke instance directly."
493     - Python 3.9 dropped the alias base64.decodestring, deprecated since 3.1.
494       Only used in msvs.py. Use base64.decodebytes instead.
495     - When debugging (--debug=pdb), the filenames SConstruct and SConscript
496       are now recognized when manipulating breakpoints. Previously,
497       only a full pathname to an sconscript file worked, as pdb requires
498       a .py extension to open a file that is not an absolute path.
499     - SCons test runner now uses pathlib to normalize and compare paths
500       to test files.
501     - D compilers : added support for generation of .di interface files.
502       New variables DI_FILE_DIR, DI_FILE_DIR_PREFIX, DI_FILE_DIR_SUFFIX,
503       DI_FILE_SUFFIX.
504     - Fixed: when using the mingw tool, if an msys2 Python is used (os.sep
505       is '/' rather than the Windows default '\'), certain Configure checks
506       could fail due to the construction of the path to run the compiled check.
507     - Added effort to find mingw if it comes from Chocolatey install of msys2.
508     - Minor doc fixes: signature of Alias() now matches implementation
509       to avoid problem if kwargs used; case of Alias with no targets is
510       mentioned in text (was already shown in example); now mention that
511       Action([item]) does not return a ListAction - previously implied
512       that if arg was a list, a ListAction was *always* returned; mention
513       default Decider and sort the names of available decider functions,
514       and add a version marking.  Minor fiddling with Alias.py docstrings.
515     - Python 3.12 support: new bytecodes for ActionTests.py, adapt to
516       changes to pathlib module in runtest.py (PosixPath no longer
517       converts slashes if given a Windows-style path). Also switch to
518       using `subTest` in `ActionTests`, so that we can see all 21 fails
519       due to bytecode changes (previously testcases aborted on the first
520       assert fail so we only saw seven), and use unittest asserts to
521       simplify complex printing stanzas.
522     - Added copyright headers to files in test/ that didn't have them.
523     - Drop three unused methods from the Environment Base class:
524       get_src_sig_type and get_tgt_sig_type, as well as "private"
525       _changed_source. These were orphaned when the long-deprecated
526       Source Signatures and Target Signatures were removed, these were
527       missed at that time.
528     - Remove dead code: some mocked classes in unit tests had methods
529       which have been removed from the Node class they're mocking,
530       there's no need to shadow those any more as there are no callers.
531       The methods are depends_on (base functionality removed in 2005)
532       and is_pseudeo_derived (base functionality removed in 2006). There
533       may well be more!
534     - Added pass_test() call to test/MSVC/MSVC_BATCH-spaces-targetdir.py.
535       It looked it was missing a more detailed check, but it should be
536       sufficient just to check the build worked. Renamed the fixture
537       dir to follow naming convention in test/MSVC overall, and added
538       a sconstest.skip file, also to follow convention.
539     - Marked some scanner methods as @staticmethod.
540     - Class ActionBase is now an abstract base class to more accurately
541       reflect its usage. Derived _ActionAction inherits the ABC, so it
542       now declares (actually raises NotImplementedError) two methods it
543       doesn't use so it can be instantiated by unittests and others.
544     - The yacc tool now understands the bison behavior of --header,
545       --defines and --graph being called without option-argument as being
546       synonyms for -d (first two) and -g. -H also recognized as a synonym
547       for -d.  Default value for $YACC_GRAPH_FILE_SUFFIX changed to '.gv'
548       to match current bison default (since bison 3.8).  Set this variable
549       to '.dot' if using byacc. The graph file name (-g) is now generated
550       relative to the requested target file name, not to the source file
551       name, to match actual current behavior (only affects if target
552       explicitly requested with a different base name
553       than source).  Docs updated.  Fixes #4326 and #4327.
554     - Cleaned up dblite module (checker warnings, etc.).
555     - Some cleanup in the FortranCommon tool.
556     - Rewrite the internal _subproc routine - a new scons_subproc_run() now
557       makes use of Python's subprocess.run in a more natural way, getting
558       around some of the issues with attempted context manager use, fetching
559       output, etc. - we let the subprocess module do the hard work,
560       since it's well debugged and supported.  _subproc is no longer
561       called by internal code, but remains in place in case there are builds
562       which call to it (even though it was never "published API").
563     - Changed the message about scons -H to clarify it shows built-in options.
564     - Improve CacheDir() Documentation.
565     - Release-building setup tweaked. (most of) the targets listed in
566       SCons' own "scons --help" now work again.
567     - Fix platform unit test on Windows for Py 3.12+. Fixes #4376.
568     - More tweaking of test framework overview (which is duplicated onto
569       the website, but not in the regular documentation section).
570     - Extend range of recognized Java versions to 20.
571     - Builder calls now accept PathLike objects in source lists. Fixes #4398.
572     - The Help() function now takes an additional keyword argument
573       keep_local: when starting to build a help message, you can now
574       retain help from AddOption calls, but omit help for SCons' own
575       command-line options with "Help(newtext, append=True, local_only=True)".
576     - A little more code "modernization", done via "pypgrade" tool set
577       to "3.6 and above" setting.
578     - Finish the change to make calling SConscript() with a nonexistent
579       file an error. It has issued a warning since 3.0, with "warn instead
580       of fail" deprecated since 3.1.  Fixes #3958.
581     - Minor (non-functional) cleanup of some tests, particuarly test/MSVC.
582     - Added more error handling while reading msvc config cache.
583       (Enabled/specified by SCONS_CACHE_MSVC_CONFIG).
584       The existing cache will be discarded if there's a decode error reading it.
585       It's possible there's a race condition creating this issue in certain CI
586       builds.  Also add a simple filesystem-based locking protocol to try to
587       avoid the problem occuring.
588     - Update the first two chapters on building with SCons in the User Guide.
589     - Update docs on Export/Import - make sure mutable/immutable status has
590       been mentioned.
591     - Some cleanup to the Util package, including renaming SCons.Util.types
592       to SCons.Util.sctypes to avoid any possible confusion with the
593       Python stdlib types module.
594     - TeX tests: skip tests that use makeindex or epstopdf not installed, or
595       if `kpsewhich glossaries.sty` fails.
596     - Added a .note.GNU-stack section to the test assembler files to
597       avoid the GNU linker issuing warnings for its absence.
598     - Eliminate more http: references (mostly in comments/docstrings where
599       they really weren't harmful). A few links labeled dead with no alt.
600     - Add JDK 21 LTS support
601     - Add a LIBLITERALPREFIX variable which can be set to the linker's
602       prefix for considering a library argument unmodified (e.g. for the
603       GNU linker, the ':' in '-l:libfoo.a'). Fixes Github issue #3951.
604     - Update PCH builder docs with some usage notes.
606 RELEASE 4.5.2 -  Sun, 21 Mar 2023 14:08:29 -0700
608   From MichaÅ‚ Górny:
609     - Remove the redundant `wheel` dependency from `pyproject.toml`,
610       as it is added automatically by the setuptools PEP517 backend.
612   From Mats Wichmann
613     -  Fix a problem (#4321) in 4.5.0/4.5.1 where ParseConfig could cause an
614        exception in MergeFlags when the result would be to add preprocessor
615        defines to existing CPPDEFINES. The following code illustrates the
616        circumstances that could trigger this:
617           env=Environment(CPPDEFINES=['a'])
618           env.Append(CPPDEFINES=['b'])
619           env.MergeFlags({'CPPDEFINES': 'c'})
622 RELEASE 4.5.1 -  Mon, 06 Mar 2023 14:08:29 -0700
624   From Mats Wichmann
625     - Fix a problem in 4.5.0 where using something like the following code
626       will cause a Clone()'d environment to share the CPPDEFINES with the
627       original Environment() which was cloned. Causing leakage of changes
628       to CPPDEFINES when they should be completely independent after the Clone.
629           env=Environment(CPPDEFINES=['a'])
630           env.Append(CPPDEFINES=['b']) (or AppendUnique,Prepend,PrependUnique)
631           env1=env.Clone()
632           env1.Append(CPPDEFINES=['c']) (or any other modification, but not overwriting CPPDEFINES
633       Now env['CPPDEFINES'] will contain 'c' when it should not.
636 RELEASE 4.5.0 -  Sun, 05 Mar 2023 14:08:29 -0700
638   From Anatoli Babenia:
639     - Do not initialize DefaultEnvironment when calling EnsureSConsVersion(),
640       EnsurePythonVersion(), Exit(), GetLaunchDir() and SConscriptChdir().
641     - Remove unused private method SConsEnvironment._exceeds_version().
643   From William Deegan:
644     - Added ValidateOptions() which will check that all command line options are in either
645       those specified by SCons itself, or by AddOption() in SConstruct/SConscript.  It should
646       not be called until all AddOption() calls are completed. Resolves Issue #4187
647     - Refactored SCons/Taskmaster into a package. Moved SCons/Jobs.py into that package.
648       NOTE: If you hook into SCons.Jobs, you'll have to change that to use SCons.Taskmaster.Jobs
649     - Changed the Taskmaster trace logic to use python's logging module. The output formatting
650       should remain (mostly) the same. Minor update to unittest for this to adjust for 1 less newline.
651     - Migrated logging logic for --taskmastertrace to use Python's logging module. Added logging
652       to NewParallel Job class (Andrew Morrow's new parallel job implementation)
653     - Ninja: Fix execution environment sanitation for launching ninja. Previously if you set an
654       execution environment variable set to a python list it would crash. Now it
655       will create a string joining the list with os.pathsep
656     - Move execution environment sanitation from Action._subproc() to
657       SCons.Util.sanitize_shell_env(ENV)
658     - Moved rpm and debian directories under packaging
659     - Added logic to help packagers enable reproducible builds into packaging/etc/. Please
660       read packaging/etc/README.txt if you are interested.
661     - Added --experimental=tm_v2, which enables Andrew Morrow's new NewParallel Job implementation.
662       This should scale much better for highly parallel builds. You can also enable this via SetOption().
663     - Fixed command line argument --diskcheck: previously a value of 'none' was ignored.
664       SetOption('diskcheck','none') is unaffected, as it did not have the problem.
665     - Added overrides argument to SCons.Subst.scons_subst(), subst_list(), subst(), and Action's process(),
666       strfunction(). This allows passing a dictionary of envvars to override when evaluating subst()'d strings/lists
667     - Fixed Issue #4275 - when outputting compilation db and TEMPFILE was in use, the compilation db would have
668       command lines using the generated tempfile for long command lines, instead of the full command line for
669       the compilation step for the source/target pair.
670     - Renamed the qt tools to qt3 since the logic in that tool is only for QT version 3.  Renamed all env vars
671       which affect qt3 from QT_ to QT3_.  If you are still using SCons to build QT 3 code, you'll need to update
672       your SConscripts.  Note that using 'qt' tool has been deprecated for some time.
674   From David H:
675     - Added JAVAPROCESSORPATH construction variable which populates -processorpath.
676     - Updated JavaScanner to scan JAVAPROCESSORPATH.
678   From Nickolai Korshunov
679     - Added FILE_ENCODING, to allow explicitly setting the text encoding for files
680       written by the Textfile() and Substfile() builders. If not specified, Textfile() and Substfile() builders
681       will write files as UTF-8. Fixed Issue #4302.
683   From Dan Mezhiborsky:
684     - Add newline to end of compilation db (compile_commands.json).
686   From Daniel Moody:
687     - Added error message to handle the case when SCons attempts to retrieve all the targets
688       for a specified builder from the CacheDir, fails to do so, and then runs into an error
689       when deleting the files which were retrieved. Previously if this happened there was no
690       errors or warnings.
691     - Fix issue #2757, where Configure checks that perform a check which reads a modified source
692       (including program, source or header file(s)) would incorrectly mark that file "up to date" so the
693       actual build would not see the file as modified. Leading to incorrect incremental builds.
694       Now configure checks now clear node info for non conftest nodes, so they will be re-evaluated for
695       the real taskmaster run when the build commences.
697   From Andrew Morrow
698     - Avoid returning UniqueList for `children` and other `Executor` APIs. This type
699       iterates more slowly than the builtin types. Also simplify uniquer_hashables to
700       use an faster implementation under the assumption of ordered dictionaries.
702   From Ryan Saunders:
703     - Fixed runtest.py failure on Windows caused by excessive escaping of the path to python.exe.
705   From Lukas Schrangl:
706     - Run LaTeX after biber/bibtex only if necessary
708   From Flaviu Tamas:
709     - Added -fsanitize support to ParseFlags().  This will propagate to CCFLAGS and LINKFLAGS.
711   From Mats Wichmann:
712     - A list argument as the source to the Copy() action function is now
713       correctly handled by converting elements to string. Copy errors out
714       if asked to copy a list to an existing non-directory destination.
715       Both the implementation and the strfunction which prints the progress
716       message were adjusted. Fixes #3009.
717     - doc: EnsureSConsVersion, EnsurePythonVersion, Exit, GetLaunchDir and
718       SConscriptChdir are now listed as Global functions only; the
719       Environment versions still work but are not documented.
720     - The Java scanner processing of JAVACLASSPATH for dependencies was
721       changed to split on os.pathsep instead of space, to match usage of
722       passing a path string like "xxx:yyy:zzz". This is not portable -
723       passing a POSIX-style path string (with ':') won't work on Windows
724       (';') - which is now documented with a hint to use a list instead
725       to be portable. Splitting on space broke paths with embedded spaces.
726       Fixes #4243.
727     - Cleanup: make sure BoolVariable usage in tests and examples uses Python
728       boolean values instead of 0/1.
729     - Stop telling people to run "python setup.py install" in the User Guide.
730       Adds new content on using virtualenvs to be able to have multiple
731       different SCons versions available on one system.
732     - Added the "DefaultEnvironment(tools=[])" stanza to a number of tests
733       that are known to be particularly slow.  It's still just a tiny
734       speedup, but the Windows CI had been occasionally timing out,
735       so maybe this helps a bit.
736     - Remove an extra existence check in one ninja test that caused it
737       to be skipped on some otherwise-valid Windows installations.
738     - test framework tests now pass on Linux and Windows (the latter can
739       still run into problems on some configurations), and automated
740       tests are now run on changes in this area so future problems can
741       be spotted.
742     - The single-file Util module was split into a package with a few
743       functional areas getting their own files - Util.py had grown to
744       over 2100 lines.
745     - Add a zipapp package of scons-local: can use SCons from a local
746       file which does not need unpacking.
747     - Additional explanations for MSVSProject and MSVSSolution builders.
748     - Fix a problem (present in 4.4.0 only) where a Java inner class could
749       not be cached because the emitted filename contained a '$' and when
750       looked up through a node ended up generating a Python SyntaxError
751       because it was passed through scons_subst().
752     - Have the gfortran tool do a better job of honoring user preferences
753       for the dialect tools (F77, F90, F03 and F09, as well as the shared-library
754       equivalents SHF77,  SHF90, SHF03, SHF09). Previously these were
755       unconditionally overwritten to 'gfortran'; the change should be more
756       in line with expectations of how these variables should work.
757       Also cleaned a few Fortran tests - test behavior does not change.
758     - Updated MSVC documentation - adds "version added" annotations on recently
759       added construction variables and provides a version-mapping table.
760     - Add Python 3.12 support, and indicate 3.11/3.12 support in package.
761       3.12 is in alpha for this SCons release, the bytecode sequences
762       embedded in SCons/ActionTests.py may need to change later, but
763       based on what is known now, 3.12 itself should work with this release.
764     - Add "append" keyword argument to Configure context's CheckLib and
765       CheckLibWithHeader to control whether to append or prepend (issue #2767)
766       Also added "unique" keyword, to control whether a library is added
767       or not if it is already in the $LIBS construction var in the
768       configure context. (issue #2768).
769     - Completely refactored the CPPDEFINES logic in Append/AppendUnique/Prepend/PrependUnique
770       This change fixes the following GH Issues:
771       - GH Issue #3876 - Append() and AppendUnique() will handle CPPDEFINES the same
772       - GH Issue #4254 - Make handling tuples in CPPDEFINES consistent.
773       - We no longer sort the keys added to CPPDEFINES by their dictionary keys.
774         We take advantage that their order is now stable based on insertion order
775         in Python 3.5+
776       - Added/modifed unit and system tests to verify these changes.
779 RELEASE 4.4.0 -  Sat, 30 Jul 2022 14:08:29 -0700
781   From Joseph Brill:
782     - Verify that a user specified msvc script (via MSVC_USE_SCRIPT) exists and raise an exception
783       when the user specified msvc script does not exist.
784     - Fix issue where if you only had mingw installed on a Windows system and no MSVC compiler, and
785       did not explicitly request the mingw tool, mingw tool initialization would fail and set the
786       default compiler to MSVC which wasn't installed, yielding broken build.
787       Updated mingw tool so that the generate and exists methods use the same mingw search paths
788       (issue #4134).
789     - Update the debug output written to stdout for MSVC initialization which is enabled by setting
790       SCONS_MSCOMMON_DEBUG=- to use the logging module. Also changed the debug output format
791       written to stdout to include more information about the source for each message of MSVC
792       initialization debugging output.  A single space was added before the message for all
793       debugging output records written to stdout and to files.
794     - Refactor the data definitions for msvc configurations to allow derived data structures to be
795       constructed during initialization that removes the need for special case handling during
796       runtime execution. Special case handling of host/target combinations is eliminated and
797       replaced with pre-computed search lists that implicitly handle the differences between full
798       versions and express versions of msvc. This fixes an issue where Express versions of the MSVC
799       compiler were not detected due to differences in initial msvc detection and msvc batch file
800       determination when configuring the build environment.  This could lead to build failures when
801       only an MSVC Express instance is installed and the MSVC version is not explicitly specified
802       (issue #2668 and issue #2697).
803     - Added MSVC_USE_SETTINGS construction variable to pass a dictionary to configure the msvc compiler
804       system environment as an alternative to bypassing Visual Studio autodetection entirely.
805     - Added MSVC_SDK_VERSION construction variable which allows building with a specific Microsoft
806       SDK version. This variable is used with the msvc batch file determined via autodetection subject
807       to validation constraints.  Refer to the documentation for additional requirements and validation
808       details.
809     - Added MSVC_TOOLSET_VERSION construction variable which allows building with a specific toolset
810       version. This variable is used with the msvc batch file determined via autodetection subject to
811       validation constraints. This variable does not affect the autodetection and selection of msvc
812       instances. The toolset version is applied after an msvc instance is selected. This could be the
813       default version of msvc. Refer to the documentation for additional requirements and validation
814       details.  Addresses issue #3265, issue #3664, and pull request #4149.
815     - Added MSVC_SPECTRE_LIBS construction variable which allows building with spectre-mitigated
816       Visual C++ libraries. This variable is used with the msvc batch file determined via autodetection
817       subject to validation constraints. Refer to the documentation for additional requirements and
818       validation details.
819     - Added MSVC_SCRIPT_ARGS construction variable which specifies command line arguments that are
820       passed to the msvc batch file determined via autodetection subject to validation constraints.
821       Refer to the documentation for additional requirements and validation details.  Addresses
822       enhancement issue #4106.
823     - An exception is raised when MSVC_UWP_APP is enabled for Visual Studio 2013 and earlier.
824       Previous behavior was to silently ignore MSVC_UWP_APP when enabled for Visual Studio 2013
825       and earlier. Refer to the documentation for additional requirements and validation details.
826       MSVC_UWP_APP was extended to accept True, False, and None in addition to '1' and '0'.
827     - The imported system environment variable names for MSVC 7.0 and 6.0 have been changed to the
828       names set by their respective installers.  Prior to this change, bypassing MSVC detection by
829       specifying the MSVC 7.0 batch file directly would fail due to using an erroneous environment
830       variable name.  Arguments are no longer passed to the MSVC 6.0 to 7.1 batch files as no
831       arguments are required and could improve the effectiveness of the internal MSVC cache.
832     - Propagate the OS and windir environment variables from the system environment to the msvc
833       environment.  The OS and windir environment variables are used in the MSVC 6.0 batch file
834       and the SDK 6.0-7.1 SetEnv.cmd batch files.  Inclusion of the OS and windir environment
835       variables eliminates some partial paths and warnings generated by the MSVC 6.0 and SDK
836       6.0-7.1 batch files when the variables are not defined.
837       Note: Attempting to run the SDK 6.0-7.1 batch files directly via MSVC_USE_SCRIPT can lead to
838             build failures and/or incomplete build environments.  The SDK 6.0-7.1 batch files
839             require delayed expansion to be enabled which is currently not supported and is
840             typically not enabled by default on the host system. The batch files may also require
841             environment variables that are not included by default in the msvc environment.
842     - Suppress issuing a warning when there are no installed Visual Studio instances for the default
843       tools configuration (issue #2813).  When msvc is the default compiler because there are no
844       compilers installed, a build may fail due to the cl.exe command not being recognized.  At
845       present, there is no easy way to detect during msvc initialization if the default environment
846       will be used later to build a program and/or library. There is no error/warning issued for the
847       default tools as there are legitimate SCons uses that do not require a c compiler.
848     - Added a global policy setting and an environment construction variable for specifying the
849       action to be taken when an msvc request cannot be satisfied. The available options are "error",
850       "exception", "warning", "warn", "ignore", and "suppress".  The global policy variable may be
851       set and retrieved via the functions msvc_set_notfound_policy and msvc_get_notfound_policy,
852       respectively.  These two methods may be imported from SCons.Tool.MSCommon. The environment
853       construction variable is MSVC_NOTFOUND_POLICY.  When defined, the environment construction
854       variable overrides the global policy setting for a given environment. When the active policy
855       is "error" or "exception", an MSVCVersionNotFound exception is raised.  When the active policy
856       is "warning" or "warn", a VisualCMissingWarning warning is issued and the constructed
857       environment is likely incomplete. When the active policy is "ignore" or "suppress", no action
858       is taken and the constructed environment is likely incomplete.  As implemented, the default
859       global policy is "warning".  The ability to set the global policy via an SCons command-line
860       option may be added in a future enhancement.
861     - Added a global policy setting and an environment construction variable for specifying the
862       action to be taken when msvc script errors are detected. The available options are "error",
863       "exception", "warning", "warn", "ignore", and "suppress".  The global policy variable may be
864       set and retrieved via the functions msvc_set_scripterror_policy and msvc_get_scripterror_policy,
865       respectively.  These two methods may be imported from SCons.Tool.MSCommon. The environment
866       construction variable is MSVC_SCRIPTERROR_POLICY.  When defined, the environment construction
867       variable overrides the global policy setting for a given environment. When the active policy
868       is "error" or "exception", an MSVCScriptExecutionError exception is raised when msvc batch file
869       errors are detected.  When the active policy is "warning" or "warn", an MSVCScriptExecutionWarning
870       warning is issued when msvc batch file errors are detected. When the active policy is "ignore" or
871       "suppress", msvc batch error messages are suppressed.  As implemented, the default global policy
872       is "ignore".  The ability to set the global policy via an SCons command-line option may be added
873       in a future enhancement.
874     - Added experimental function msvc_query_version_toolset to SCons.Tool.MSCommon. Given a version
875       specification, this function will return an msvc version and an msvc toolset version.  The msvc
876       toolset version may be None.  The msvc version and msvc toolset version can be used in the
877       environment construction variables MSVC_VERSION and MSVC_TOOLSET_VERSION, respectively.  The
878       version specification may be an msvc version or an msvc toolset version. This is a proxy for
879       using an msvc toolset version to select an msvc instance. This function may be removed when an
880       msvc toolset version is used during msvc instance selection.
881     - Modify the MSCommon logger configuration to be independent of the root logger. This fixes an issue
882       when multiple loggers are created and the MSCommon logger added computed fields to the root logger
883       that are not present in other logging instances.
884     - Modify the MSVC_USE_SCRIPT_ARGS test fixture to disable the msvc cache. This fixes an issue where
885       the MSVC_USE_SCRIPT_ARGS test for success relied on a debug log message that was not produced when
886       the msvc cache file exists and the test keys are already in the cache as the msvc script invocation
887       was bypassed.
889   From William Deegan:
890     - Fix check for unsupported Python version. It was broken. Also now the error message
891       will include what is the minimum supported version of Python
892     - Fix ActionTests to work with python 3.10.1 (and higher)
893     NOTE: If you build with Python 3.10.0 and then rebuild with 3.10.1 (or higher), you may
894           see unexpected rebuilds. This is due to Python internals changing which changed
895           the signature of a Python Action Function.
896     - Fix a number of Python ResourceWarnings which are issued when running SCons and/or it's tests
897       with python 3.9 (or higher)
898     - Action._subproc() can now be used as a python context manager to ensure that the
899       POpen object is properly closed.
900       (Thanks to Mats Wichmann for catching that DummyPopen needed additional logic)
901     - Added project_url for mailing lists and Discord
902     - Updated project url in steup.cfg to be https instead of http
903     - Updated setup.cfg to remove Python 3.5 and add Python 3.10
904     - Added default values for source and target arguments to _defines() function. This
905       is used to expand CPPDEFINES (and others). Previous change added those arguments
906       with no defaults, so old usage where _defines() was called without source and target
907       arguments would yield an exception. This issue was found via qt4 and qt5 tools in
908       scons-contrib https://github.com/SCons/scons-contrib/issues/45
910   From David H:
911     - Add JavaScanner to include JAVACLASSPATH as a dependency when using the Java tool.
912     - Fix incorrect Java classpath generation when a NodeList is used as part of any JAVA*PATH variables.
914   From Daniel Moody:
915     - Add cache-debug messages for push failures.
916     - Ninja: Changed generated build.ninja file to run SCons only build Actions via
917       a SCons Deamon. Added logic for starting and connecting to SCons daemon (currently
918       only used for ninja)
919     - Ninja: Fix issue where Configure files weren't being properly processed when build run
920       via ninja.
921     - Ninja: Added ninja mingw support and improved ninja CommandGeneratorAction support.
922     - Ninja: Update ninja file generation to only create response files for build commands
923       which exceed MAXLINELENGTH
924     - Ninja: Added NINJA_GENERATED_SOURCE_ALIAS_NAME which allows user to specify an
925       Alias() which the ninja tool can use to determine which files are generated sources.
926       If this is not set by the user then the ninja tool will still dynamically determine
927       which files are generated sources based on NINJA_GENERATED_SOURCE_SUFFIXES, and create
928       a phony target _ninja_generated_sources. Generated sources will be built first by
929       ninja. This is needed because ninja cannot determine which generated sources are
930       required by other build targets. Code contributed by MongoDB
931       The downstream commit is here:
932       https://github.com/mongodb/mongo/commit/2fef432fa6e7cf3fd4f22ba3b193222c2887f14f
933     - Ninja: Added special case for ninja scons daemon to work in win32 python3.6 environments.
934       This particular environment does a bad job managing popen standard file handles, so
935       some special workarounds are needed.
936     - Ninja:Added user configurable setting of ninja depfile format via NINJA_DEPFILE_PARSE_FORMAT.
937       Now setting NINJA_DEPFILE_PARSE_FORMAT to [msvc,gcc,clang] can force the ninja expected
938       format. Compiler tools will also configure the variable automatically.
939     - Ninja: Made ninja tool force the ninja file as the only target.
940     - Ninja: Improved the default targets setup and made sure there is always a default target for
941       the ninja file, which excludes targets that start and stop the daemon.
942     - Ninja: Update ninja tool so targets passed to SCons are propagated to ninja when scons
943       automatically executes ninja.
944     - Small refactor of scons daemons using a shared StateInfo class for communication
945       between the scons interactive thread and the http server thread. Added error handling
946       for scons interactive failing to startup.
947     - Ninja: Updated ninja scons daemon scripts to output errors to stderr as well as the daemon log.
948     - Ninja: Fix typo in ninja scons daemon startup which causes ConnectionRefusedError to not retry
949     - Added SHELL_ENV_GENERATORS construction variable. This variable should be set to a list
950       (or an iterable) which contains functions to be called in order
951       when constructing the execution environment (Generally this is the shell environment
952       variables). This allows the user to customize how (for example) PATH is constructed.
953       Note that these are called for every build command run by SCons. It could have considerable
954       performance impact if not used carefully.
955       to connect to the server during start up.
956     - lex: Fixed an issue with the lex tool where file arguments specified to either "--header-file="
957       or "--tables-file=" which included a space in the path to the file would be processed incorrectly
958     - Ninja: added option "--skip-ninja-regen" to enable skipping regeneration of the ninja file
959       if scons can determine the ninja file doesnot need to be regenerated, which will also
960       skip restarting the scons daemon. Note this option is could result in incorrect rebuilds
961       if scons Glob or scons generated files are used in ninja build target's command lines.
962     - Ninja: Added new alias "shutdown-ninja-scons-daemon" to allow ninja to shutdown the daemon.
963       Also added cleanup to test framework to kill ninja scons daemons and clean ip daemon logs.
964       NOTE: Test for this requires python psutil module. It will be skipped if not present.
965     - Ninja: Added command line variable NINJA_CMD_ARGS that allows to pass through ninja command line args.
966       This can also be set in your Environment().
968   From Mats Wichmann:
969     - Tweak the way default site_scons paths on Windows are expressed to
970       conform to conventions (what they actually resolve to is unchanged),
971       drop a Py2 workaround, and pick a better "system" path, old one
972       remains supported (%AllUsersProfile%\scons\site_scons vs old
973       %AllUsersProfile%\Application Data\scons\site_scons).
974     - Fix testsuite to work on Windows systems where there is no usable
975       association for running .py files directly. There are a few tests where
976       we need to do this for internal reasons, those are skipped in that case.
977       Bad association could mean some other tool took it over (Visual
978       Studio Code is known to do this), or no association at all.
979     - Updated debug code in MSVC and MSVS tools to conform to the
980       suggested "lazy interpolation" use of the Python logging module.
981       Calls now look like 'debug("template %s", text)' rather than
982       'debug("template %s" % text)' so the logging system does the
983       interpolation only when/if needed (was a pylint warning).
984     - Update Help (-H) output a bit. Drop "ignored for compat" entry.
985       Pass window size to formatter so it formats for wider displays too.
986     - runtest.py now accepts -j 0 to auto-detect number of usable
987       processors for testing threads.
988     - Fixed crash in C scanner's dictify_CPPDEFINES() function which happens if
989       AppendUnique is called on CPPPATH. (Issue #4108).
990     - The MSVC script_env_cache now contains a sanity check: if the retrieved
991       tools path does not exist, the entry is invalidated so it will
992       be recomputed, in an attempt to avoid scons failing when certain
993       compiler version bumps have taken place.  The dictionary key (uses
994       the name of a batch file and any arguments which may have been
995       passes), is now computed a bit differently: the dashes are left
996       off if there are no arguments.  The default cachefile is changed
997       to have a .json suffix, for better recognition on Windows since
998       the contents are json.
999     - As "code modernization" all of SCons now uses the current super()
1000       zero-argument syntax instead of direct calls to a parent class method
1001       or the super() two-argument syntax.
1002     - Renamed ParseFlag's internal data structure to "mapping" instead of
1003       "dict" (avoid redefining builtin)
1004     - Fix an old use-before-set bug in tex tool (issue #2888)
1005     - Fix a test harness exception returning stderr if a wait_for timed out.
1006     - ParseConfig now correctly passes the *unique* flag to a user-supplied
1007       flag-merging function.
1008     - Restore the ability of the content-timestamp decider to see that a
1009       a source which is a symlink has changed if the file-system target of
1010       that link has been modified (issue #3880)
1011     - Modernize a few tests that use now-deprecated unittest.getTestCaseNames
1012       and unittest.makeSuite - Python itself suggests the replacements.
1013     - SCons.Tool.find_program_path now takes an optional add_path argument
1014       to add a path to the execution environment if it was discovered in
1015       default_paths. Previously, the routine, called by many tool modules,
1016       never altered the execution environment, leaving it to the tools.
1017     - A new construction variable FORTRANCOMMONFLAGS is added which is
1018       applied to all Fortran dialects, in case someone needs to set some
1019       flags globally. FORTRANFLAGS looked like it was intended for that,
1020       but was not applied to other dialects, and e2e tests explicitly checked
1021       that FORTRANFLAGS did not propagate outside the FORTRAN dialect,
1022       so the conclusion is that behavior is intentional (issue #2257)
1023     - SCons programmatic importing (tool modules and platform modules)
1024       no longer uses the deprecated (since Py 3.10) importlib.load_module
1025       routine, shifting to the preferred exec_module.  Old Python 2 compatible
1026       import fallback (using the imp module) in tool module loading is dropped.
1027       Tool module loading no longer special-cases Jython, which is a dead
1028       project as far as SCons (no timeline in sight for Python 3 support).
1029     - Improvements to lex and yacc tools: better documentation of
1030       extra-file options, add test for extra-file behavior.
1031       -  Two new construction variables are introduced for lex (LEX_HEADER_FILE
1032       and LEX_TABLES_FILE) as the preferred way of specifying these extra-file
1033       options.
1034       -  Two new construction variables are introduced for yacc
1035       (YACC_HEADER_FILE and YACC_GRAPH_FILE) as the preferred way of
1036       specifying these extra-file options.
1039   From Zhichang Yu:
1040     - Added MSVC_USE_SCRIPT_ARGS variable to pass arguments to MSVC_USE_SCRIPT.
1041     - Added Configure.CheckMember() checker to check if struct/class has the specified member.
1043   From Ivan Kravets, PlatformIO:
1044     - Conditional C/C++ Preprocessor: Strip shell's backslashes from the computed include (-DFOO_H=\"foo.h\")
1046 RELEASE 4.3.0 - Tue, 16 Nov 2021 18:12:46 -0700
1048   From Jacob Cassagnol:
1049     - Default hash algorithm check updated for SCons FIPS compliance. Now checks for hash viability
1050       first and then walks the tree to use the first viable hash as the default one. This typically
1051       selects SHA1 on FIPS-enabled systems less than Python 3.9 as the new default instead of MD5,
1052       unless SHA1 has also been disabled by security policy, at which point SCons selects SHA256
1053       as the default. For systems running Python 3.9 and later, the hashlib bug has been fixed,
1054       and SCons will once again default to MD5 as the preferred algorithm.
1056   From Joseph Brill:
1057     - Fix MSVS tests (vs-N.N-exec.py) for MSVS 6.0, 7.0, and 7.1 (import missing module).
1058     - Add support for Visual Studio 2022.
1060   From William Deegan:
1061     - Fix reproducible builds. Restore logic respecting SOURCE_DATE_EPOCH when set.
1062     - Fix version tests to work with updated scons --version output. (Date format changed)
1063     - Fix issue #4021.  Change the way subst() is used in Textfile() to not evaluate '$$(' -> '$',
1064       but instead it should yield '$('.
1065     - Change SCons.Platform.win32.get_architecture() to return platform.platform() when run in an
1066       environment where neither: PROCESSOR_ARCHITEW6432 nor PROCESSOR_ARCHITECTURE is set.
1067       This should fix platform tests which started failing when HOST_OS/HOST_ARCH changes
1068       introduced by Aaron Franke (listed below) were merged.
1069     - Further PCH updates. It's now recommended that env['PCH'] should always be a File node.
1070       Either via return value from env.PCH() or by explicitly using File('StdAfx.pch').
1071     - Added --no-ignore-skips to runtest.py. Changed default to ignore skips when setting
1072       runtest.py's exit status. Previously would exit 2 if any tests were skipped.
1073       Now will only exit 2 if user specifies --no-ignore-skips and some tests were skipped.
1075   From Ryan Egesdahl:
1076     - Small fix to ensure CLVar default value is an empty list.
1077       See MongoDB bug report: https://jira.mongodb.org/browse/SERVER-59656
1078       Code contributed by MongoDB.
1079     - Ninja - Fixed an issue where if you control-c and/or killed ninja while it was running scons to
1080       regenerate build.ninja you would end up with no build.ninja file and have to rerun scons from scratch.
1081       Code contributed by MongoDB.
1083   From Aaron Franke:
1084     - Define HOST_OS and HOST_ARCH in the environment for all platforms.
1085       Before this change, these were only defined for Win32 and OS/2.
1087   From Daniel Moody:
1088     - Fix ninja tool to never use for_sig substitution because ninja does not use signatures. This
1089       issue affected CommandGeneratorAction function actions specifically.
1090     - Expanded ninja Mkdir to also support Mkdir actions.
1091     - Added support for the PCH environment variable to support subst generators.
1092     - Fix command line escaping for ninja dollar sign escape. Without escaping ninja properly,
1093       the ninja file scons regenerate and callback invocations will lose the $ characters used in
1094       the scons command line which ninja uses itself for escaping. For Example:
1095           scons BUILD=xyz OTHERVAR=$BUILD
1096       Prior to this fix, it would cause ninja to fail to escape the dollar sign, leading to the
1097       single dollar sign being used as a ninja escape character in the ninja file.
1099   From Daniel Moody:
1100     - Added ninja API 'NINJA_FORCE_SCONS_BUILD' to force a node to callback to scons.
1102   From Mats Wichmann:
1103     - Two small Python 3.10 fixes: one more docstring turned into raw
1104       because it contained an escape; updated "helpful" syntax error message
1105       from 3.10 was not expected by SubstTests.py and test/Subst/Syntax.py
1106     - EmitterProxy rich comparison set is completed (checker warning).
1107       Added __le__, __gt__, __ge__.
1108     - Fix gcc/g++ tool failing if "gcc --version" returns text which fails
1109       to_String conversion (i.e., not UTF-8) - failure happens when tool
1110       initialization checks version. For gcc, the initial version string is
1111       not translated, for the rest, don't convert, just consume raw and discard.
1112     - Maintenance and doc: modernize some usage in Scanner package,
1113       calling super(), switching some imitialization to comprehensions,
1114       and code formatting.  Docstring for scanner Base moved from
1115       init-method to class-level so it's picked up by Sphinx.
1116       Added new sconsign filenames to skip_entry_list in Scanner/Dir.py
1117     - Change SCons.Scanner.Base to ScannerBase. Old name kept as an alias
1118       but is now unused in SCons itself.
1119     - Call Variables option converter consistently - the converter should
1120       have access to the env if it needs to (issue #2064).
1121     - Fixed the variables Add() method to accept a tuple for the variable
1122       name the same way AddVariables() does (issue #3869).
1123     - The premade validator PathIsDirCreate for for PathVariable now catches
1124       the case where the directory could not be created due to permission
1125       problems, allowing a more helpful error to be emitted (issue #2828)
1126     - Maintenance: Python thread.setDaemon is deprecated in favor of
1127       directly updating daemon attribute - update SCons to do this.
1128     - Make sure when subst'ing a callable, the callable is called with
1129       the correct for_signature value, previously it would be true even
1130       if doing SUBST_RAW (issue #4037)
1131     - Update Util/NodeList implementation to get rid of a workaround for
1132       early Python 3 slicing issue that is no longer a problem.
1133     - Rework some Java tests to skip rather than fail on CI systems, where
1134       the working java is > v9, but a 1.8 or 9 was also found.
1135     - Java updates: on Windows, detect more default JDK install locations.
1136       On all platforms, more Java versions (up to 17.0 now).  Add more information
1137       on version selection to docs.
1138       Update docs on JavaH tool in light of javah command dropped since 10.0.
1139       Try to be better about preserving user's passed-in JAVA* construction vars.
1140     - Start the deprecation of the qt tool, which refers to Qt3 (usupported
1141       since around 2006). There's a deprecation warning added, initially
1142       defaulting to disabled.
1144   From Brian Quistorff:
1145     - Fix crash when scons is run from a python environement where a signal
1146       is set from outside Python.
1149 RELEASE 4.2.0 - Sat, 31 Jul 2021 18:12:46 -0700
1151   From Byron Platt:
1152     - Fix Install() issue when copytree recursion gives bad arguments that can
1153       lead to install side-effects including keeping dangling symlinks and
1154       silently failing to copy directories (and their subdirectories) when the
1155       directory already exists in the target.
1157   From Joseph Brill:
1158     - Internal MSVS update: Remove unnecessary calls to find all installed versions of msvc
1159       when constructing the installed visual studios list.
1161   From William Deegan:
1162     - Improve Subst()'s logic to check for proper callable function or class's argument list.
1163       It will now allow callables with expected args, and any extra args as long as they
1164       have default arguments. Additionally functions with no defaults for extra arguments
1165       as long as they are set using functools.partial to create a new callable which set them.
1166     - Fix Issue #3035 - mingw with SHLIBVERSION set fails with either not a dll error or
1167       "Multiple ways to build the same target were specified for:".  Now mingw will disable
1168       creating the symlinks (and adding version string to ) dlls.  It sets SHLIBNOVERSIONSYMLINKS,
1169       IMPLIBNOVERSIONSYMLINKS and LDMODULENOVERSIONSYMLINKS to True.
1170     - Added --experimental flag, to enable various experimental features/tools.  You can specify
1171       'all', 'none', or any combination of available experimental features.
1172     - Fix Issue #3933 - Remove unguarded print of debug information in SharedLibrary logic when
1173       SHLIBVERSION is specified.
1174     - Fix versioned shared library naming for MacOS platform. (Previously was libxyz.dylib.1.2.3,
1175       has been fixed to libxyz.1.2.3.dylib. Additionally the sonamed symlink had the same issue,
1176       that is now resolved as well)
1177     - Add experimental ninja builder. (Contributed by MongoDB, Daniel Moody and many others).
1178     - Fix #3955 - _LIBDIRFLAGS leaving $( and $) in *COMSTR output.  Added affect_signature flag to
1179       _concat function.  If set to False, it will prepend and append $( and $). That way the various
1180       Environment variables can use that rather than "$( _concat(...) $)".
1181     - Fix issue with exparimental ninja tool which would fail on windows or when ninja package wasn't
1182       installed but --experimental=ninja was specified.
1183     - As part of experimental ninja tool, allow SetOption() to set both disable_execute_ninja and
1184       disable_ninja.
1186   From David H:
1187     - Fix Issue #3906 - `IMPLICIT_COMMAND_DEPENDENCIES` was not properly disabled when
1188       set to any string value (For example ['none','false','no','off'])
1189       Also previously 'All' wouldn't have the desired affect.
1191   From Ivan Kravets:
1192     - Provide a custom argument escape function for `TempFileMunge` using a new
1193       `TEMPFILEARGESCFUNC` variable. Useful if you need to apply extra operations on
1194       a command argument before writing to a temporary file (fix Windows slashes,
1195       normalize paths, etc.)
1197   From Henrik Maier:
1198    - DocbookXslt tool: The XSLT stylesheet file is now initialized to an env.File() Node,
1199      such that dependencies work correctly in hierarchical builds (eg when using
1200      DocbookXslt in SConscript('subdir/SConscript') context.
1202   From Daniel Moody:
1203     - Update CacheDir to use uuid for tmpfile uniqueness instead of pid.
1204       This fixes cases for shared cache where two systems write to the same
1205       cache tmpfile at the same time because the happened to get the same pid.
1206     - Added support for passing custom CacheDir derived classes to SCons. Moved
1207       copy_from_cache attribute from the Environment class to CacheDir class.
1208       Code contributed by MongoDB.
1209     - Update BuildTask to pass all targets to the progress object fixing an issue
1210       where multi-target build nodes only got the first target passed to the progress
1211       object.
1212     - Fix a potential race condition in shared cache environments where the permissions are
1213       not writeable for a moment after the file has been renamed and other builds (users) will copy
1214       it out of the cache. Small reorganization of logic to copy files from cachedir. Moved CacheDir
1215       writeable permission code for copy to cache behind the atomic rename operation.
1216     - Added marking of intermediate and and multi target nodes generated from SConf tests so that
1217       is_conftest() is more accurate.
1218     - Added test for configure check failing to ensure it didn't break generating and running ninja.
1221   From Mats Wichmann:
1222     - Initial support in tests for Python 3.10 - expected bytecode and
1223       one changed expected exception message. Change some more regexes
1224       to be specified as rawstrings in response to DeprecationWarnings.
1225     - Add an example of adding an emitter to User Guide (concept
1226       from Jeremy Elson)
1227     - Add timing information for sconsign database dump when --debug=time
1228       is selected. Also switch to generally using time.perf_counter,
1229       which is the Python recommended way for timing short durations.
1230     - Drop remaining definitions of dict-like has_key methods, since
1231       Python 3 doesn't have a dictionary has_key (maintenance)
1232     - Do not treat --site-dir=DIR and --no-site-dir as distinct options.
1233       Allows a later instance to override an earlier one.
1234     - Ignore empty cmdline arguments when computing targets (issue 2986)
1235     - Remove long-deprecated construction variables PDFCOM, WIN32_INSERT_DEF,
1236       WIN32DEFPREFIX, WIN32DEFSUFFIX, WIN32EXPPREFIX, WIN32EXPSUFFIX.
1237       All have been replaced by other names since at least 1.0.
1238     - Add a __iadd__ method to the CLVar class so that inplace adds
1239       (+=) also work as expected (issue 2399)
1240     - Remove local copy of CLVar in EnvironmentTests unittest file -
1241       should be testing against the production version, and they
1242       didn't really differ.
1243     - Don't strip spaces in INSTALLSTR by using raw subst (issue 2018)
1244     - Deprecate Python 3.5 as a supported version.
1245     - CPPDEFINES now expands construction variable references (issue 2363)
1246     - Restore behavior that Install()'d files are writable (issue 3927)
1247     - Simplified Mkdir(), the internal mkdir_func no longer needs to handle
1248       existing directories, it can now pass exist_ok=True to os.makedirs().
1249     - Avoid WhereIs exception if user set a tool name to empty (from issue 1742)
1250     - Maintenance: remove obsolete __getslice__ definitions (Py3 never calls);
1251       add Node.fs.scandir to call new (Py3.5) os.scandir; Node.fs.makedirs
1252       now passes the exist_ok flag; Cachedir creation now uses this flag.
1253     - Maintenance: remove unneeded imports and reorganize some.  Fix uses
1254       of warnings in some tools which instantiated the class but did nothing
1255       with them, need to instead call SCons.Warnings.warn with the warn class.
1256     - Drop overridden changed_since_last_build method in Value class.
1257     - Resync the SetOption implementation and the manpage, making sure new
1258       options are available and adding a notes column for misc information.
1259       SetOption equivalents to --hash-chunksize, --implicit-deps-unchanged
1260       and --implicit-deps-changed are enabled.
1261     - Add tests for SetOption failing on disallowed options and value types.
1262     - Maintenance: eliminate lots of checker complaints about Util.py.
1263     - Maintenance: fix checker-spotted issues in Environment (apply_tools)
1264       and EnvironmentTests (asserts comparing with self).
1265       For consistency, env.Tool() now returns a tool object the same way
1266       Tool() has done.
1267     - Change SConscript() missing SConscript behavior - if must_exist=False,
1268       the warning is suppressed.
1269     - Make sure TEMPFILEPREFIX can be set to an empty string (issue 3964)
1271   From Dillan Mills:
1272     - Add support for the (TARGET,SOURCE,TARGETS,SOURCES,CHANGED_TARGETS,CHANGED_SOURCES}.relpath property.
1273       This will provide a path relative to the top of the build tree (where the SConstruct is located)
1274       Fixes #396
1276   From Andrew Morrow:
1277     - Fix issue #3790: Generators in CPPDEFINES now have access to populated source
1278       and target lists
1280 RELEASE 4.1.0 - Tues, 19 Jan 2021 15:04:42 -0700
1282   From James Benton:
1283     - Add COMPILATIONDB_PATH_FILTER env option for CompilationDatabase() builder which allows
1284       filtering of entries based on the output file paths using glob style file matching (issue #3742).
1286   From Joseph Brill:
1287     - Internal MSVC and test updates: Rework the msvc installed versions cache so that it
1288       is not exposed externally and update external references accordingly.
1289     - Modify the MSCommon internal-use only debug logging records to contain the correct relative
1290       file path when the debug function is called from outside the MSCommon module.
1292   From William Deegan:
1293     - Fix yacc tool, not respecting YACC set at time of tool initialization.
1294     - Refactor SCons.Tool to move all common shared and loadable module linking logic to SCons.Tool.linkCommon
1295     - Remove pywin32 imports from SCons.Script.Main. No longer needed.
1296     - Switch to use ctypes instead of pywin32 (requiring an extra pip install) - Fixes Github Issue #2291
1297        - pywin32 no longer necessary for SCons install. (pip install SCons will no longer also require pywin32 on win32)
1298        - Remove pywin32 usage from SCons.Util where it was used for accessing the registry. Python native winreg
1299          library already includes this functionality.
1300        - Remove using pywin32 to retrieve peak memory usage on Win32 for `--debug=memory`
1301     - Fix Issue #3759 - include scons.1, sconsign.1, scons-time.1 manpages in sdist and wheel packages.
1302     - Change SCons's build so the generated `SCons/__init__.py` is no longer removed by `scons -c`
1303     - Completely rewrote versioned shared libraries logic. Added support for SOVERSION via dmoody's initial PR #3733
1304     - No longer automatically disable setting SONAME on shared libraries on OpenBSD.
1305     - Fix race condition bug when initializing a scons cache directory at the
1306       same time from multiple threads or processes. Problem described in PR #3114.
1307       This is a simpler fix which should avoid some problems identified with the initial PR.
1308       (Credit to Fredrik Medley for reporting the issue, the initial PR, and discussing and testing
1309        this solution)
1310     - Minor edits to User Guide and manpage's header with copyright, released date changed.
1312   From MichaÅ‚ Górny:
1313     - Fix dvipdf test failure due to passing incorrect flag to dvipdf.
1315   From Adam Gross:
1316     - Fix minor bug affecting SCons.Node.FS.File.get_csig()'s usage of the MD5 chunksize.
1317       User-facing behavior does not change with this fix (GH Issue #3726).
1318     - Fix occasional test failures caused by not being able to find a file or directory fixture
1319       when running multiple tests with multiple jobs.
1320     - Added support for a new command-line parameter `--hash-format` to override the default
1321       hash format that SCons uses. It can also be set via `SetOption('hash_format')`. Supported
1322       values are: `md5`, `sha1`, and `sha256`. For all hash formats other than
1323       the default of `md5`, the SConsign database will include the name of the hash format.
1324       For example, `--hash-format=sha256` will create a SConsign with name
1325       `.sconsign_sha256.dblite.`.
1326     - Fix incorrect cache hits and/or misses when running in interactive mode by having
1327       SCons.Node.Node.clear() clear out all caching-related state.
1328     - Change Environment.SideEffect() to not add duplicate side effects.
1329       NOTE: The list of returned side effect Nodes will not include any duplicate side effect Nodes.
1330     - Add support to the Python scanner for finding dynamically generated dependencies.
1331       Previously the scanner only found imports if they existed on disk at scanning time.
1333   From David H:
1334     - Add ZIP_OVERRIDE_TIMESTAMP env option to Zip builder which allows for overriding of the file
1335       modification times in the archive.
1336     - Fix Zip builder not rebuilding when ZIPROOT env option was changed.
1338   From Jason Kenny
1339     - Fix python3 crash when Value node get_text_content when child content does not have decode()
1340       NOTE: If you depend on Value node's get_text_content returning concatenated contents of it's
1341       children. This may break your code. It now concatenates the csig() of all children.
1343   From Joachim Kuebart:
1344     - Suppress missing SConscript deprecation warning if `must_exist=False`
1345       is used.
1347   From Rocco Matano:
1348     - Fix Zip tool to respect ZIPCOMSTR. Previously all zip builder calls would yield something
1349       like zip(["test.zip"], ["zip_scons.py"]) and ignore ZIPCOMSTR if ZIPCOM and ZIPCOMSTR
1350       weren't set after the Environment/Tool is initialized. (Explained in PR #3659)
1352   From Daniel Moody:
1353     - Fix issue where java parsed a class incorrectly from lambdas used after a new.
1355   From Simon Tegelid
1356     - Fix using TEMPFILE in multiple actions in an action list. Previously a builder, or command
1357       with an action list like this:
1358       ['${TEMPFILE("xxx.py -otempfile $SOURCE")}', '${TEMPFILE("yyy.py -o$TARGET tempfile")}']
1359       Could yield a single tempfile with the first TEMPFILE's contents, used by both steps
1360       in the action list.
1362   From Mats Wichmann:
1363     - Complete tests for Dictionary, env.keys() and env.values() for
1364       OverrideEnvironment. Enable env.setdefault() method, add tests.
1365     - Raise an error if an option (not otherwise consumed) is used which
1366       looks like an abbreviation of one one added by AddOption. (#3653)
1367     - Tool module not found will now raise a UserError to more clearly indicate this is
1368       probably an SConscript problem, and to make the traceback more relevant.
1369     - Fix three issues with MergeFlags:
1370       - Signature/return did not match documentation or existing usage - the implementation
1371         now no longer returns the passed env
1372       - merging --param arguments did not work (issue #3107);
1373       - passing a dict to merge where the values are strings failed (issue #2961).
1374     - Include previously-excluded SideEffect section in User Guide.
1375     - Clean up unneeded imports (autoflake tool).
1376     - Make sure cProfile is used if profiling - SCons was expecting
1377       the Util module to monkeypatch in cProfile as profile if available,
1378       but this is no longer being done.
1379     - Cleanup in SCons.Util.AddMethod. If called with an environment instance
1380       as the object to modify, the method would not be correctly set up in
1381       any Clone of that instance.  Now tries to detect this and calls
1382       MethodWrapper to set up the method the same way env.AddMethod does.
1383       MethodWrapper moved to Util to avoid a circular import. Fixes #3028.
1384     - Some Python 2 compatibility code dropped
1385     - Rework runtest.py to use argparse for arg handling (was a mix
1386       of hand-coded and optparse, with a stated intent to "gradually port").
1387     - Add options to runtest to generate/not generate a log of failed tests,
1388       and to rerun such tests. Useful when an error cascades through several
1389       tests, can quickly try if a change improves all the fails. Dropped
1390       runtest test for fallback from qmtest, not needed; added new tests.
1391     - Eliminate tex tool usage of "for foo in range(len(iterable))"
1392     - Restore internal Trace function to functional state.
1393     - Only try to initialize the wix tool by default (or when tool `default` is explicitly installed)
1394       on Windows based systems.
1395     - Pick a better "Topic" Trove classifier for SCons: SW Dev / Build Tools
1396     - Use os.replace instead of os.rename in dblite so don't need to
1397       special-case Windows here. dblite is the default storage engine for the SConsign file(s).
1398     - Fix cut-n-paste error in msvc debug printout and make some debug output
1399       in msvs and msvsTests.py be off until needed (uncomment to use)
1400     - Fix Issue #3014 - Empty file and missing file have same csig
1401     - Refactor env.Append/Prepend to remove Py 1.5 era need to nest
1402       try blocks, can now "continue" at the appropriate places.
1403     - Add /snap/bin to env['PATH'] on POSIX, although this is only
1404       really useful for a subset of POSIX systems that use snaps.
1405       Was needed for CI builds, which run on Ubuntu LTS images.
1406     - Eliminate Py2-ism __nonzero__ (now __bool__). Work around issue #3860
1407       where a check for BuilderBase raising exc. on __bool__ was optimized out.
1408       This issue was found due to a bug in Python 3.10.0a4. See issue #3860 for details.
1411 RELEASE 4.0.1 - Mon, 16 Jul 2020 16:06:40 -0700
1413   From Rob Boehne:
1414     - Fix fortran tools to set SHFORTRAN variables to $FORTRAN, similarly SHF77, SHF90, SHF95,
1415       SHF03 and SHF08 will default to the variables $F77, $F90, $F95, $F03 and $F08 respectively.
1416       If you were depending on changing the value of FORTRAN (or $F[0-9][0-9]) having no effect
1417       on the value of SHFORTRAN, this change will break that.   The values of FORTRAN, F77, F90,
1418       F95, F03, F08 and SHFORTRAN, SHF77 (etc.) now are not overridden in generate if alredy set
1419       by the user.
1420     - Fix subprocess execution of 'lslpp' on AIX to produce text standard i/o.
1421     - Re-do the fix for suncxx tool (Oracle Studio compiler) now that only Python 3 is supported,
1422       to avoid decoding errors.
1424   From William Deegan:
1425     - Added Environment() variable TEMPFILEDIR which allows setting the directory which temp
1426       files createdby TEMPFILEMUNGE are created in.
1428   From Daniel Moody:
1429     - Added method on Node to test if its node used in SConf. (Github Issue #3626)
1433 RELEASE 4.0.0 - Sat, 04 Jul 2020 12:00:27 +0000
1435   From Dirk Baechle:
1436     - Updated documentation toolchain to work properly under Python3, also
1437       removed libxslt support from the Docbook Tool. (issue #3580)
1438     - Added Docker images for building and testing SCons. (issue #3585)
1441   From James Benton:
1442     - Improve Visual Studio solution/project generation code to add support
1443       for a per-variant cppflags. Intellisense can be affected by cppflags,
1444       this is especially important when it comes to /std:c++* which specifies
1445       what C++ standard version to target. SCons will append /Zc:__cplusplus
1446       to the project's cppflags when a /std:c++* flag is found as this is
1447       required for intellisense to use the C++ standard version from cppflags.
1449   From Rob Boehne
1450     - Specify UTF-8 encoding when opening Java source file as text.  By default, encoding is the output
1451     of locale.getpreferredencoding(False), and varies by platform.
1453   From Joseph Brill:
1454     - MSVC updates: When there are multiple product installations (e.g, Community and
1455       Build Tools) of MSVC 2017 or MSVC 2019, an Enterprise, Professional,
1456       or Community installation will be selected before a Build Tools installation when
1457       "14.1" or "14.2" is requested, respectively. (GH Issue #3699).
1458     - MSVC updates: When there are multiple product installations of MSVC 2017 (e.g.,
1459       Community and Express), 2017 Express is no longer returned when "14.1" is
1460       requested.  Only 2017 Express will be returned when "14.1Exp" is requested.
1461       (GH Issue #3699).
1462     - MSVC updates: An MSVC 6.0 installation now appears in the installed versions list
1463       when msvc debug output is enabled (GH Issue #3699).
1464     - MSVS test updates: Tests for building a program using generated MSVS project and
1465       solution files using MSVS 2015 and later now work as expected on x86 hosts.
1466     - Test update: Reduce the number of "false negative" test failures for the interactive
1467       configuration test (test/interactive/configure.py).
1468     - MSVS update: Fix the development environment path for MSVS 7.0.
1470   From William Deegan:
1471     - Fix broken clang + MSVC 2019 combination by using MSVC configuration logic to
1472       propagate'VCINSTALLDIR' and 'VCToolsInstallDir' which clang tools use to locate
1473       header files and libraries from MSVC install. (Fixes GH Issue #3480)
1474     - Added C:\msys64\mingw64\bin to default mingw and clang windows PATH's.  This
1475       is a reasonable default and also aligns with changes in Appveyor's VS2019 image.
1476     - Drop support for Python 2.7. SCons will be Python 3.5+ going forward.
1477     - Change SCons.Node.ValueWithMemo to consider any name passed when memoizing Value() nodes
1478     - Fix Github Issue #3550 - When using Substfile() with a value like Z:\mongo\build\install\bin
1479       the implementation using re.sub() would end up interpreting the string and finding regex escape
1480       characters where it should have been simply replacing existing text. Switched to use string.replace().
1481     - Fix Github Issue #2904 - Provide useful error message when more than one Configure Contexts are opened.
1482       Only one open is allowed. You must call conf.Finish() to complete the currently open one before creating another
1483     - Add msys2 installed mingw default path to PATH for mingw tool.
1484       - C:\msys64\mingw64\bin
1485     - Purge obsolete internal build and tooling scripts
1486     - Allow user specified location for vswhere.exe specified by VSWHERE.
1487       NOTE: This must be set at the time the 'msvc' 'msvs' and/or 'mslink' tool(s) are initialized to have any effect.
1488     - Resolve Issue #3451 and Issue #3450 - Rewrite SCons setup.py and packaging. Move script logic to entry points so
1489       package can create scripts which use the correct version of Python.
1490     - Resolve Issue #3248 - Removing '-Wl,-Bsymbolic' from SHLIBVERSIONFLAGS
1491       NOTE: If your build depends on the above you must now add to your SHLIBVERSIONFLAGS
1492     - Speedup bin/docs-update-generated by caching parsed docbook schema. (60x speedup)
1493     - Reorganized source tree. Moved src/engine/SCons to SCons to be more in line with current Python source
1494       tree organization practices.
1495     - Renamed as.py to asm.py and left redirecting tool.  'as' is a reserved word and so
1496       changing the name was required as we wanted to import symbols for use in compilation_db
1497       tool.
1498     - Add CompilationDatabase() builder in compilation_db tool. Contributed by MongoDB.
1499       Setting COMPILATIONDB_USE_ABSPATH to True|False controls whether the files are absolute or relative
1500       paths.  Address Issue #3693 and #3694 found during development.
1501     - Fixed Github Issue 3628 - Hardcoding pickle protocol to 4 (supports python 3.4+)
1502       and skipping Python 3.8's new pickle protocol 5 whose main advantage is for out-of-band data buffers.
1503       NOTE: If you used Python 3.8 with SCons 3.0.0 or above, you may get a a pickle protocol error. Remove your
1504       .sconsign.dblite. You will end up with a full rebuild.
1506   From Andrii Doroshenko:
1507     - Extended `Environment.Dump()` to select a format to serialize construction variables (pretty, json).
1509   From Jeremy Elson:
1510     - Updated design doc to use the correct syntax for Depends()
1512   From Adam Gross:
1513     - Added support for scanning multiple entries in an action string if
1514       IMPLICIT_COMMAND_DEPENDENCIES is set to 2 or 'all'. This enables more thorough
1515       action scanning where every item in each command line is scanned to determine
1516       if it is a non-source and non-target path and added to the list of implicit dependencies
1517       for the target.
1518     - Added support for taking instances of the Value class as implicit
1519       dependencies.
1520     - Added new module SCons.Scanner.Python to allow scanning .py files.
1521     - Added support for explicitly passing a name when creating Value() nodes. This may be useful
1522       when the value can't be converted to a string or if having a name is otherwise desirable.
1523     - Fixed usage of abspath and path for RootDir objects on Windows. Previously
1524       env.fs.Dir("T:").abspath would return "T:\T:" and now it correctly returns "T:".
1526   From Ivan Kravets, PlatformIO
1527     - New conditional C Scanner (`SCons.Scanner.C.CConditionalScanner()`)
1528       which interprets C/C Preprocessor conditional syntax (#ifdef, #if, #else,
1529       #elif, #define, etc.)
1530     - Improvements for virtual C Pre-Processor:
1531       * Handle UNSIGNED LONG and LONG numeric constants in DEC (keep support for HEX)
1532       * Skip unrecognized directives, such as `#if( defined ...)`
1533       * Ignore `#include DYNAMIC_INCLUDE` directive that depends on a dynamic
1534         macro which is not located in a state TABLE.
1535       * Cleanup CPP expressions before evaluating (strip comments, carriage returns)
1537   From Iosif Kurazs:
1538     - Added a new flag called "linedraw" for the command line argument  "--tree"
1539       that instructs scons to use single line drawing characters to draw the dependency tree.
1541   From Daniel Moody:
1542     - Add no_progress (-Q) option as a set-able option. However, setting it in the
1543       SConstruct/SConscript will still cause "scons: Reading SConscript files ..." to be
1544       printed, since the option is not set when the build scripts first get read.
1545     - Added check for SONAME in environment to setup symlinks correctly (Github Issue #3246)
1546     - User callable's called during substition expansion could possibly throw a TypeError
1547       exception, however SCons was using TypeError to detect if the callable had a different
1548       signature than expected, and would silently fail to report user's exceptions. Fixed to
1549       use signature module to detect function signature instead of TypeError. (Github Issue #3654)
1550     - Added storage of SConstructs and SConscripts nodes into global set for checking
1551       if a given node is a SConstruct/SConscript.
1552       Added new node function SCons.Node.is_sconscript(self) (Github Issue #3625)
1554   From Andrew Morrow:
1555     - Fix Issue #3469 - Fixed improper reuse of temporary and compiled files by Configure when changing
1556       the order and/or number of tests.  This is done by using the hash of the generated temporary files
1557       content and (For the target files) the hash of the action.
1558       So where previously files would be named:
1559       - config_1.c, config_1.o, config_1
1560       The will now be named (For example)
1561       - conftest_68b375d16e812c43e6d72d6e93401e7c_0.c,
1562         conftest_68b375d16e812c43e6d72d6e93401e7c_0_5713f09fc605f46b2ab2f7950455f187.o
1563         or
1564         conftest_68b375d16e812c43e6d72d6e93401e7c_0.o
1565         conftest_68b375d16e812c43e6d72d6e93401e7c_0_5713f09fc605f46b2ab2f7950455f187 (for executable)
1567   From Mathew Robinson:
1568     - Improve performance of Subst by preventing unnecessary frame
1569       allocations by no longer defining the *Subber classes inside of their
1570       respective function calls.
1571     - Improve performance of Subst in some cases by preventing
1572       unnecessary calls to eval when a token is surrounded in braces
1573       but is not a function call.
1574     - Improve performance of subst by removing unnecessary recursion.
1575     - Cleanup dangling symlinks before running builders (Issue #3516)
1577   From Mats Wichmann:
1578     - Remove deprecated SourceCode
1579     - str.format syntax errors fixed
1580     - a bunch of linter/checker syntax fixups
1581     - Convert remaining uses of insecure/deprecated mktemp method.
1582     - Clean up some duplications in manpage.  Clarify portion of manpage on Dir and File nodes.
1583     - Reduce needless list conversions.
1584     - Fixed regex in Python scanner.
1585     - Accommodate VS 2017 Express - it's got a more liberal license then VS
1586       Community, so some people prefer it (from 2019, no more Express)
1587     - vswhere call should also now work even if programs aren't on the C: drive.
1588     - Add an alternate warning message if cl.exe is not found and msvc config
1589       cache is in use (SCONS_CACHE_MSVC_CONFIG was given) - config cache
1590       may be out of date.
1591     - Fixed bug where changing TEXTFILESUFFIX would cause Substfile() to rebuild. (Github Issue #3540)
1592     - Script/Main.py now uses importlib instead of imp module.
1593     - Drop some Python 2-isms.
1594     - MSVC updates: pass on VSCMD_DEBUG and VSCMD_SKIP_SENDTELEMETRY to msvc
1595       tool setup if set in environment. Add Powershell to default env
1596       (used to call telemetry script).
1597     - Microsoft Visual Studio - switch to using uuid module to generate GUIDs rather than hand rolled
1598       method using md5 directly.
1599       NOTE: This change affects the following builders' output. If your build depends on the output of these builders
1600       you will likely see a rebuild.
1601       * Package() (with PACKAGETYPE='msi')
1602       * MSVSSolution()
1603       * MSVSProject()
1604     - Docbook builder provides a fallback if lxml fails to generate
1605       a document with tostring().
1606     - Fix description of ARCOMSTR constr. var. (issue 3636). Previously the text was a copy of ASCOMSTR which
1607       has different function.
1608     - Update xml files in SCons to reflect changed relative paths after
1609       code restructuring (src/engine/SCons -> SCons)
1610     - Preliminary Python 3.9 support - elimination of some warnings.
1611     - Drop the with_metaclass jig which was designed to let class
1612       definitions using a metaclass be written the same for Py2/Py3.
1613     - Bump python_version_unsupported (and deprecated) to indicate 3.5
1614       is lowest supported Python.
1615     - ParseFlags should not modify the user's passed in dict in case it's
1616       a compound data structure (e.g. values are lists) (issue #3665)
1617     - In Py3 classes no longer need to be listed as deriving from object.
1618     - Remove deprecated check for Task subclasses needing a needs_execute
1619       method - this is now enforced via an abstract base class, so the
1620       check and test is no longer needed.
1621     - Close various logfiles (trace, cache, taskmastertrace, configure)
1622       when done using atexit calls.
1623     - Rebase forked copy of shutil.copytree to Python 3.7 stlib version.
1624     - Significant rework of documentation: API docs are now generated
1625       using Sphinx; manpage and user guide now use more "standard"
1626       markup elements (which could facilitate later conversion to a
1627       different doc format, should that choice be made); significant
1628       rewordings in manpage.  Manpage Examples moved to an external
1629       repository / website (scons-cookbook.readthedocs.io).
1630     - Clean up test harness and tests' use of subdir, file_fixture and
1631       dir_fixture.
1632     - SubstitutionEnvironment and OverrideEnvironment now have keys()
1633       and values() methods to better emulate a dict (already had items()).
1634     - Rename internal Warning base class to SConsWarning to avoid any
1635       possible confusion with Python's own Warning class.
1638 RELEASE 3.1.2 - Mon, 17 Dec 2019 02:06:27 +0000
1640   From Edoardo Bezzeccheri
1641     - Added debug option "action_timestamps" which outputs to stdout the absolute start and end time for each target.
1643   From Rob Boehne
1644     - Fix suncxx tool (Oracle Studio compiler) when using Python 3.  Previously would throw an exception.
1645       Resolved by properly handling tool version string output as unicode.
1647   From Tim Gates
1648     - Resolved a typo in engine.SCons.Tool
1650   From Adam Gross:
1651     - Resolved a race condition in multithreaded Windows builds with Python 2
1652       in the case where a child process is spawned while a Python action has a
1653       file open. Original author: Ryan Beasley.
1654     - Added memoization support for calls to Environment.Value() in order to
1655       improve performance of repeated calls.
1658   From Jason Kenny
1659     - Update Command() function to accept target_scanner, source_factory, and target_factory arguments.
1660       This makes Command act more like a one-off builder.
1662   From Ivan Kravets
1663     - Added support for "-imacros" to ParseFlags
1665   From Jacek Kuczera:
1666     - Fix CheckFunc detection code for Visual 2019. Some functions
1667       (e.g. memmove) were incorrectly recognized as not available.
1669   From Jakub Kulik
1670     - Fix stacktrace when using SCons with Python 3.5+ and SunOS/Solaris related tools.
1672   From Philipp Maierhöfer:
1673     - Avoid crash with UnicodeDecodeError on Python 3 when a Latex log file in
1674       non-UTF-8 encoding (e.g. containing umlauts in Latin-1 encoding when
1675       the fontenc package is included with \usepackage[T1]{fontenc}) is read.
1677   From Mathew Robinson:
1678     - Improved threading performance by ensuring NodeInfo is shared
1679       across threads. Results in ~13% improvement for parallel builds
1680       (-j# > 1) with many shared nodes.
1681     - Improve performance of Entry.disambiguate() by making check for
1682       most common case first, preventing unnecessary IO.
1683     - Improved DAG walk performance by reducing unnecessary work when
1684       there are no un-visited children.
1686   From Mats Wichmann
1687     - Replace instances of string find method with "in" checks where
1688       the index from find() was not used.
1689     - CmdStringHolder fix from issue #3428
1690     - Turn previously deprecated debug options into failures:
1691       --debug=tree, --debug=dtree, --debug=stree, --debug=nomemoizer.
1692     - Experimental New Feature: Enable caching MSVC configuration
1693       If SCONS_CACHE_MSVC_CONFIG shell environment variable is set,
1694       SCons will cache the results of past calls to vcvarsall.bat to
1695       a file; integrates with existing memoizing of such vars.
1696       On vs2019 saves 5+ seconds per SCons invocation, which really
1697       helps test suite runs.
1698     - Remove deprecated SourceSignatures, TargetSignatures
1699     - Remove deprecated Builder keywords: overrides and scanner
1700     - Remove deprecated env.Copy
1701     - Remove deprecated BuildDir plus SConscript keyword build_dir
1702     - A number of documentation improvements.
1705 RELEASE 3.1.1 - Mon, 07 Aug 2019 20:09:12 -0500
1707   From William Deegan:
1708     - Remove obsoleted references to DeciderNeedsNode which could cause crash when using --debug=explain
1710   From Jason Kenny
1711     - Add Fix and test for crash in 3.1.0 when using Decider('MD5-timestamp') and --debug=explain
1713   From Ben Reed:
1714     - Added -fmerge-all-constants to flags that get included in both CCFLAGS and LINKFLAGS.
1716   From Mathew Robinson:
1717     - Fix issue #3415 - Update remaining usages of EnvironmentError to SConsEnvironmentError
1718       this patch fixes issues introduced in 3.1.0 where any of the
1719       following would cause SCons to error and exit:
1720         - CacheDir not write-able
1721         - JSON encoding errors for CacheDir config
1722         - JSON decoding errors for CacheDir config
1724 RELEASE 3.1.0 - Mon, 20 Jul 2019 16:59:23 -0700
1726   From Joseph Brill:
1727     - Code to supply correct version-specifier argument to vswhere for
1728       VS version selection.
1730   From William Deegan:
1731     - Enhanced --debug=explain output. Now the separate components of the dependency list are split up
1732       as follows:
1734       scons: rebuilding `file3' because:
1735            the dependency order changed:
1736            ->Sources
1737            Old:xxx  New:zzz
1738            Old:yyy  New:yyy
1739            Old:zzz  New:xxx
1740            ->Depends
1741            ->Implicit
1742            Old:/usr/bin/python  New:/usr/bin/python
1743     - Fix Issue #3350 - SCons Exception EnvironmentError is conflicting with Python's EnvironmentError.
1744     - Fix spurious rebuilds on second build for cases where builder has > 1 target and the source file
1745       is generated. This was causing the > 1th target to not have it's implicit list cleared when the source
1746       file was actually built, leaving an implicit list similar to follows for 2nd and higher target
1747               ['/usr/bin/python', 'xxx', 'yyy', 'zzz']
1748       This was getting persisted to SConsign and on rebuild it would be corrected to be similar to this
1749               ['zzz', 'yyy', 'xxx', '/usr/bin/python']
1750       Which would trigger a rebuild because the order changed.
1751       The fix involved added logic to mark all shared targets as peers and then ensure they're implicit
1752       list is all cleared together.
1753     - Fix Issue #3349 - SCons Exception EnvironmentError is conflicting with Python's EnvironmentError.
1754       Renamed to SConsEnvironmentError
1755     - Fix Issue #3350 - mslink failing when too many objects.  This is resolved by adding TEMPFILEARGJOIN variable
1756       which specifies what character to join all the argements output into the tempfile. The default remains a space
1757       when mslink, msvc, or mslib tools are loaded they change the TEMPFILEARGJOIN to be a line separator (\r\n on win32)
1758     - Fix performance degradation for MD5-timestamp decider.  NOTE: This changes the Decider() function arguments.
1759       From:
1760           def my_decider(dependency, target, prev_ni):
1761       To:
1762           def my_decider(dependency, target, prev_ni, repo_node):
1763       Where repo_node is the repository (or other) node to use to check if the node is out of date instead of dependency.
1765   From Peter Diener:
1766     - Additional fix to issue #3135 - Also handle 'pure' and 'elemental' type bound procedures
1767     - Fix issue #3135 - Handle Fortran submodules and type bound procedures
1769   From Adam Gross:
1770     - Upgraded and improved Visual Studio solution/project generation code using the MSVSProject builder.
1771       - Added support for Visual Studio 2017 and 2019.
1772       - Added support for the following per-variant parameters to the builder:
1773         - cpppaths: Provides per-variant include paths.
1774         - cppdefines: Provides per-variant preprocessor definitions.
1776   From Michael Hartmann:
1777     - Fix handling of Visual Studio Compilers to properly reject any unknown HOST_PLATFORM or TARGET_PLATFORM
1779   From Bert Huijben:
1780     - Added support for Visual Studio 2019 toolset.
1782   From Mathew Robinson:
1783     - Update cache debug output to include cache hit rate.
1784     - No longer unintentionally hide exceptions in Action.py
1785     - Allow builders and pseudo-builders to inherit from OverrideEnvironments
1787   From Leonard de Ruijter:
1788     - Add logic to derive correct version argument to vswhere
1790   From Lukas Schrangl:
1791     - Enable LaTeX scanner to find more than one include per line
1793   From  Sergey Torokhov:
1794     - Recognize jdk on Gentoo systems.
1796   From Mats Wichmann:
1797     - scons-time takes more care closing files and uses safer mkdtemp to avoid
1798       possible races on multi-job runs.
1799     - Use importlib to dynamically load tool and platform modules instead of imp module
1800     - sconsign: default to .sconsign.dblite if no filename is specified.
1801       Be more informative in case of unsupported pickle protocol (py2 only).
1802     - Fix issue #3336 - on Windows, paths were being added to PATH even if
1803       tools were not found in those paths.
1804     - More fixes for newer Java versions (since 9): handle new jdk directory
1805       naming (jdk-X.Y instead of jdkX.Y) on Windows; handle two-digit major
1806       version. Docstrings improved.
1807     - Fixups for pylint: exception types, redefined functions,
1808       globals, etc.  Some old code removed to resolve issues (hashlib is
1809       always present on modern Pythons; no longer need the code for
1810       2.5-and-earlier optparse). cmp is not a builtin function in Py3,
1811       drop one (unused) use; replace one.  Fix another instance of
1812       renaming to SConsEnvironmentError. Trailing whitespace.
1813       Consistently use not is/in (if not x is y -> if x is not y).
1814     - Add a PY3-only function for setting up the cachedir that should be less
1815       prone to races. Add a hack to the PY2 version (from Issue #3351) to
1816       be less prone to a race in the check for old-style cache.
1817     - Fix coding error in docbook tool only exercised when using python lxml
1818     - Recognize two additional GNU compiler header directory options in
1819       ParseFlags: -iquote and -idirafter.
1820     - Fix more re patterns that contain \ but not specified as raw strings
1821       (affects scanners for D, LaTeX, swig)
1824 RELEASE 3.0.5 - Mon, 26 Mar 2019 15:04:42 -0700
1826   From William Deegan:
1828     - Fix Issue #3283 - Handle using --config=force in combination with Decider('MD5-timestamp').
1829       3.0.2 in fix for issue #2980 added that deciders can throw DeciderNeedsNode exception.
1830       The Configure logic directly calls the decider when using --config=force but wasn't handling
1831       that exception.  This would yield minimally configure tests using TryLink() not running and
1832       leaving TypeError Nonetype exception in config.log
1833     - Fix Issue #3303 - Handle --config=force overwriting the Environment passed into Configure()'s
1834       Decider and not clearing it when the configure context is completed.
1835     - Add default paths for yacc tool on windows to include cygwin, mingw, and chocolatey
1836     - Fix issue #2799 - Fix mingw tool to respect SHCCCOMSTR, SHLINKCOMSTR and LDMODULECOMSTR
1837     - Fix Issue #3329 - Add support for MS SDK V10.0A (which is commonly installed with VS2017)
1838     - Fix Issue #3333 - Add support for finding vswhere under 32 bit windows installs.
1840   From Maciej Kumorek:
1841     - Update the MSVC tool to include the nologo flag by default in RCFLAGS
1843 From Daniel Moody:
1844     - Change the default for AppendENVPath to delete_existing=0, so path
1845       order will not be changed, unless explicitly set (Issue #3276)
1846     - Fixed bug which threw error when running SCons on windows system with no MSVC installed.
1847     - Update link tool to convert target to node before accessing node member
1848     - Update mingw tool to remove MSVC like nologo CCFLAG
1849     - Add default paths for lex tool on windows to include cygwin, mingw, and chocolatey
1850     - Add lex construction variable LEXUNISTD for turning off unix headers on windows
1851     - Update lex tool to use win_flex on windows if available
1853   From Mats Wichmann:
1854     - Quiet open file ResourceWarnings on Python >= 3.6 caused by
1855       not using a context manager around Popen.stdout
1856     - Add the textfile tool to the default tool list
1857     - Fix syntax on is/is not clauses: should not use with a literal
1858     - Properly retrieve exit code when catching SystemExit
1859     - scons-time now uses context managers around file opens
1860     - Fix regex patterns that were not specified as raw strings
1862   From Bernhard M. Wiedemann:
1863     - Do not store build host+user name if reproducible builds are wanted
1866 RELEASE 3.0.4 - Mon, 20 Jan 2019 22:49:27 +0000
1868   From Mats Wichmann:
1869     - Improve finding of Microsoft compiler: add a 'products' wildcard
1870       in case 2017 Build Tools only is installed as it is considered a separate
1871       product from the default Visual Studio
1872     - Add TEMPFILESUFFIX to allow a customizable filename extension, as
1873       described in the patch attached to issue #2431.
1874     - scons.py and sconsign.py stopped working if script called as a symlink
1875       to location in scons-local location.
1876     - Fix issue running scons using a symlink to scons.py in an scons-local dir
1877     - Doc updates around Default(), and the various *TARGETS variables.
1879   From Daniel Moody:
1880     - Improved support for VC14.1 and Visual Studio 2017, as well as arm and arm64 targets.
1881       Issues #3268 & Issue #3222
1882     - Initial support for ARM targets with Visual Studio 2017 - Issue #3182 (You must set TARGET_ARCH for this to work)
1883     - Update TempFileMunge class to use PRINT_CMD_LINE_FUNC
1885   From Tobias Herzog
1886     - Enhance cpp scanner regex logic to detect if/elif expressions without whitespaces but
1887       parenthesis like "#if(defined FOO)" or "#elif!(BAR)" correctly.
1890 RELEASE 3.0.3 - Mon, 07 Jan 2019 20:05:22 -0400
1891   NOTE: 3.0.2 release was dropped because there was a packaging bug. Please consider all 3.0.2
1892         content.
1894   From William Deegan:
1895     - Fixes to packaging logic.  Ensuring the SCons.Tool.clangCommon module is added
1896       to the release packages.
1897     - Modify scons.bat script to check for scons python script without .py extension if no file
1898       scons.py exists. This enables an all platform wheel to work.
1900   From Mats Wichmann:
1901     - Update doc examples to work with Python 3.5+:  map() now returns an iterable instead of a list.
1904 RELEASE 3.0.2 - Mon, 31 Dec 2018 16:00:12 -0700
1906   From Bernard Blackham:
1907     - Fixed handling of side-effects in task master (fixes #3013).
1909   From William Deegan:
1910     - Remove long deprecated SCons.Options code and tests.  This removes BoolOption,EnumOption,
1911       ListOption,PackageOption, and PathOption which have been replaced by *Variable() many years ago.
1912     - Re-Enable parallel SCons (-j) when running via Pypy
1913     - Move SCons test framework files to testing/framework and remove all references to QMtest.
1914       QMTest has not been used by SCons for some time now.
1915     - Updated logic for mingw and clang on win32 to search default tool install paths if not
1916       found in normal SCons PATH.  If the user specifies PATH or tool specific paths they
1917       will be used and the default paths below will be ignored.
1918       - Default path for clang/clangxx : C:\Program Files\LLVM\bin
1919       - Default path for mingw         : C:\MinGW\bin and/or  C:\mingw-w64\*\mingw64\bin
1920       - Key program to locate mingw    : mingw32-make (as the gcc with mingw prefix has no fixed name)
1921     - Fixed issue causing stack trace when python Action function contains a unicode string when being
1922       run with Python 2.7
1923     - Add alternate path to QT install for Centos in qt tool: /usr/lib64/qt-3.3/bin
1924     - Fix Java tools to search reasonable default paths for Win32, Linux, macOS.  Add required paths
1925       for swig and java native interface to JAVAINCLUDES.  You should add these to your CPPPATH if you need
1926       to compile with them.  This handles spaces in paths in default Java paths on windows.
1927     - Added more java paths to match install for Centos 7 of openjdk
1928     - Fix new logic which populates JAVAINCLUDES to handle the case where javac is not found.
1929     - Fix GH Issue #2580 - # in FRAMEWORKPATH doesn't get properly expanded. The # is left in the
1930       command line.
1931     - Fix issue #2980 with credit to Piotr Bartosik (and William Blevins).  This is an issue where using
1932       TimeStamp-MD5 Decider and CacheDir can yield incorrect md5's being written into the .sconsign.
1933       The difference between Piotr Bartosik's patch and the current code is that the more complicated
1934       creation of file to csig map is only done when the count of children for the current node doesn't
1935       match the previous count which is loaded from the sconsign.
1936     - Fix issue # 3106 MSVC if using MSVC_BATCH and target dir had a space would fail due to quirk in
1937       MSVC's handling of escaped targetdirs when batch compiling.
1938     - Fix GH Issue #3141 unicode string in a TryAction() with python 2.7 crashes.
1939     - Fix GH Issue #3212 - Use of Py3 and CacheDir + Configure's TryCompile (or likely and Python Value Nodes)
1940       yielded trying to combine strings and bytes which threw exception.
1941     - Fix GH Issue #3225 SCons.Util.Flatten() doesn't handle MappingView's produced by dictionary as return
1942       values from dict().{items(), keys(), values()}.
1943     - Fix GH Issue #3241 - Properly support versioned shared libraries for MacOS.  We've also introduced two
1944       new env variables APPLELINK_CURRENT_VERSION and APPLELINK_COMPATIBILITY_VERSION which will specify
1945       what is passed to the linkers -current_version and -compatibility_version flags.  If not specified
1946       they will be derived from SHLIBVERSION as such:
1947       - APPLELINK_CURRENT_VERSION = SHLIBVERSION
1948       - APPLELINK_COMPATIBILITY_VERSION = all but the last digit in SHLIBVERSION with .0 appended.
1949       Note that the values of the above will be validated. Valid format for either APPLELINK variable is
1950       X[.Y[.Z]] where 0 <= X <= 65535, 0 <= Y <= 255, 0 <= Z <= 255.
1951       The new variables have been added to the documents and should show up in user guide and manpage.
1952     - Fix GH Issue #3136 no longer wrap io.{BufferedReader,BufferedWriter,BufferedRWPair,BufferedRandom,TextIOWrapper
1953       with logic to set HANDLE_FLAG_INHERIT flag on the file handle.  Python 3.4+ automatically sets this according
1954       to Python docs: https://docs.python.org/3/library/os.html#fd-inheritance
1956   From Ray Donnelly:
1957     - Fix the PATH created by scons.bat (and other .bat files) to provide a normalized
1958       PATH.  Some pythons in the 3.6 series are no longer able to handle paths which
1959       have ".." in them and end up crashing.  This is done by cd'ing into the directory
1960       we want to add to the path and then using %CD% to give us the normalized directory
1961       See bug filed under Python 3.6: https://bugs.python.org/issue32457.
1962       Note: On Win32 PATH's which have not been normalized may cause undefined behavior
1963       by other executables being run by SCons (or any subprocesses of executables being run by SCons).
1964       Resolving this issue should eliminate that possibility going forward.
1966   From Andrew Featherstone
1967     - Removed unused --warn options from the man page and source code.
1969   From Arda Fu
1970     - Fix cpp scanner regex logic to treat ifndef for py3.5+. Previously it was
1971       not properly differentiating between if, ifdef, and ifndef.
1973   From Philipp Maierhöfer
1974     - Added a __hash__ method to the class SCons.Subst.Literal. Required when substituting Literal
1975       objects when SCons runs with Python 3.
1976     - Added missing FORTRANMODDIRPREFIX to the gfortran tool.
1978   From Matthew Marinets:
1979     - Fixed an issue that caused the Java emitter to incorrectly parse arguments to constructors that
1980       implemented a class.
1982   From Fredrik Medley:
1983     - Fix exception when printing of EnviromentError messages.
1984       Specifically, this fixes error reporting of the race condition when
1985       initializing the cache which error previously was hidden.
1987   From Daniel Moody:
1988     - Updated Jar builder to handle nodes and directories better
1989     - Updated Jar builder to flatten source list which could contain embedded lists
1990     - Removed some magic numbers from jar.py on behalf of Mats Wichmann (mats@linux.com)
1991     - Set the pickling protocal back to highest which was causing issues
1992       with variant dir tests. This will cause issues if reading sconsigns
1993       pickled with the previous lower protocol.
1994     - Updated swig to setup default paths for windows
1995     - Updated gettext tools to setup default paths for windows with Cygwin/MinGW setups
1996     - Add common location for default paths for cygwin and mingw in Platform modules
1997     - Updated YACC tool to work on windows with Cygwin/MinGW setups
1998     - Set the pickling protocal back to highest which was causing issues
1999       with variant dir tests. This will cause issues if reading sconsigns
2000       pickled with the previous lower protocol.
2001     - Updated FS.py to handle removal of splitunc function from python 3.7
2002     - Updated the vc.py to ignore MSVS versions where no compiler could be found
2004   From Gary Oberbrunner:
2005     - Fix bug when Installing multiple subdirs outside the source tree
2006     - fix to_str to handle None without raising exception
2007     - Fix -jN for python 3.7
2009   From Jonathon Reinhart:
2010     - Replace all instances of `int main()` in C code with `int main(void)`.
2011       Specifically, this fixes the test cases use by Configure.CheckCC() which
2012       would fail when using -Wstrict-prototypes.
2014   From Zachary Tessler:
2015     - Fix calculation of signatures for FunctionActions that contain list (or set,...)
2016       comprehensions whose expressions involve constant literals. Those constants had
2017       been ignored in signatures, so changing them did not cause targets to be rebuilt.
2019   From PaweÅ‚ Tomulik:
2020     - In the testing framework, module TestCommon, fixed must_contain(),
2021       must_not_contain(), and related methods of TestCommon class to work with
2022       substrings located at zero offset.
2023     - Added virtualenv support. A new function Virtualenv() determines whether
2024       SCons runs in a virtualenv. The search PATH may also be extended to
2025       prefer executables from the current virtualenv over the ones provided by
2026       base environment. New option --enable-virtualenv provided to import some
2027       virtualenv-related variables to SCons and extend every env['ENV']['PATH']
2028       automatically. New option --ignore-virtualenv disables this. Two
2029       environment variables, SCONS_ENABLE_VIRTUALENV and
2030       SCONS_IGNORE_VIRTUALENV are supported for the same purpose.
2032   From Richard West:
2033     - Add SConstruct.py, Sconstruct.py, sconstruct.py to the search path for the root SConstruct file.
2034       Allows easier debugging within Visual Studio
2035     - Change setup.py to change the install directory (via  pip, or setup.py install) from scons-#.#.#
2036       to scons (Yielding <pythondir>/lib/scons/SCons/ instead of <pythondir>/lib/scons/SCons-#.#.#/).
2037       This changes SCons to better comply with normal Python installation practices.
2039   From Mats Wichmann:
2040     - Recognize new java 9, 10, 11 (as 9.0 and 10.0, 11.0)
2041     - Updated manpage scons.xml to fix a nested list problem
2042     - Updated doc terminiology: use prepend instead of append as appropriate
2043     - XML validity fixes from SConstruct.py change
2044     - Update wiki links to new github location
2045     - Update bug links to new github location
2046     - Make it easier for SConscript() call to fail on missing script.
2047       It was possible to call SCons.Warnings.warningAsException
2048       (not documented as a user API) to make all warnings fail. Now
2049       SConscript can take an optional must_exist flag which if true fails
2050       if the script does not exist.  Not failing on missing script is
2051       now considered deprecated, and the first instance will print a
2052       deprecation message.  It is now also possible to flip the scons
2053       behavior (which still defaults to warn, not fail) by calling
2054       SCons.Script.set_missing_sconscript_error, which is also not a
2055       documented interface at the moment.
2056     - Convert TestCmd.read to use with statement on open (quiets 17 py3 warnings)
2057     - Quiet py3 warning in UtilTests.py
2058     - Fix tests specifying octal constants for py3
2059     - Fix must_contain tests for py3
2060     - RPM package generation:
2061        - Fix supplying a build architecture
2062        - Disable auto debug package generation on certain rpmbuild versions
2063        - Adjust some tests to only supply build-id file on certain rpmbuild versions
2064        - Tests now use a file fixture for the repeated (trivial) main.c program.
2065        - Document and comment cleanup.
2066        - Added new Environment Value X_RPM_EXTRADEFS to supply custom settings
2067          to the specfile without adding specific logic for each one to scons.
2068     - The test for Python.h needed by swig tests is moved to get_python_platform
2069       so it does not have to be repeated in every test; picks up one failure
2070       which did not make the (previously needed) check. Windows version
2071       of get_python_platform needed some rework in case running in virtualenv.
2072     - If test opens os.devnull, register with atexit so file opens do not leak.
2073     - Fix bugs in Win32 process spawn logic to handle OSError exception correctly.
2074     - Use time.perf_counter instead of time.clock if it exists.
2075       time.clock deprecated since py3.3, due to remove in 3.8. deprecation
2076       warnings from py3.7 were failing a bunch of tests on Windows since they
2077       mess up expected stderr.
2078     - Prefer Py3's inspect.getfullargspec over deprecated inspect.getargspec.
2079       Switched to "new" (standard in Py2.7) usage of receiving a namedtuple -
2080       we were unpacking to a four-tuple, two of the items of which were unused;
2081       getfullargspec returns a named tuple with seven elements so it is a
2082       cleaner drop-in replacement using the namedtuple.
2083     - Updated the test-framework.rst documentation.
2084     - Remove obsoleted internal implementaiton of OrderedDict.
2085     - Test for tar packaging fixups
2086     - Stop using deprecated unittest asserts
2087     - messages in strip-install-dir test now os-neutral
2088     - Add xz compression format to packaging choices.
2089     - Syntax cleanups - trailing blanks, use "is" to compare with None, etc.
2090       Three uses of variables not defined are changed.
2091     - Some script changes in trying to find scons engine
2092     - Update (pep8) configure-cache script, add a --show option.
2093     - Fix for a couple of "what if tool not found" exceptions in framework.
2094     - Add Textfile/Substfile to default environment. (issue #3147)
2095     - sconsign: a couple of python3 fixes; be more tolerant of implicit
2096       entries which have no signatures; minor PEP8 changes.
2097     - Fix a couple of type mistakes (list-> string, filter type -> list)
2098     - Fix a couple of type mistakes in packaging tools: list-> string in msi,
2099       filter type -> list in ipk
2101   From Bernhard M. Wiedemann:
2102     - Update SCons' internal scons build logic to allow overriding build date
2103       with SOURCE_DATE_EPOCH for SCons itself.
2104     - Change the datestamps in SCons' docs and embedded in code use ISO 8601 format and UTC
2106   From Hao Wu
2107     - Typo in customized decider example in user guide
2108     - Replace usage of unittest.TestSuite with unittest.main() (fix #3113)
2110 RELEASE 3.0.1 - Mon, 12 Nov 2017 15:31:33 -0700
2112   From Daniel Moody:
2113     - Jar can take multiple targets, and will make a duplicate jar from the sources for each target
2114     - Added some warnings in case the Jar builder makes an implicit target
2115     - Added Jar method and changed jar build to be more specific. Jar method will take in
2116       directories or classes as source. Added more tests to JAR to ensure the jar was
2117       packaged with the correct compiled class files.
2118     - Added a No result test case to handle bug which seems unrelated to java in the
2119       swig-dependencies.py test, more info here: http://scons.tigris.org/issues/show_bug.cgi?id=2907
2120     - Added a travis script to test on ubuntu trusty now that the project is on github
2121       so that Continuus Integration tests can be run automatically. It tests most case and considers
2122       no result a pass as well. Improving this script can install more dependincies allowing for more
2123       tests to be run.
2125   From Daniel Moody:
2126     - Updated the Jar Builder tool in Tool/__init__.py so that is doesn't force class files as
2127       sources, allowing directories to be passed, which was causing test/Java/JAR.py to fail.
2129   From William Deegan:
2130     - Fix issue where code in utility routine to_String_for_subst() had code whose result was never
2131       properly returned.
2132       (Found by: James Rinkevich https://pairlist4.pair.net/pipermail/scons-users/2017-October/006358.html )
2133     - Fixed Variables.GenerateHelpText() to now use the sort parameter. Due to incorrect 2to3 fixer changes
2134       8 years ago it was being used as a boolean parameter.  Now you can specify sort to be a callable, or boolean
2135       value. (True = normal sort). Manpage also updated.
2136     - Fixed Tool loading logic from exploding sys.path with many site_scons/site_tools prepended on py3.
2137     - Added additional output with time to process each SConscript file when using --debug=time.
2139   From Thomas Berg:
2140     - Fixed a regression in scons-3.0.0 where "from __future__ import print_function" was imposed
2141       on the scope where SConstruct is executed, breaking existing builds using PY 2.7.
2143   From William Deegan:
2144     - Fix broken subst logic where a string with "$$(abc)" was being treated as "$(abc) and the
2145       logic for removing the signature escapes was then failing because there was no closing "$)".
2146       This was introduced by a pull request to allow recursive variable evaluations to yield a string
2147       such as "$( $( some stuff $) $)".
2149   From Zachary Tessler:
2150     - Fix incorrect warning for repeated identical builder calls that use overrides
2153 RELEASE 3.0.0 - Mon, 18 Sep 2017 08:32:04 -0700
2155 NOTE: This is a major release.  You should expect that some targets may rebuild when upgrading.
2156 Significant changes in some python action signatures. Also switching between PY 2.7 and PY 3.5, 3.6
2157 will cause rebuilds.
2160   From William Blevins:
2161     - Updated D language scanner support to latest: 2.071.1. (PR #1924)
2162       https://dlang.org/spec/module.html accessed 11 August 2016
2163       - Enhancements:
2164         - Added support for selective imports: "import A : B, C;" -> A
2165         - Added support for renamed imports. "import B = A;" -> A
2166         - Supports valid combinations: "import A, B, CCC = C, DDD = D : EEE = FFF;" -> A, B, C, D
2167       - Notes:
2168         - May find new (previously missed) Dlang dependencies.
2169         - May cause rebuild after upgrade due to dependency changes.
2170     - Updated Fortran-related tests to pass under GCC 5/6.
2171     - Fixed SCons.Tool.Packaging.rpm.package source nondeterminism across builds.
2173   From William Deegan:
2174     - Removed deprecated tools CVS, Perforce, BitKeeper, RCS, SCCS, Subversion.
2175     - Removed deprecated module SCons.Sig
2176     - Added prioritized list of xsltproc tools to docbook. The order will now be as
2177       follows: xsltproc, saxon, saxon-xslt, xalan  (with first being highest priority, first
2178       tool found is used)
2179     - Fixed MSVSProject example code (http://scons.tigris.org/issues/show_bug.cgi?id=2979)
2180     - Defined MS SDK 10.0 and Changed VS 2015 to use SDK 10.0
2181     - Changes to Action Function and Action Class signiture creation.  NOTE: This will cause rebuilds
2182       for many builds when upgrading to SCons 3.0
2183     - Fixed Bug #3027 - "Cross Compiling issue: cannot override ranlib"
2184     - Fixed Bug #3020 - "Download link in user guide wrong. python setup.py install --version-lib broken"
2185     - Fixed Bug #2486 - Added SetOption('silent',True) - Previously this value was not allowed to be set.
2186     - Fixed Bug #3040 - Non-unicode character in CHANGES.txt
2187     - Fixed Bug #2622 - AlwaysBuild + MSVC regression.
2188     - Fixed Bug #3025 - (Credit to Florian : User flow86 on tigris) - Fix typo JAVACLASSSUFIX should have been
2189                         JAVACLASSSUFFIX
2192   From Ibrahim Esmat:
2193     - Added the capability to build Windows Store Compatible libraries that can be used
2194       with Universal Windows Platform (UWP) Apps and published to the store
2196   From Daniel Holth:
2197     - Add basic support for PyPy (by deleting __slots__ from Node with a
2198       metaclass on PyPy); wrap most-used open() calls in 'with' statements to
2199       avoid too many open files.
2200     - Add __main__.py for `python -m SCons` in case it is on PYTHONPATH.
2201     - Always use highest available pickle protocol for efficiency.
2202     - Remove unused command line fallback for the zip tool.
2204   From Gaurav Juvekar:
2205     - Fix issue #2832: Expand construction variables in 'chdir' argument of builders. (PR #463)
2206     - Fix issue #2910: Make --tree=all handle Unicode. (PR #427)
2207     - Fix issue #2788: Fix typo in documentation example for sconf. (PR #388)
2209   From Alexey Klimkin:
2210     - Use memoization to optimize PATH evaluation across all dependencies per
2211       node. (PR #345)
2212     - Use set() where it is applicable (PR #344)
2214   From M. Limber:
2215     - Fixed msvs.py for Visual Studio Express editions that would report
2216       "Error  : ValueError: invalid literal for float(): 10.0Exp".
2218   From Rick Lupton:
2219     - Update LaTeX scanner to understand \import and related commands
2221   From Steve Robinson:
2222     - Add support for Visual Studio 2017.  This support requires vswhere.exe a helper
2223       tool installed with newer installs of 2017. SCons expects it to be located at
2224       "C:\Program Files (x86)\Microsoft Visual Studio\Installer\vswhere.exe"
2225       It can be downloaded separately at
2226       https://github.com/Microsoft/vswhere
2228   From Tom Tanner:
2229     - Allow nested $( ... $) sections
2231   From PaweÅ‚ Tomulik:
2232     - Fixed the issue with LDMODULEVERSIONFLAGS reported by Tim Jenness
2233       (https://pairlist4.pair.net/pipermail/scons-users/2016-May/004893.html).
2234       An error was causing "-Wl,Bsymbolic" being added to linker's command-line
2235       even when there was no specified value in LDMODULEVERSION and thus no
2236       need for the flags to be specified.
2237     - Added LoadableModule to the list of global functions (DefaultEnvironment
2238       builders).
2240   From Manish Vachharajani:
2241     - Update debian rules, compat, and control to not use features
2242       deprecated or obsolete in later versions of debhelpers
2243     - Update python version to 2.7 in debian/control
2245   From Richard Viney:
2246     - Fixed PCHPDBFLAGS causing a deprecation warning on MSVC v8 and later when
2247       using PCHs and PDBs together.
2250   From Richard West:
2251     - Added nested / namespace tool support
2252     - Added a small fix to the python3 tool loader when loading a tool as a package
2253     - Added additional documentation to the user manual on using toolpaths with the environment
2254       This includes the use of sys.path to search for tools installed via pip or package managers
2255     - Added support for a PyPackageDir function for use with the toolpath
2257   From Russel Winder:
2258     - Reordered the default D tools from "dmd, gdc, ldc" to "dmd, ldc, gdc".
2259     - Add a ProgramAllAtOnce builder to the dmd, ldc, and gdc tools. (PR #448)
2260     - Remove a file name exception for very old Fedora LDC installation.
2261     - gdc can now handle building shared objects (tested for version 6.3.0).
2262     - Remove establishing the SharedLibrary builder in the dmd, ldc, and gdc
2263       tools, must now include the ar tool to get this builder as is required for
2264       other compiler tools.
2265     - Add clang and clang++ tools based on PaweÅ‚ Tomulik's work.
2267 RELEASE 2.5.1 - Mon, 03 Nov 2016 13:37:42 -0400
2269   From William Deegan:
2270     - Add scons-configure-cache.py to packaging. It was omitted
2272   From Alexey Klimkin:
2273     - Use memoization to optimize PATH evaluation across all dependencies per
2274       node. (PR #345)
2276 RELEASE 2.5.0 - Mon, 09 Apr 2016 11:27:42 -0700
2278   From Dirk Baechle:
2279     - Removed a lot of compatibility methods and workarounds
2280       for Python versions < 2.7, in order to prepare the work
2281       towards a combined 2.7/3.x version. (PR #284)
2282       Also fixed the default arguments for the print_tree and
2283       render_tree methods. (PR #284, too)
2285   From William Blevins:
2286     - Added support for cross-language dependency scanning;
2287       SCons now respects scanner keys for implicit dependencies.
2288       - Notes for SCons users with heterogeneous systems.
2289         - May find new (previously missed) dependencies.
2290         - May cause rebuild after upgrade due to dependency changes.
2291         - May find new dependency errors (EG. cycles).
2292           - Discovered in some of the SCons QT tests.
2293     - Resolved missing cross-language dependencies for
2294       SWIG bindings (fixes #2264).
2295     - Corrected typo in User Guide for Scanner keyword. (PR #2959)
2296     - Install builder interacts with scanner found in SCANNERS differently.
2297       - Previous: Install builder recursively scanned implicit dependencies
2298         for scanners from SCANNER, but not for built-in (default) scanners.
2299       - Current: Install builder will not scan for implicit dependencies via
2300         either scanner source. This optimizes some Install builder behavior
2301         and brings orthogonality to Install builder scanning behavior.
2303   From William Deegan:
2304     - Add better messaging when two environments have
2305       different actions for the same target (Bug #2024)
2306     - Fix issue only with MSVC and Always build where targets
2307       marked AlwaysBuild wouldn't make it into CHANGED_SOURCES
2308       and thus yield an empty compile command line. (Bug #2622)
2309     - Fix posix platform escaping logic to properly handle paths
2310       with parens in them "()".  (Bug #2225)
2312   From Jakub Pola:
2313     - Intel Compiler 2016 (Linux/Mac) update for tool directories.
2315   From Adarsh Sanjeev:
2316     - Fix for issue #2494: Added string support for Chmod function.
2318   From Tom Tanner:
2319     - change cache to use 2 character subdirectories, rather than one character,
2320       so as not to give huge directories for large caches, a situation which
2321       causes issues for NFS.
2322       For existing caches, you will need to run the scons-configure-cache.py
2323       script to update them to the new format. You will get a warning every time
2324       you build until you co this.
2325     - Fix a bunch of unit tests on windows
2327 RELEASE 2.4.1 - Mon, 07 Nov 2015 10:37:21 -0700
2329   From Arfrever Frehtes Taifersar Arahesis:
2330     - Fix for Bug # 2791 - Setup.py fails unnecessarily under Jython.
2332   From Dirk Baechle:
2333     - Fixed license of SVG titlepage files in the context of Debian
2334       packaging, such that they allow for commercial use too (#2985).
2336   From William Blevins:
2337     - InstallVersionedLib now available in the DefaultEnvironment context.
2338     - Improves orthogonality of use cases between different Install functions.
2340   From Carnë Draug:
2341     - Added new configure check, CheckProg, to check for
2342       existence of a program.
2344   From Andrew Featherstone:
2345     - Fix for issue #2840 - Fix for two environments specifying same target with different
2346       actions not throwing hard error. Instead SCons was incorrectly issuing a warning
2347       and continuing.
2349   From Hiroaki Itoh :
2350     - Add support `Microsoft Visual C++ Compiler for Python 2.7'
2351       Compiler can be obtained at: https://www.microsoft.com/en-us/download/details.aspx?id=44266
2353   From Florian Miedniak:
2354     - Fixed tigris issue #3011: Glob() excludes didn't work when used with VariantDir(duplicate=0)
2356   From William Roberts:
2357     - Fix bug 2831 and allow Help() text to be appended to AddOption() help.
2359   From PaweÅ‚ Tomulik:
2360     - Reimplemented versioning for shared libraries, with the following effects
2361     - Fixed tigris issues #3001, #3006.
2362     - Fixed several other issues not reported to tigris, including:
2363       issues with versioned libraries in subdirectories with tricky names,
2364       issues with versioned libraries and variant directories,
2365       issue with soname not being injected to library when using D linkers,
2366     - Switched to direct symlinks instead of daisy-chained ones -- soname and
2367       development symlinks point directly to the versioned shared library now),
2368       for rationale see:
2369       https://www.debian.org/doc/debian-policy/ch-sharedlibs.html
2370       https://fedoraproject.org/wiki/Packaging:Guidelines#Devel_Packages
2371       https://bitbucket.org/scons/scons/pull-requests/247/new-versioned-libraries-gnulink-cyglink/diff#comment-10063929
2372     - New construction variables to allow override default behavior: SONAME,
2373       SHLIBVERSIONFLAGS, _SHLIBVERSIONFLAGS, SHLIBNOVERSIONSYMLINKS,
2374       LDMODULEVERSION, LDMODULEVERSIONFLAGS, _LDMODULEVERSIONFLAGS,
2375       LDMODULENOVERSIONSYMLINKS.
2376     - Changed logic used to configure the versioning machinery from
2377       platform-centric to linker-oriented.
2378     - The SHLIBVERSION/LDMODULEVERSION variables are no longer validated by
2379       SCons (more freedom to users).
2380     - InstallVersionedLib() doesn't use SHLIBVERSION anymore.
2381     - Enchanced docs for the library versioning stuff.
2382     - New tests for versioned libraries.
2383     - Library versioning is currently implemented for the following linker
2384       tools: 'cyglink', 'gnulink', 'sunlink'.
2385     - Fix to swig tool - pick-up 'swig', 'swig3.0' and 'swig2.0' (in order).
2386     - Fix to swig tool - respect env['SWIG'] provided by user.
2390 RELEASE 2.4.0 - Mon, 21 Sep 2015 08:56:00 -0700
2392   From Dirk Baechle:
2393     - Switched several core classes to use "slots", to
2394       reduce the overall memory consumption in large
2395       projects (fixes #2180, #2178, #2198)
2396     - Memoizer counting uses decorators now, instead of
2397       the old metaclasses approach.
2399   From Andrew Featherstone
2400     - Fixed typo in SWIGPATH description
2402 RELEASE 2.3.6 - Mon, 31 Jul 2015 14:35:03 -0700
2404   From Rob Smith:
2405     - Added support for Visual Studio 2015
2407 RELEASE 2.3.5 - Mon, 17 Jun 2015 21:07:32 -0700
2409   From Stephen Pollard:
2410     - Documentation fixes for libraries.xml and
2411       builders-writing.xml (#2989 and #2990)
2413   From William Deegan:
2414     - Extended docs for InstallVersionedLib/SharedLibrary,
2415       and added SKIP_WIN_PACKAGES argument to build script
2416       bootstrap.py (PR #230, #3002).
2418   From William Blevins:
2419     - Fixed symlink support (PR #227, #2395).
2420     - Updated debug-count test case (PR #229).
2422   From Alexey Klimkin:
2423     - Fixed incomplete LIBS flattening and substitution in
2424       Program scanner(PR #205, #2954).
2426   From Dirk Baechle:
2427     - Added new method rentry_exists_on_disk to Node.FS (PR #193).
2429   From Russel Winder:
2430     - Fixed several D tests under the different OS.
2431     - Add support for f08 file extensions for Fortran 2008 code.
2433   From Anatoly Techtonik:
2434     - Show --config choices if no argument is specified (PR #202).
2435     - Fixed build crash when XML toolchain isn't installed, and
2436       activated compression for ZIP archives.
2438   From Alexandre Feblot:
2439     - Fix for VersionedSharedLibrary under 'sunos' platform.
2440     - Fixed dll link with precompiled headers on MSVC 2012
2441     - Added an 'exclude' parameter to Glob()
2443   From Laurent Marchelli:
2444     - Support for multiple cmdargs (one per variant) in VS project files.
2445     - Various improvements for TempFileMunge class.
2446     - Added an implementation for Visual Studio users files (PR #209).
2448   From Dan Pidcock:
2449     - Added support for the 'PlatformToolset' tag in VS project files (#2978).
2451   From James McCoy:
2452     - Added support for '-isystem' to ParseFlags.
2454 RELEASE 2.3.4 - Mon, 27 Sep 2014 12:50:35 -0400
2456   From Bernhard Walle and Dirk Baechle:
2457     - Fixed the interactive mode, in connection with
2458       Configure contexts (#2971).
2460   From Anatoly Techtonik:
2461     - Fix EnsureSConsVersion warning when running packaged version
2463   From Russel Winder:
2464     - Fix D tools for building shared libraries
2466 RELEASE 2.3.3 - Sun, 24 Aug 2014 21:08:33 -0400
2468   From Roland Stark:
2469     - Fixed false line length calculation in the TempFileMunge class (#2970).
2471   From Gary Oberbrunner:
2472     - Improve SWIG detection
2474   From Russel Winder:
2475     - Fix regression on Windows in D language update
2477   From Neal Becker and Stefan Zimmermann:
2478     - Python 3 port and compatibility
2480   From Anatoly Techtonik:
2481     - Do not fail on EnsureSConsVersion when running from checkout
2483   From Kendrick Boyd and Rob Managan:
2484     - Fixed the newglossary action to work with VariantDir (LaTeX).
2486   From Manuel Francisco Naranjo:
2487     - Added a default for the BUILDERS environment variable,
2488       to prevent not defined exception on a Clone().
2490   From Andrew Featherstone:
2491     - Added description of CheckTypeSize method (#1991).
2492     - Fixed handling of CPPDEFINE var in Append()
2493       for several list-dict combinations (#2900).
2495   From William Blevins:
2496     - Added test for Java derived-source dependency tree generation.
2497     - Added Copy Action symlink soft-copy support (#2395).
2498     - Various contributions to the documentation (UserGuide).
2500 RELEASE 2.3.2
2502   From Dirk Baechle:
2503     - Update XML doc editor configuration
2504     - Fix: Allow varlist to be specified as list of strings for Actions (#2754)
2506   From veon on bitbucket:
2507     - Fixed handling of nested ifs in CPP scanner PreProcessor class.
2509   From Shane Gannon:
2510     - Support for Visual Studio 2013 (12.0)
2512   From Michael Haubenwallner:
2513     - Respect user's CC/CXX values; don't always overwrite in generate()
2514     - Delegate linker Tool.exists() to CC/CXX Tool.exists().
2516   From Rob Managan:
2517     - Updated the TeX builder to support use of the -synctex=1
2518       option and the files it creates.
2519     - Updated the TeX builder to correctly clean auxiliary files when
2520       the biblatex package is used.
2522   From Gary Oberbrunner:
2523     - get default RPM architecture more robustly when building RPMs
2525   From Amir Szekely:
2526     - Fixed NoClean() for multi-target builders (#2353).
2528   From PaweÅ‚ Tomulik:
2529     - Fix SConf tests that write output
2531   From Russel Winder:
2532     - Revamp of the D language support. Tools for DMD, GDC and LDC provided
2533       and integrated with the C and C++ linking. NOTE: This is only tested
2534       with D v2. Support for D v1 is now deprecated.
2536   From Anatoly Techtonik:
2537     - Several improvements for running scons.py from source:
2538       * engine files form source directory take priority over all other
2539         importable versions
2540       * message about scons.py running from source is removed to fix tests
2541         that were failing because of this extra line in the output
2542       * error message when SCons import fails now lists lookup paths
2543     - Remove support for QMTest harness from runtest.py
2544     - Remove RPM and m4 from default tools on Windows
2545     - BitKeeper, CVS, Perforce, RCS, SCCS are deprecated from default
2546       tools and will be removed in future SCons versions to speed up
2547       SCons initialization (it will still be possible to use these tools
2548       explicitly)
2550   From Sye van der Veen:
2551     - Support for Visual Studio 12.0Exp, and fixes for earlier MSVS
2552       versions.
2555 RELEASE 2.3.1
2557   From Andrew Featherstone:
2558     - Added support for EPUB output format to the DocBook tool.
2560   From Tom Tanner:
2561     - Stop leaking file handles to subprocesses by switching to using subprocess
2562       always.
2563     - Allow multiple options to be specified with --debug=a,b,c
2564     - Add support for a readonly cache (--cache-readonly)
2565     - Always print stats if requested
2566     - Generally try harder to print out a message on build errors
2567     - Adds a switch to warn on missing targets
2568     - Add Pseudo command to mark targets which should not exist after
2569       they are built.
2571   From Bogdan Tenea:
2572     - Check for 8.3 filenames on cygwin as well as win32 to make variant_dir work properly.
2574   From Alexandre Feblot:
2575     - Make sure SharedLibrary depends on all dependent libs (by depending on SHLINKCOM)
2577   From Stefan Sperling:
2578     - Fixed the setup of linker flags for a versioned SharedLibrary
2579       under OpenBSD (#2916).
2581   From Antonio Cavallo:
2582     - Improve error if Visual Studio bat file not found.
2584   From Manuel Francisco Naranjo:
2585     - Allow Subst.Literal string objects to be compared with each other,
2586       so they work better in AddUnique() and Remove().
2588   From David Rothenberger:
2589     - Added cyglink linker that uses Cygwin naming conventions for
2590       shared libraries and automatically generates import libraries.
2592   From Dirk Baechle:
2593     - Update bootstrap.py so it can be used from any dir, to run
2594       SCons from a source (non-installed) dir.
2595     - Count statistics of instances are now collected only when
2596       the --debug=count command-line option is used (#2922).
2597     - Added release_target_info() to File nodes, which helps to
2598       reduce memory consumption in clean builds and update runs
2599       of large projects.
2600     - Fixed the handling of long options in the command-line
2601       parsing (#2929).
2602     - Fixed misspelled variable in intelc.py (#2928).
2604   From Gary Oberbrunner:
2605     - Test harness: fail_test() can now print a message to help debugging.
2607   From Anatoly Techtonik:
2608     - Require rpmbuild when building SCons package.
2609     - Print full stack on certain errors, for debugging.
2610     - Improve documentation for Textfile builder.
2612   From William Deegan:
2613     - VS2012 & VS2010 Resolve initialization issues by adding path to reg.exe
2614       in shell used to run batch files.
2615     - MSVC Support fixed defaulting TARGET_ARCH to HOST_ARCH. It should be
2616       None if not explicitly set.
2617     - MSVC Fixed issue where if more than one Architectures compilers are
2618       detected, it would take the last one found, and not the first.
2620   From Philipp Kraus:
2621     - Added optional ZIPROOT to Zip tool.
2623   From Dirk Baechle:
2624     - Replaced old SGML-based documentation toolchain with a more modern
2625       approach, that also requires less external dependencies (programs and
2626       Python packages). Added a customized Docbook XSD for strict validation of
2627       all input XML files.
2629   From Luca Falavigna:
2630     - Fixed spelling errors in MAN pages (#2897).
2632   From Michael McDougall:
2633     - Fixed description of ignore_case for EnumVariable in the
2634       MAN page (#2774).
2636 RELEASE 2.3.0 - Mon, 02 Mar 2013 13:22:29 -0400
2638   From Anatoly Techtonik:
2639     - Added ability to run scripts/scons.py directly from source checkout
2640     - Hide deprecated --debug={dtree,stree,tree} from --help output
2641     - Error messages from option parser now include hints about valid choices
2642     - Cleaned up some Python 1.5 and pre-2.3 code, so don't expect SCons
2643       to run on anything less than Python 2.4 anymore
2644     - Several fixes for runtest.py:
2645       * exit with an error if no tests were found
2646       * removed --noqmtest option - this behavior is by default
2647       * replaced `-o FILE --xml` combination with `--xml FILE`
2648       * changed `-o, --output FILE` option to capture stdout/stderr output
2649         from runtest.py
2650     - Remove os_spawnv_fix.diff patch required to enable parallel builds
2651       support prior to Python 2.2
2653   From Juan Lang:
2654     - Fix WiX Tool to use .wixobj rather than .wxiobj for compiler output
2655     - Support building with WiX releases after 2.0
2657   From Alexey Klimkin:
2658     - Fix nested LIBPATH expansion by flattening sequences in subst_path.
2660   From eyan on Bitbucket:
2661     - Print target name with command execution time with --debug=time
2663   From Thomas Berg and Evgeny Podjachev:
2664     - Fix subprocess spawning on Windows.  Work around a Windows
2665       bug that can crash python occasionally when using -jN. (#2449)
2667   From Dirk Baechle:
2668     - Updated test framework to support dir and file fixtures and
2669       added ability to test external (out-of-tree) tools (#2862).
2670       See doc in QMTest/test-framework.rst.
2671     - Fixed several errors in the test suite (Java paths, MSVS version
2672       detection, Tool import), additionally
2673       * provided MinGW command-line support for the CXX, AS and
2674         Fortran tests,
2675       * refactored the detection of the gcc version and the according
2676         Fortran startup library,
2677       * provided a new module rpmutils.py, wrapping the RPM naming rules
2678         for target files and further hardware-dependent info (compatibility,
2679         compiler flags, ...),
2680       * added new test methods must_exist_one_of() and
2681         must_not_exist_any_of() and
2682       * removed Aegis support from runtest.py. (#2872)
2684   From Gary Oberbrunner:
2685     - Add -jN support to runtest.py to run tests in parallel
2686     - Add MSVC10 and MSVC11 support to get_output low-level bat script runner.
2687     - Fix MSVS solution generation for VS11, and fixed tests.
2689   From Rob Managan:
2690     - Updated the TeX builder to support the \newglossary command
2691       in LaTeX's glossaries package and the files it creates.
2692     - Improve support for new versions of biblatex in the TeX builder
2693       so biber is called automatically if biblatex requires it.
2694     - Add SHLIBVERSION as an option that tells SharedLibrary to build
2695       a versioned shared library and create the required symlinks.
2696       Add builder InstallVersionedLib to create the required symlinks
2697       installing a versioned shared library.
2699 RELEASE 2.2.0 - Mon, 05 Aug 2012 15:37:48 +0000
2701   From dubcanada on Bitbucket:
2702     - Fix 32-bit Visual Express C++ on 64-bit Windows (generate 32-bit code)
2704   From PaweÅ‚ Tomulik:
2705     - Added gettext toolset
2706     - Fixed FindSourceFiles to find final sources (leaf nodes).
2708   From Greg Ward:
2709     - Allow Node objects in Java path (#2825)
2711   From Joshua Hughes:
2712     - Make Windows not redefine builtin file as un-inheritable (#2857)
2713     - Fix WINDOWS_INSERT_DEF on MinGW (Windows) (#2856)
2715   From smallbub on Bitbucket:
2716     - Fix LINKCOMSTR, SHLINKCOMSTR, and LDMODULECOMSTR on Windows (#2833).
2718   From Mortoray:
2719     - Make -s (silent mode) be silent about entering subdirs (#2976).
2720     - Fix cloning of builders when cloning environment (#2821).
2722   From Gary Oberbrunner:
2723     - Show valid Visual Studio architectures in error message
2724        when user passes invalid arch.
2726   From Alexey Petruchik:
2727     - Support for Microsoft Visual Studio 11 (both using it
2728       and generating MSVS11 solution files).
2730   From Alexey Klimkin:
2731     - Fixed the Taskmaster, curing spurious build failures in
2732       multi-threaded runs (#2720).
2734   From Dirk Baechle:
2735     - Improved documentation of command-line variables (#2809).
2736     - Fixed scons-doc.py to properly convert main XML files (#2812).
2738   From Rob Managan:
2739     - Updated the TeX builder to support LaTeX's multibib package.
2740     - Updated the TeX builder to support LaTeX's biblatex package.
2741     - Added support for using biber instead of bibtex by setting
2742       env['BIBTEX'] = 'biber'
2744   From Arve Knudsen:
2745     - Test for FORTRANPPFILESUFFIXES (#2129).
2748 RELEASE 2.1.0 - Mon, 09 Sep 2011 20:54:57 -0700
2750   From Anton Lazarev:
2751     - Fix Windows resource compiler scanner to accept DOS line endings.
2753   From Matthias:
2754     - Update MSVS documents to remove note indicating that only one
2755       project is currently supported per solution file.
2757   From Grzegorz BizoÅ„:
2758     - Fix long compile lines in batch mode by using TEMPFILE
2759     - Fix MSVC_BATCH=False (was treating it as true)
2761   From Justin Gullingsrud:
2762     - support -std=c++0x and related CXXFLAGS in pkgconfig (ParseFlags)
2764   From Vincent Beffara:
2765     - Support -dylib_file in pkgconfig (ParseFlags)
2767   From Gary Oberbrunner and Sohail Somani:
2768     - new construction variable WINDOWS_EMBED_MANIFEST to automatically
2769       embed manifests in Windows EXEs and DLLs.
2771   From Gary Oberbrunner:
2772     - Fix Visual Studio project generation when CPPPATH contains Dir nodes
2773     - Ensure Visual Studio project is regenerated when CPPPATH or CPPDEFINES change
2774     - Fix unicode error when using non-ASCII filenames with Copy or Install
2775     - Put RPATH in LINKCOM rather than LINKFLAGS so resetting
2776       LINKFLAGS doesn't kill RPATH
2777     - Fix precompiled headers on Windows when variant dir name has spaces.
2778     - Adding None to an Action no longer fails (just returns original action)
2779     - New --debug=prepare option to show each target as it's being
2780       prepared, whether or not anything needs to be done for it.
2781     - New debug option --debug=duplicate to print a line for each
2782       unlink/relink (or copy) of a variant file from its source file.
2783     - Improve error message for EnumVariables to show legal values.
2784     - Fix Intel compiler to sort versions >9 correctly (esp. on Linux)
2785     - Fix Install() when the source and target are directories and the
2786       target directory exists.
2788   From David Garcia Garzon:
2789     - Fix Delete to be able to delete broken symlinks and dir
2790       symlinks.
2792   From Imran Fanaswala and Robert Lehr:
2793     - Handle .output file generated by bison/yacc properly. Cleaning it
2794       when necessary.
2796   From Antoine Dechaume:
2797     - Handle SWIG file where there is whitespace after the module name
2798       properly. Previously the generated files would include
2799       the whitespace.
2801   From Dmitry R.:
2802     - Handle Environment in case __semi_deepcopy is None
2804   From Benoit Belley:
2806     - Much improved support for Windows UNC paths (\\SERVERNAME).
2808   From Jean-Baptiste Lab:
2810     - Fix problems with appending CPPDEFINES that contain
2811       dictionaries, and related issues with Parse/MergeFlags and
2812       CPPDEFINES.
2814   From Allen Weeks:
2816     - Fix for an issue with implicit-cache with multiple targets
2817       when dependencies are removed on disk.
2819   From Evgeny Podjachev and Alexey Petruchick:
2821     - Support generation of Microsoft Visual Studio 2008 (9.0)
2822       and 2010 (10.0) project and solution files.
2824   From Ken Deeter:
2826     - Fix a problem when FS Entries which are actually Dirs have builders.
2828   From Luca Falavigna:
2830     - Support Fortran 03
2832   From Gary Oberbrunner:
2834     - Print the path to the SCons package in scons --version
2836   From Jean-Fran�ois Colson:
2838     - Improve Microsoft Visual Studio Solution generation, and fix
2839       various errors in the generated solutions especially when using
2840       MSVS_SCC_PROVIDER, and when generating multiple projects.  The
2841       construction variable MSVS_SCC_PROJECT_BASE_PATH, which never
2842       worked properly, is removed.  Users can use the new variable
2843       MSVS_SCC_CONNECTION_ROOT instead if desired.
2845   From Anatoly Techtonik:
2847     - Use subprocess in bootstrap.py instead of os.execve to avoid
2848       losing output control on Windows (http://bugs.python.org/issue9148)
2850     - Revert patch for adding SCons to App Paths, because standard cmd
2851       shell doesn't search there. This is confusing, because `scons` can
2852       be executed from explorer, but fail to start from console.
2854     - Fix broken installation with easy_install on Windows (issue #2051)
2855       SCons traditionally installed in a way that allowed to run multiple
2856       versions side by side. This custom logic was incompatible with
2857       easy_install way of doing things.
2859     - Use epydoc module for generating API docs in HTML if command line
2860       utility is not found in PATH. Actual for Windows.
2862   From Alexander Goomenyuk:
2864     - Add .sx to assembly source scanner list so .sx files
2865       get their header file dependencies detected.
2867   From Arve Knudsen:
2869     - Set module metadata when loading site_scons/site_init.py
2870       so it is treated as a proper module; __doc__, __file__ and
2871       __name__ now refer to the site_init.py file.
2873   From Russel Winder:
2875     - Users Guide updates explaining that Tools can be packages as
2876       well as python modules.
2878   From Gary Oberbrunner:
2880     - New systemwide and per-user site_scons dirs.
2882   From Dirk Baechle:
2884     - XML fixes in User's Guide.
2885     - Fixed the detection of 'jar' and 'rmic' during
2886       the initialization of the respective Tools (#2730).
2887     - Improved docs for custom Decider functions and
2888       custom Scanner objects (#2711, #2713).
2889     - Corrected SWIG module names for generated *.i files (#2707).
2891   From Joe Zuntz:
2893     - Fixed a case-sensitivity problem with Fortran modules.
2895   From Bauke Conijn:
2897     - Added Users Guide example for auto-generated source code
2899   From Steven Knight:
2901     - Fix explicit dependencies (Depends()) on Nodes that don't have
2902       attached Builders.
2904     - Fix use of the global Alias() function with command actions.
2906   From Matt Hughes:
2908     - Fix the ability to append to default $*FLAGS values (which are
2909       implemented as CLVar instances) in a copied construction environment
2910       without affecting the original construction environment's value.
2912   From Rob Managan:
2914     - Updated the TeX command strings to include a /D on Windows in
2915       case the new directory is on a different drive letter.
2917     - Fixed the LaTeX scanner so dependencies are found in commands that
2918       are broken across lines with a comment or have embedded spaces.
2920     - The TeX builders should now work with tex files that are generated
2921       by another program. Thanks to Hans-Martin von Gaudecker for
2922       isolating the cause of this bug.
2924     - Added support for INDEXSTYLE environment variable so makeindex can
2925       find style files.
2927     - Added support for the bibunits package so we call bibtex on all
2928       the bu*.aux files.
2930     - Add support of finding path information on OSX for TeX applications
2931       MacPorts and Fink paths need to be added by the user
2933   From Russel Winder:
2935     - Add support for DMD version 2 (the phobos2 library).
2937   From William Deegan:
2939     - Add initial support for VS/VC 2010 (express and non-express versions)
2940     - Remove warning for not finding MS VC/VS install.
2941       "scons: warning: No version of Visual Studio compiler found
2942         - C/C++ compilers most likely not set correctly"
2943     - Add support for Linux 3.0
2946 RELEASE 2.0.1 - Mon, 15 Aug 2010 15:46:32 -0700
2948   From Dirk Baechle:
2950     - Fix XML in documentation.
2952   From Joe Zuntz:
2954     - Fixed a case-sensitivity problem with Fortran modules.
2956   From Bauke Conijn:
2958     - Added Users Guide example for auto-generated source code
2960   From Steven Knight:
2962     - Fix explicit dependencies (Depends()) on Nodes that don't have
2963       attached Builders.
2965   From Matt Hughes:
2967     - Fix the ability to append to default $*FLAGS values (which are
2968       implemented as CLVar instances) in a copied construction environment
2969       without affecting the original construction environment's value.
2971   From Rob Managan:
2973     - Updated the TeX command strings to include a /D on Windows in
2974       case the new directory is on a different drive letter.
2976     - Fixed the LaTeX scanner so dependencies are found in commands that
2977       are broken across lines with a comment or have embedded spaces.
2980 RELEASE 2.0.0.final.0 - Mon, 14 Jun 2010 22:01:37 -0700
2982   From Dirk Baechle:
2984     - Fix XML in documentation.
2986   From Steven Knight:
2988     - Provide forward compatibility for the 'profile' module.
2990     - Provide forward compatibility for the 'pickle' module.
2992     - Provide forward compatibility for the 'io' module.
2994     - Provide forward compatibility for the 'queue' module.
2996     - Provide forward compatibility for the 'collections' module.
2998     - Provide forward compatibility for the 'builtins' module.
3000     - Provide forward compatibility for 'sys.intern()'.
3002     - Convert to os.walk() from of os.path.walk().
3004     - Remove compatibility logic no longer needed.
3006     - Add a '-3' option to runtest to print 3.x incompatibility warnings.
3008     - Convert old-style classes into new-style classes.
3010     - Fix "Ignoring corrupt sconsign entry" warnings when building
3011       in a tree with a pre-2.0 .sconsign file.
3013     - Fix propagation from environment of VS*COMNTOOLS to resolve issues
3014       initializing MSVC/MSVS/SDK issues.
3016     - Handle detecting Visual C++ on Python versions with upper-case
3017       platform architectures like 'AMD64'.
3019   From W. Trevor King:
3021     - Revisions to README.
3023   From Greg Noel:
3025     - Apply numerous Python fixers to update code to more modern idioms.
3026       Find where fixers should be applied to code in test strings and
3027       apply the fixers there, too.
3029     - Write a fixer to convert string functions to string methods.
3031     - Modify the 'dict' fixer to be less conservative.
3033     - Modify the 'apply' fixer to handle more cases.
3035     - Create a modified 'types' fixer that converts types to 2.x
3036       equivalents rather than 3.x equivalents.
3038     - Write a 'division' fixer to highlight uses of the old-style
3039       division operator.  Correct usage where needed.
3041     - Add forward compatibility for the new 'memoryview' function
3042       (which replaces the 'buffer' function).
3044     - Add forward compatibility for the 'winreg' module.
3046     - Remove no-longer-needed 'platform' module.
3048     - Run tests with the '-3' option to Python 2.6 and clear up
3049       various reported incompatibilities.
3051     - Comb out code paths specialized to Pythons older than 2.4.
3053     - Update deprecation warnings; most now become mandatory.
3055     - Start deprecation cycle for BuildDir() and build_dir.
3057     - Start deprecation cycle for SourceCode() and related factories
3059     - Fixed a problem with is_Dict() not identifying some objects derived
3060       from UserDict.
3062   From Jim Randall:
3064     - Document the AllowSubstExceptions() function in the User's Guide.
3066   From William Deegan:
3068     - Migrate MSVC/MSVS/SDK improvements from 1.3 branch.
3071 RELEASE 1.3.0 - Tue, 23 Mar 2010 21:44:19 -0400
3073   From Steven Knight:
3075     - Update man page and documentation.
3077   From William Deegan (plus minor patch from Gary Oberbrunner):
3079     - Support Visual Studio 8.0 Express
3081 RELEASE 1.2.0.d20100306 - Sat, 06 Mar 2010 16:18:33 -0800
3083   From Luca Falavigna:
3085     - Fix typos in the man page.
3087   From Gottfried Ganssauge:
3089     - Support execution when SCons is installed via easy_install.
3091   From Steven Knight:
3093     - Make the messages for Configure checks of compilers consistent.
3095     - Issue an error message if a BUILDERS entry is not a Builder
3096       object or a callable wrapper.
3098   From Rob Managan:
3100     - Update tex builder to handle the case where a \input{foo}
3101       command tries to work with a directory named foo instead of the
3102       file foo.tex. The builder now ignores a directory and continues
3103       searching to find the correct file. Thanks to Lennart Sauerbeck
3104       for the test case and initial patch
3106       Also allow the \include of files in subdirectories when variantDir
3107       is used with duplicate=0. Previously latex would crash since
3108       the directory in which the .aux file is written was not created.
3109       Thanks to Stefan Hepp for finding this and part of the solution.
3111   From James Teh:
3112     - Patches to fix some issues using MS SDK V7.0
3114   From William Deegan:
3115     - Lots of testing and minor patches to handle mixed MS VC and SDK
3116       installations, as well as having only the SDK installed.
3119 RELEASE 1.2.0.d20100117 - Sun, 17 Jan 2010 14:26:59 -0800
3121   From Jim Randall:
3122     - Fixed temp filename race condition on Windows with long cmd lines.
3124   From David Cournapeau:
3125     - Fixed tryRun when sconf directory is in a variant dir.
3126     - Do not add -fPIC for ifort tool on non-posix platforms (darwin and
3127       windows).
3128     - Fix bug 2294 (spurious CheckCC failures).
3129     - Fix SCons bootstrap process on windows 64 (wrong wininst name)
3131   From William Deegan:
3132     - Final merge from vs_revamp branch to main
3134     - Added definition and usage of HOST_OS, HOST_ARCH, TARGET_OS,
3135       TARGET_ARCH, currently only defined/used by Visual Studio
3136       Compilers. This will be rolled out to other platforms/tools
3137       in the future.
3139     - Add check for python >= 3.0.0 and exit gracefully.
3140       For 1.3 python >= 1.5.2 and < 3.0.0 are supported
3142     - Fix bug 1944 - Handle non-existent .i file in swig emitter, previously
3143       it would crash with an IOError exception. Now it will try to make an
3144       educated guess on the module name based on the filename.
3146   From Lukas Erlinghagen:
3148     - Have AddOption() remove variables from the list of
3149       seen-but-unknown variables (which are reported later).
3151     - An option name and aliases can now be specified as a tuple.
3153   From Hartmut Goebel:
3155     - Textfile builder.
3157   From Jared Grubb:
3159     - use "is/is not" in comparisons with None instead of "==" or "!=".
3161   From Jim Hunziker:
3163     - Avoid adding -gphobos to a command line multiple times
3164       when initializing use of the DMD compiler.
3166   From Jason Kenney:
3168     - Sugguested HOST/TARGET OS/ARCH separation.
3170   From Steven Knight:
3172     - Fix the -n option when used with VariantDir(duplicate=1)
3173       and the variant directory doesn't already exist.
3175     - Fix scanning of Unicode files for both UTF-16 endian flavors.
3177     - Fix a TypeError on #include of file names with Unicode characters.
3179     - Fix an exception if a null command-line argument is passed in.
3181     - Evaluate Requires() prerequisites before a Node's direct children
3182       (sources and dependencies).
3184   From Greg Noel:
3186     - Remove redundant __metaclass__ initializations in Environment.py.
3188     - Correct the documentation of text returned by sconf.Result().
3190     - Document that filenames with '.' as the first character are
3191       ignored by Glob() by default (matching UNIX glob semantics).
3193     - Fix SWIG testing infrastructure to work on Mac OS X.
3195     - Restructure a test that occasionally hung so that the test would
3196       detect when it was stuck and fail instead.
3198     - Substfile builder.
3200   From Gary Oberbrunner:
3202     - When reporting a target that SCons doesn't know how to make,
3203       specify whether it's a File, Dir, etc.
3205   From Ben Webb:
3207     - Fix use of $SWIGOUTDIR when generating Python wrappers.
3209     - Add $SWIGDIRECTORSUFFIX and $SWIGVERSION construction variables.
3211   From Rob Managan:
3213     - Add -recorder flag to Latex commands and updated internals to
3214       use the output to find files TeX creates. This allows the MiKTeX
3215       installations to find the created files
3217     - Notify user of Latex errors that would get buried in the
3218       Latex output
3220     - Remove LATEXSUFFIXES from environments that don't initialize Tex.
3222     - Add support for the glossaries package for glossaries and acronyms
3224     - Fix problem that pdftex, latex, and pdflatex tools by themselves did
3225       not create the actions for bibtex, makeindex,... by creating them
3226       and other environment settings in one routine called by all four
3227       tex tools.
3229     - Fix problem with filenames of sideeffects when the user changes
3230       the name of the output file from the latex default
3232     - Add scanning of files included in Latex by means of \lstinputlisting{}
3233       Patch from Stefan Hepp.
3235     - Change command line for epstopdf to use --outfile= instead of -o
3236       since this works on all platforms.
3237       Patch from Stefan Hepp.
3239     - Change scanner to properly search for included file from the
3240       directory of the main file instead of the file it is included from.
3241       Also update the emitter to add the .aux file associated with
3242       \include{filename} commands. This makes sure the required directories
3243       if any are created for variantdir cases.
3244       Half of the patch from Stefan Hepp.
3246 RELEASE 1.2.0.d20090223 - Mon, 23 Feb 2009 08:41:06 -0800
3248   From Stanislav Baranov:
3250     - Make suffix-matching for scanners case-insensitive on Windows.
3252   From David Cournapeau:
3254     - Change the way SCons finds versions of Visual C/C++ and Visual
3255       Studio to find and use the Microsoft v*vars.bat files.
3257   From Robert P. J. Day:
3259     - User's Guide updates.
3261   From Dan Eaton:
3263     - Fix generation of Visual Studio 8 project files on x64 platforms.
3265   From Allan Erskine:
3267     - Set IncludeSearchPath and PreprocessorDefinitions in generated
3268       Visual Studio 8 project files, to help IntelliSense work.
3270   From Mateusz Gruca:
3272     - Fix deletion of broken symlinks by the --clean option.
3274   From Steven Knight:
3276     - Fix the error message when use of a non-existent drive on Windows
3277       is detected.
3279     - Add sources for files whose targets don't exist in $CHANGED_SOURCES.
3281     - Detect implicit dependencies on commands even when the command is
3282       quoted.
3284     - Fix interaction of $CHANGED_SOURCES with the --config=force option.
3286     - Fix finding #include files when the string contains escaped
3287       backslashes like "C:\\some\\include.h".
3289     - Pass $CCFLAGS to Visual C/C++ precompiled header compilation.
3291     - Remove unnecessary nested $( $) around $_LIBDIRFLAGS on link lines
3292       for the Microsoft linker, the OS/2 ilink linker and the Phar Lap
3293       linkloc linker.
3295     - Spell the Windows environment variables consistently "SystemDrive"
3296       and "SystemRoot" instead of "SYSTEMDRIVE" and "SYSTEMROOT".
3300 RELEASE 1.2.0.d20090113 - Tue, 13 Jan 2009 02:50:30 -0800
3302   From Stanislav Baranov, Ted Johnson and Steven Knight:
3304     - Add support for batch compilation of Visual Studio C/C++ source
3305       files, controlled by a new $MSVC_BATCH construction variable.
3307   From Steven Knight:
3309     - Print the message, "scons: Build interrupted." on error output,
3310       not standard output.
3312     - Add a --warn=future-deprecated option for advance warnings about
3313       deprecated features that still have warnings hidden by default.
3315     - Fix use of $SOURCE and $SOURCES attributes when there are no
3316       sources specified in the Builder call.
3318     - Add support for new $CHANGED_SOURCES, $CHANGED_TARGETS,
3319       $UNCHANGED_SOURCES and $UNCHANGED_TARGETS variables.
3321     - Add general support for batch builds through new batch_key= and
3322       targets= keywords to Action object creation.
3324   From Arve Knudsen:
3326     - Make linker tools differentiate properly between SharedLibrary
3327       and LoadableModule.
3329     - Document TestCommon.shobj_prefix variable.
3331     - Support $SWIGOUTDIR values with spaces.
3333   From Rob Managan:
3335     - Don't automatically try to build .pdf graphics files for
3336       .eps files in \includegraphics{} calls in TeX/LaTeX files
3337       when building with the PDF builder (and thus using pdflatex).
3339   From Gary Oberbrunner:
3341     - Allow AppendENVPath() and PrependENVPath() to interpret '#'
3342       for paths relative to the top-level SConstruct directory.
3344     - Use the Borland ilink -e option to specify the output file name.
3346     - Document that the msvc Tool module uses $PCH, $PCHSTOP and $PDB.
3348     - Allow WINDOWS_INSERT_DEF=0 to disable --output-def when linking
3349       under MinGW.
3351   From Zia Sobhani:
3353     - Fix typos in the User's Guide.
3355   From Greg Spencer:
3357     - Support implicit dependency scanning of files encoded in utf-8
3358       and utf-16.
3360   From Roberto de Vecchi:
3362     - Remove $CCFLAGS from the the default definitions of $CXXFLAGS for
3363       Visual C/C++ and MIPSpro C++ on SGI so, they match other tools
3364       and avoid flag duplication on C++ command lines.
3366   From Ben Webb:
3368     - Handle quoted module names in SWIG source files.
3370     - Emit *_wrap.h when SWIG generates header file for directors
3372   From Matthew Wesley:
3374     - Copy file attributes so we identify, and can link a shared library
3375       from, shared object files in a Repository.
3379 RELEASE 1.2.0 - Sat, 20 Dec 2008 22:47:29 -0800
3381   From Steven Knight:
3383     - Don't fail if can't import a _subprocess module on Windows.
3385     - Add warnings for use of the deprecated Options object.
3389 RELEASE 1.1.0.d20081207 - Sun, 07 Dec 2008 19:17:23 -0800
3391   From Benoit Belley:
3393     - Improve the robustness of GetBuildFailures() by refactoring
3394       SCons exception handling (especially BuildError exceptions).
3396     - Have the --taskmastertrace= option print information about
3397       individual Task methods, not just the Taskmaster control flow.
3399     - Eliminate some spurious dependency cycles by being more aggressive
3400       about pruning pending children from the Taskmaster walk.
3402     - Suppress mistaken reports of a dependency cycle when a child
3403       left on the pending list is a single Node in EXECUTED state.
3405   From David Cournapeau:
3407     - Fix $FORTRANMODDIRPREFIX for the ifort (Intel Fortran) tool.
3409   From Brad Fitzpatrick:
3411     - Don't pre-generate an exception message (which will likely be
3412       ignored anyway) when an EntryProxy re-raises an AttributeError.
3414   From Jared Grubb:
3416     - Clean up coding style and white space in Node/FS.py.
3418     - Fix a typo in the documentation for $_CPPDEFFLAGS.
3420     - Issue 2401: Fix usage of comparisons with None.
3422   From Ludwig H�hne:
3424     - Handle Java inner classes declared within a method.
3426   From Steven Knight:
3428     - Fix label placement by the "scons-time.py func" subcommand
3429       when a profile value was close to (or equal to) 0.0.
3431     - Fix env.Append() and env.Prepend()'s ability to add a string to
3432       list-like variables like $CCFLAGS under Python 2.6.
3434     - Other Python2.6 portability:  don't use "as" (a Python 2.6 keyword).
3435       Don't use the deprecated Exception.message attribute.
3437     - Support using the -f option to search for a different top-level
3438       file name when walking up with the -D, -U or -u options.
3440     - Fix use of VariantDir when the -n option is used and doesn't,
3441       therefore, actually create the variant directory.
3443     - Fix a stack trace from the --debug=includes option when passed a
3444       static or shared library as an argument.
3446     - Speed up the internal find_file() function (used for searching
3447       CPPPATH, LIBPATH, etc.).
3449     - Add support for using the Python "in" keyword on construction
3450       environments (for example, if "CPPPATH" in env: ...).
3452     - Fix use of Glob() when a repository or source directory contains
3453       an in-memory Node without a corresponding on-disk file or directory.
3455     - Add a warning about future reservation of $CHANGED_SOURCES,
3456       $CHANGED_TARGETS, $UNCHANGED_SOURCES and $UNCHANGED_TARGETS.
3458     - Enable by default the existing warnings about setting the resource
3459       $SOURCE, $SOURCES, $TARGET and $TARGETS variable.
3461   From Rob Managan:
3463     - Scan for TeX files in the paths specified in the $TEXINPUTS
3464       construction variable and the $TEXINPUTS environment variable.
3466     - Configure the PDF() and PostScript() Builders as single_source so
3467       they know each source file generates a separate target file.
3469     - Add $EPSTOPDF, $EPSTOPDFFLAGS and $EPSTOPDFCOM
3471     - Add .tex as a valid extension for the PDF() builder.
3473     - Add regular expressions to find \input, \include and
3474       \includegraphics.
3476     - Support generating a .pdf file from a .eps source.
3478     - Recursive scan included input TeX files.
3480     - Handle requiring searched-for TeX input graphics files to have
3481       extensions (to avoid trying to build a .eps from itself, e.g.).
3483   From Greg Noel:
3485     - Make the Action() function handle positional parameters consistently.
3487     - Clarify use of Configure.CheckType().
3489     - Make the File.{Dir,Entry,File}() methods create their entries
3490       relative to the calling File's directory, not the SConscript
3491       directory.
3493     - Use the Python os.devnull variable to discard error output when
3494       looking for the $CC or $CXX version.
3496     - Mention LoadableModule() in the SharedLibrary() documentation.
3498   From Gary Oberbrunner:
3500     - Update the User's Guide to clarify use of the site_scons/
3501       directory and the site_init.py module.
3503     - Make env.AppendUnique() and env.PrependUnique remove duplicates
3504       within a passed-in list being added, too.
3506   From Randall Spangler:
3508     - Fix Glob() so an on-disk file or directory beginning with '#'
3509       doesn't throw an exception.
3513 RELEASE 1.1.0 - Thu, 09 Oct 2008 08:33:47 -0700
3515   From Chris AtLee
3517     - Use the specified environment when checking for the GCC compiler
3518       version.
3520   From Ian P. Cardenas:
3522     - Fix Glob() polluting LIBPATH by returning copy of list
3524   From David Cournapeau:
3526     - Add CheckCC, CheckCXX, CheckSHCC and CheckSHCXX tests to
3527       configuration contexts.
3529     - Have the --profile= argument use the much faster cProfile module
3530       (if it's available in the running Python version).
3532     - Reorder MSVC compilation arguments so the /Fo is first.
3534   From Bill Deegan:
3536     - Add scanning Windows resource (.rc) files for implicit dependencies.
3538   From John Gozde:
3540     - When scanning for a #include file, don't use a directory that
3541       has the same name as the file.
3543   From Ralf W. Grosse-Kunstleve
3545     - Suppress error output when checking for the GCC compiler version.
3547   From Jared Grubb:
3549     - Fix VariantDir duplication of #included files in subdirectories.
3551   From Ludwig H�hne:
3553     - Reduce memory usage when a directory is used as a dependency of
3554       another Node (such as an Alias) by returning a concatenation
3555       of the children's signatures + names, not the children's contents,
3556       as the directory contents.
3558     - Raise AttributeError, not KeyError, when a Builder can't be found.
3560     - Invalidate cached Node information (such as the contenst returned
3561       by the get_contents() method) when calling actions with Execute().
3563     - Avoid object reference cycles from frame objects.
3565     - Reduce memory usage from Null Executor objects.
3567     - Compute MD5 checksums of large files without reading the entire
3568       file contents into memory.  Add a new --md5-chunksize option to
3569       control the size of each chunk read into memory.
3571   From Steven Knight:
3573     - Fix the ability of the add_src_builder() method to add a new
3574       source builder to any other builder.
3576     - Avoid an infinite loop on non-Windows systems trying to find the
3577       SCons library directory if the Python library directory does not
3578       begin with the string "python".
3580     - Search for the SCons library directory in "scons-local" (with
3581       no version number) after "scons-local-{VERSION}".
3583   From Rob Managan:
3585     - Fix the user's ability to interrupt the TeX build chain.
3587     - Fix the TeX builder's allowing the user to specify the target name,
3588       instead of always using its default output name based on the source.
3590     - Iterate building TeX output files until all warning are gone
3591       and the auxiliary files stop changing, or until we reach the
3592       (configurable) maximum number of retries.
3594     - Add TeX scanner support for:  glossaries, nomenclatures, lists of
3595       figures, lists of tables, hyperref and beamer.
3597     - Use the $BIBINPUTS, $BSTINPUTS, $TEXINPUTS and $TEXPICTS construction
3598       variables as search paths for the relevant types of input file.
3600     - Fix building TeX with VariantDir(duplicate=0) in effect.
3602     - Fix the LaTeX scanner to search for graphics on the TEXINPUTS path.
3604     - Have the PDFLaTeX scanner search for .gif files as well.
3606   From Greg Noel:
3608     - Fix typos and format bugs in the man page.
3610     - Add a first draft of a wrapper module for Python's subprocess
3611       module.
3613     - Refactor use of the SCons.compat module so other modules don't
3614       have to import it individually.
3616     - Add .sx as a suffix for assembly language files that use the
3617       C preprocessor.
3619   From Gary Oberbrunner:
3621     - Make Glob() sort the returned list of Files or Nodes
3622       to prevent spurious rebuilds.
3624     - Add a delete_existing keyword argument to the AppendENVPath()
3625       and PrependENVPath() Environment methods.
3627     - Add ability to use "$SOURCE" when specifying a target to a builder
3629   From Damyan Pepper:
3631     - Add a test case to verify that SConsignFile() files can be
3632       created in previously non-existent subdirectories.
3634   From Jim Randall:
3636     - Make the subdirectory in which the SConsignFile() file will
3637       live, if the subdirectory doesn't already exist.
3639   From Ali Tofigh:
3641     - Add a test to verify duplication of files in VariantDir subdirectories.
3645 RELEASE 1.0.1 - Sat, 06 Sep 2008 07:29:34 -0700
3647   From Greg Noel:
3649     - Add a FindFile() section to the User's Guide.
3651     - Fix the FindFile() documentation in the man page.
3653     - Fix formatting errors in the Package() description in the man page.
3655     - Escape parentheses that appear within variable names when spawning
3656       command lines using os.system().
3660 RELEASE 1.0.0 - XXX
3662   From Jared Grubb:
3664     - Clear the Node state when turning a generic Entry into a Dir.
3666   From Ludwig H�hne:
3668     - Fix sporadic output-order failures in test/GetBuildFailures/parallel.py.
3670     - Document the ParseDepends() function in the User's Guide.
3672   From khomenko:
3674     - Create a separate description and long_description for RPM packages.
3676   From Steven Knight:
3678     - Document the GetLaunchDir() function in the User's Guide.
3680     - Have the env.Execute() method print an error message if the
3681       executed command fails.
3683     - Add a script for creating a standard SCons development system on
3684       Ubuntu Hardy.  Rewrite subsidiary scripts for install Python and
3685       SCons versions in Python (from shell).
3687   From Greg Noel:
3689     - Handle yacc/bison on newer Mac OS X versions creating file.hpp,
3690       not file.cpp.h.
3692     - In RPCGEN tests, ignore stderr messages from older versions of
3693       rpcgen on some versions of Mac OS X.
3695     - Fix typos in man page descriptions of Tag() and Package(), and in
3696       the scons-time man page.
3698     - Fix documentation of SConf.CheckLibWithHeader and other SConf methods.
3700     - Update documentation of SConscript(variant_dir) usage.
3702     - Fix SWIG tests for (some versions of) Mac OS X.
3704   From Jonas Olsson:
3706     - Print the warning about -j on Windows being potentially unreliable if
3707       the pywin32 extensions are unavailable or lack file handle operations.
3709   From Jim Randall:
3711     - Fix the env.WhereIs() method to expand construction variables.
3713   From Rogier Schouten:
3715     - Enable building of shared libraries with the Bordand ilink32 linker.
3719 RELEASE 1.0.0 - Sat, 09 Aug 2008 12:19:44 -0700
3721   From Luca Falavigna:
3723     - Fix SCons man page indentation under Debian's man page macros.
3725   From Steven Knight:
3727     - Clarify the man page description of the SConscript(src_dir) argument.
3729     - User's Guide updates:
3731        -  Document the BUILD_TARGETS, COMMAND_LINE_TARGETS and
3732           DEFAULT_TARGETS variables.
3734        -  Document the AddOption(), GetOption() and SetOption() functions.
3736        -  Document the Requires() function; convert to the Variables
3737           object, its UnknownOptions() method, and its associated
3738           BoolVariable(), EnumVariable(), ListVariable(), PackageVariable()
3739           and PathVariable() functions.
3741        -  Document the Progress() function.
3743        -  Reorganize the chapter and sections describing the different
3744           types of environments and how they interact.  Document the
3745           SetDefault() method.  Document the PrependENVPath() and
3746           AppendENVPath() functions.
3748        -  Reorganize the command-line arguments chapter.  Document the
3749           ARGLIST variable.
3751        -  Collect some miscellaneous sections into a chapter about
3752           configuring build output.
3754     - Man page updates:
3756        -  Document suggested use of the Visual C/C++ /FC option to fix
3757           the ability to double-click on file names in compilation error
3758           messages.
3760        -  Document the need to use Clean() for any SideEffect() files that
3761           must be explicitly removed when their targets are removed.
3763        -  Explicitly document use of Node lists as input to Dependency().
3765   From Greg Noel:
3767     - Document MergeFlags(), ParseConfig(), ParseFlags() and SideEffect()
3768       in the User's Guide.
3770   From Gary Oberbrunner:
3772     - Document use of the GetBuildFailures() function in the User's Guide.
3774   From Adam Simpkins:
3776     - Add man page text clarifying the behavior of AddPreAction() and
3777       AddPostAction() when called with multiple targets.
3779   From Alexey Zezukin:
3781     - Fix incorrectly swapped man page descriptions of the --warn= options
3782       for duplicate-environment and missing-sconscript.
3786 RELEASE 0.98.5 - Sat, 07 Jun 2008 08:20:35 -0700
3788   From Benoit Belley:
3790   - Fix the Intel C++ compiler ABI specification for EMT64 processors.
3792   From David Cournapeau:
3794   - Issue a (suppressable) warning, not an error, when trying to link
3795     C++ and Fortran object files into the same executable.
3797   From Steven Knight:
3799   - Update the scons.bat file so that it returns the real exit status
3800     from SCons, even though it uses setlocal + endlocal.
3802   - Fix the --interactive post-build messages so it doesn't get stuck
3803     mistakenly reporting failures after any individual build fails.
3805   - Fix calling File() as a File object method in some circumstances.
3807   - Fix setup.py installation on Mac OS X so SCons gets installed
3808     under /usr/lcoal by default, not in the Mac OS X Python framework.
3812 RELEASE 0.98.4 - Sat, 17 May 2008 22:14:46 -0700
3814   From Benoit Belley:
3816   - Fix calculation of signatures for Python function actions with
3817     closures in Python versions before 2.5.
3819   From David Cournapeau:
3821   - Fix the initialization of $SHF77FLAGS so it includes $F77FLAGS.
3823   From Jonas Olsson:
3825   - Fix a syntax error in the Intel C compiler support on Windows.
3827   From Steven Knight:
3829   - Change how we represent Python Value Nodes when printing and when
3830     stored in .sconsign files (to avoid blowing out memory by storing
3831     huge strings in .sconsign files after multiple runs using Configure
3832     contexts cause the Value strings to be re-escaped each time).
3834   - Fix a regression in not executing configuration checks after failure
3835     of any configuration check that used the same compiler or other tool.
3837   - Handle multiple destinations in Visual Studio 8 settings for the
3838     analogues to the INCLUDE, LIBRARY and PATH variables.
3840   From Greg Noel:
3842   - Update man page text for VariantDir().
3846 RELEASE 0.98.3 - Tue, 29 Apr 2008 22:40:12 -0700
3848   From Greg Noel:
3850   - Fix use of $CXXFLAGS when building C++ shared object files.
3852   From Steven Knight:
3854   - Fix a regression when a Builder's source_scanner doesn't select
3855     a more specific scanner for the suffix of a specified source file.
3857   - Fix the Options object backwards compatibility so people can still
3858     "import SCons.Options.{Bool,Enum,List,Package,Path}Option" submodules.
3860   - Fix searching for implicit dependencies when an Entry Node shows up
3861     in the search path list.
3863   From Stefano:
3865   - Fix expansion of $FORTRANMODDIR in the default Fortran command line(s)
3866     when it's set to something like ${TARGET.dir}.
3870 RELEASE 0.98.2 - Sun, 20 Apr 2008 23:38:56 -0700
3872   From Steven Knight:
3874   - Fix a bug in Fortran suffix computation that would cause SCons to
3875     run out of memory on Windows systems.
3877   - Fix being able to specify --interactive mode command lines with
3878     \ (backslash) path name separators on Windows.
3880   From Gary Oberbrunner:
3882   - Document Glob() in the User's Guide.
3886 RELEASE 0.98.1 - Fri, 18 Apr 2008 19:11:58 -0700
3888   From Benoit Belley:
3890   - Speed up the SCons.Util.to_string*() functions.
3892   - Optimize various Node intialization and calculations.
3894   - Optimize Executor scanning code.
3896   - Optimize Taskmaster execution, including dependency-cycle checking.
3898   - Fix the --debug=stree option so it prints its tree once, not twice.
3900   From Johan Boul�:
3902   - Fix the ability to use LoadableModule() under MinGW.
3904   From David Cournapeau:
3906   - Various missing Fortran-related construction variables have been added.
3908   - SCons now uses the program specified in the $FORTRAN construction
3909     variable to link Fortran object files.
3911   - Fortran compilers on Linux (Intel, g77 and gfortran) now add the -fPIC
3912     option by default when compilling shared objects.
3914   - New 'sunf77', 'sunf90' and 'sunf95' Tool modules have been added to
3915     support Sun Fortran compilers.  On Solaris, the Sun Fortran compilers
3916     are used in preference to other compilers by default.
3918   - Fortran support now uses gfortran in preference to g77.
3920   - Fortran file suffixes are now configurable through the
3921     $F77FILESUFFIXES, $F90FILESUFFIXES, $F95FILESUFFIXES and
3922     $FORTRANFILESUFFIXES variables.
3924   From Steven Knight:
3926   - Make the -d, -e, -w and --no-print-directory options "Ignored for
3927     compatibility."  (We're not going to implement them.)
3929   - Fix a serious inefficiency in how SCons checks for whether any source
3930     files are missing when a Builder call creates many targets from many
3931     input source files.
3933   - In Java projects, make the target .class files depend only on the
3934     specific source .java files where the individual classes are defined.
3936   - Don't store duplicate source file entries  in the .sconsign file so
3937     we don't endlessly rebuild the target(s) for no reason.
3939   - Add a Variables object as the first step towards deprecating the
3940     Options object name.  Similarly, add BoolVariable(), EnumVariable(),
3941     ListVariable(), PackageVariable() and PathVariable() functions
3942     as first steps towards replacing BoolOption(), EnumOption(),
3943     ListOption(), PackageOption() and PathOption().
3945   - Change the options= keyword argument to the Environment() function
3946     to variables=, to avoid confusion with SCons command-line options.
3947     Continue supporting the options= keyword for backwards compatibility.
3949   - When $SWIGFLAGS contains the -python flag, expect the generated .py
3950     file to be in the same (sub)directory as the target.
3952   - When compiling C++ files, allow $CCFLAGS settings to show up on the
3953     command line even when $CXXFLAGS has been redefined.
3955   - Fix --interactive with -u/-U/-D when a VariantDir() is used.
3957   From Anatoly Techtonik:
3959   - Have the scons.bat file add the script execution directory to its
3960     local %PATH% on Windows, so the Python executable can be found.
3962   From Mike Wake:
3964   - Fix passing variable names as a list to the Return() function.
3966   From Matthew Wesley:
3968   - Add support for the GDC 'D' language compiler.
3972 RELEASE 0.98 - Sun, 30 Mar 2008 23:33:05 -0700
3974   From Benoit Belley:
3976   - Fix the --keep-going flag so it builds all possible targets even when
3977     a later top-level target depends on a child that failed its build.
3979   - Fix being able to use $PDB and $WINDWOWS_INSERT_MANIFEST together.
3981   - Don't crash if un-installing the Intel C compiler leaves left-over,
3982     dangling entries in the Windows registry.
3984   - Improve support for non-standard library prefixes and suffixes by
3985     stripping all prefixes/suffixes from file name string as appropriate.
3987   - Reduce the default stack size for -j worker threads to 256 Kbytes.
3988     Provide user control over this value by adding --stack-size and
3989     --warn=stack-size options, and a SetOption('stack_size') function.
3991   - Fix a crash on Linux systems when trying to use the Intel C compiler
3992     and no /opt/intel_cc_* directories are found.
3994   - Improve using Python functions as actions by incorporating into
3995     a FunctionAction's signature:
3996       - literal values referenced by the byte code.
3997       - values of default arguments
3998       - code of nested functions
3999       - values of variables captured by closures
4000       - names of referenced global variables and functions
4002   - Fix the closing message when --clean and --keep-going are both
4003     used and no errors occur.
4005   - Add support for the Intel C compiler on Mac OS X.
4007   - Speed up reading SConscript files by about 20% (for some
4008     configurations) by:  1) optimizing the SCons.Util.is_*() and
4009     SCons.Util.flatten() functions; 2) avoiding unnecessary os.stat()
4010     calls by using a File's .suffix attribute directly instead of
4011     stringifying it.
4013   From Jérôme Berger:
4015   - Have the D language scanner search for .di files as well as .d files.
4017   - Add a find_include_names() method to the Scanner.Classic class to
4018     abstract out how included names can be generated by subclasses.
4020   - Allow the D language scanner to detect multiple modules imported by
4021     a single statement.
4023   From Konstantin Bozhikov:
4025   - Support expansion of construction variables that contain or refer
4026     to lists of other variables or Nodes within expansions like $CPPPATH.
4028   - Change variable substitution (the env.subst() method) so that an
4029     input sequence (list or tuple) is preserved as a list in the output.
4031   From David Cournapeau:
4033   - Add a CheckDeclaration() call to configure contexts.
4035   - Improve the CheckTypeSize() code.
4037   - Add a Define() call to configure contexts, to add arbitrary #define
4038     lines to a generated configure header file.
4040   - Add a "gfortran" Tool module for the GNU F95/F2003 compiler.
4042   - Avoid use of -rpath with the Mac OS X linker.
4044   - Add comment lines to the generated config.h file to describe what
4045     the various #define/#undef lines are doing.
4047   From Steven Knight:
4049   - Support the ability to subclass the new-style "str" class as input
4050     to Builders.
4052   - Improve the performance of our type-checking by using isinstance()
4053     with new-style classes.
4055   - Fix #include (and other $*PATH variables searches) of files with
4056     absolute path names.  Don't die if they don't exist (due to being
4057     #ifdef'ed out or the like).
4059   - Fix --interactive mode when Default(None) is used.
4061   - Fix --debug=memoizer to work around a bug in base Python 2.2 metaclass
4062     initialization (by just not allowing Memoization in Python versions
4063     that have the bug).
4065   - Have the "scons-time time" subcommand handle empty log files, and
4066     log files that contain no results specified by the --which option.
4068   - Fix the max Y of vertical bars drawn by "scons-time --fmt=gnuplot".
4070   - On Mac OS X, account for the fact that the header file generated
4071     from a C++ file will be named (e.g.) file.cpp.h, not file.hpp.
4073   - Fix floating-point numbers confusing the Java parser about
4074     generated .class file names in some configurations.
4076   - Document (nearly) all the values you can now fetch with GetOption().
4078   - Fix use of file names containing strings of multiple spaces when
4079     using ActionFactory instances like the Copy() or Move() function.
4081   - Fix a 0.97 regression when using a variable expansion (like
4082     $OBJSUFFIX) in a source file name to a builder with attached source
4083     builders that match suffix (like Program()+Object()).
4085   - Have the Java parser recognize generics (surrounded by angle brackets)
4086     so they don't interfere with identifying anonymous inner classes.
4088   - Avoid an infinite loop when trying to use saved copies of the
4089     env.Install() or env.InstallAs() after replacing the method
4090     attributes.
4092   - Improve the performance of setting construction variables.
4094   - When cloning a construction environment, avoid over-writing an
4095     attribute for an added method if the user explicitly replaced it.
4097   - Add a warning about deprecated support for Python 1.5, 2.0 and 2.1.
4099   - Fix being able to SetOption('warn', ...) in SConscript files.
4101   - Add a warning about env.Copy() being deprecated.
4103   - Add warnings about the --debug={dtree,stree,tree} options
4104     being deprecated.
4106   - Add VariantDir() as the first step towards deprecating BuildDir().
4107     Add the keyword argument "variant_dir" as the replacement for
4108     "build_dir".
4110   - Add warnings about the {Target,Source}Signatures() methods and
4111     functions being deprecated.
4113   From Rob Managan:
4115   - Enhance TeX and LaTeX support to work with BuildDir(duplicate=0).
4117   - Re-run LaTeX when it issues a package warning that it must be re-run.
4119   From Leanid Nazdrynau:
4121   - Have the Copy() action factory preserve file modes and times
4122     when copying individual files.
4124   From Jan Nijtmans:
4126   - If $JARCHDIR isn't set explicitly, use the .java_classdir attribute
4127     that was set when the Java() Builder built the .class files.
4129   From Greg Noel:
4131   - Document the Dir(), File() and Entry() methods of Dir and File Nodes.
4133   - Add the parse_flags option when creating Environments
4135   From Gary Oberbrunner:
4137   - Make File(), Dir() and Entry() return a list of Nodes when passed
4138     a list of names, instead of trying to make a string from the name
4139     list and making a Node from that string.
4141   - Fix the ability to build an Alias in --interactive mode.
4143   - Fix the ability to hash the contents of actions for nested Python
4144     functions on Python versions where the inability to pickle them
4145     returns a TypeError (instead of the documented PicklingError).
4147   From Jonas Olsson:
4149   - Fix use of the Intel C compiler when the top compiler directory,
4150     but not the compiler version, is specified.
4152   - Handle Intel C compiler network license files (port@system).
4154   From Jim Randall:
4156   - Fix how Python Value Nodes are printed in --debug=explain output.
4158   From Adam Simpkins:
4160   - Add a --interactive option that starts a session for building (or
4161     cleaning) targets without re-reading the SConscript files every time.
4163   - Fix use of readline command-line editing in --interactive mode.
4165   - Have the --interactive mode "build" command with no arguments
4166     build the specified Default() targets.
4168   - Fix the Chmod(), Delete(), Mkdir() and Touch() Action factories to
4169     take a list (of Nodes or strings) as arguments.
4171   From Vaclav Smilauer:
4173   - Fix saving and restoring an Options value of 'all' on Python
4174     versions where all() is a builtin function.
4176   From Daniel Svensson:
4178   - Code correction in SCons.Util.is_List().
4180   From Ben Webb:
4182   - Support the SWIG %module statement with following modifiers in
4183     parenthese (e.g., '%module(directors="1")').
4187 RELEASE 0.97.0d20071212 - Wed, 12 Dec 2007 09:29:32 -0600
4189   From Benoit Belley:
4191   - Fix occasional spurious rebuilds and inefficiency when using
4192     --implicit-cache and Builders that produce multiple targets.
4194   - Allow SCons to not have to know about the builders of generated
4195     files when BuildDir(duplicate=0) is used, potentially allowing some
4196     SConscript files to be ignored for smaller builds.
4198   From David Cournapeau:
4200   - Add a CheckTypeSize() call to configure contexts.
4202   From Ken Deeter:
4204   - Make the "contents" of Alias Nodes a concatenation of the children's
4205     content signatures (MD5 checksums), not a concatenation of the
4206     children's contents, to avoid using large amounts of memory during
4207     signature calculation.
4209   From Malte Helmert:
4211   - Fix a lot of typos in the man page and User's Guide.
4213   From Geoffrey Irving:
4215   - Speed up conversion of paths in .sconsign files to File or Dir Nodes.
4217   From Steven Knight:
4219   - Add an Options.UnknownOptions() method that returns any settings
4220     (from the command line, or whatever dictionary was passed in)
4221     that aren't known to the Options object.
4223   - Add a Glob() function.
4225   - When removing targets with the -c option, use the absolute path (to
4226     avoid problems interpreting BuildDir() when the top-level directory
4227     is the source directory).
4229   - Fix problems with Install() and InstallAs() when called through a
4230     clone (of a clone, ...) of a cloned construction environment.
4232   - When executing a file containing Options() settings, add the file's
4233     directory to sys.path (so modules can be imported from there) and
4234     explicity set __name__ to the name of the file so the statement's
4235     in the file can deduce the location if they need to.
4237   - Fix an O(n^2) performance problem when adding sources to a target
4238     through calls to a multi Builder (including Aliases).
4240   - Redefine the $WINDOWSPROGMANIFESTSUFFIX and
4241     $WINDOWSSHLIBMANIFESTSUFFIX variables so they pick up changes to
4242     the underlying $SHLIBSUFFIX and $PROGSUFFIX variables.
4244   - Add a GetBuildFailures() function that can be called from functions
4245     registered with the Python atexit module to print summary information
4246     about any failures encountered while building.
4248   - Return a NodeList object, not a Python list, when a single_source
4249     Builder like Object() is called with more than one file.
4251   - When searching for implicit dependency files in the directories
4252     in a $*PATH list, don't create Dir Nodes for directories that
4253     don't actually exist on-disk.
4255   - Add a Requires() function to allow the specification of order-only
4256     prerequisites, which will be updated before specified "downstream"
4257     targets but which don't actually cause the target to be rebuilt.
4259   - Restore the FS.{Dir,File,Entry}.rel_path() method.
4261   - Make the default behavior of {Source,Target}Signatures('timestamp')
4262     be equivalent to 'timestamp-match', not 'timestamp-newer'.
4264   - Fix use of CacheDir with Decider('timestamp-newer') by updating
4265     the modification time when copying files from the cache.
4267   - Fix random issues with parallel (-j) builds on Windows when Python
4268     holds open file handles (especially for SCons temporary files,
4269     or targets built by Python function actions) across process creation.
4271   From Maxim Kartashev:
4273   - Fix test scripts when run on Solaris.
4275   From Gary Oberbrunner:
4277   - Fix Glob() when a pattern is in an explicitly-named subdirectory.
4279   From Philipp Scholl:
4281   - Fix setting up targets if multiple Package builders are specified
4282     at once.
4286 RELEASE 0.97.0d20070918 - Tue, 18 Sep 2007 10:51:27 -0500
4288   From Steven Knight:
4290   - Fix the wix Tool module to handle null entries in $PATH variables.
4292   - Move the documentation of Install() and InstallAs() from the list
4293     of functions to the list of Builders (now that they're implemented
4294     as such).
4296   - Allow env.CacheDir() to be set per construction environment.  The
4297     global CacheDir() function now sets an overridable global default.
4299   - Add an env.Decider() method and a Node.Decider() method that allow
4300     flexible specification of an arbitrary function to decide if a given
4301     dependency has changed since the last time a target was built.
4303   - Don't execute Configure actions (while reading SConscript files)
4304     when cleaning (-c) or getting help (-h or -H).
4306   - Add to each target an implicit dependency on the external command(s)
4307     used to build the target, as found by searching env['ENV']['PATH']
4308     for the first argument on each executed command line.
4310   - Add support for a $IMPLICIT_COMMAND_DEPENDENCIES construction
4311     variabe that can be used to disable the automatic implicit
4312     dependency on executed commands.
4314   - Add an "ensure_suffix" keyword to Builder() definitions that, when
4315     true, will add the configured suffix to the targets even if it looks
4316     like they already have a different suffix.
4318   - Add a Progress() function that allows for calling a function or string
4319     (or list of strings) to display progress while walking the DAG.
4321   - Allow ParseConfig(), MergeFlags() and ParseFlags() to handle output
4322     from a *config command with quoted path names that contain spaces.
4324   - Make the Return() function stop processing the SConscript file and
4325     return immediately.  Add a "stop=" keyword argument that can be set
4326     to False to preserve the old behavior.
4328   - Fix use of exitstatfunc on an Action.
4330   - Introduce all man page function examples with "Example:" or "Examples:".
4332   - When a file gets added to a directory, make sure the directory gets
4333     re-scanned for the new implicit dependency.
4335   - Fix handling a file that's specified multiple times in a target
4336     list so that it doesn't cause dependent Nodes to "disappear" from
4337     the dependency graph walk.
4339   From Carsten Koch:
4341   - Avoid race conditions with same-named files and directory creation
4342     when pushing copies of files to CacheDir().
4344   From Tzvetan Mikov:
4346   - Handle $ in Java class names.
4348   From Gary Oberbrunner:
4350   - Add support for the Intel C compiler on Windows64.
4352   - On SGI IRIX, have $SHCXX use $CXX by default (like other platforms).
4354   From Sohail Somani:
4356   - When Cloning a construction environment, set any variables before
4357     applying tools (so the tool module can access the configured settings)
4358     and re-set them after (so they end up matching what the user set).
4360   From Matthias Troffaes:
4362   - Make sure extra auxiliary files generated by some LaTeX packages
4363     and not ending in .aux also get deleted by scons -c.
4365   From Greg Ward:
4367   - Add a $JAVABOOTCLASSPATH variable for directories to be passed to the
4368     javac -bootclasspath option.
4370   From Christoph Wiedemann:
4372   - Add implicit dependencies on the commands used to build a target.
4377 RELEASE 0.97.0d20070809 - Fri, 10 Aug 2007 10:51:27 -0500
4379   From Lars Albertsson:
4381   - Don't error if a #include line happens to match a directory
4382     somewhere on a path (like $CPPPATH, $FORTRANPATH, etc.).
4384   From Mark Bertoglio:
4386   - Fix listing multiple projects in Visual Studio 7.[01] solution files,
4387     including generating individual project GUIDs instead of re-using
4388     the solution GUID.
4390   From Jean Brouwers:
4392   - Add /opt/SUNWspro/bin to the default execution PATH on Solaris.
4394   From Allan Erskine:
4396   - Only expect the Microsoft IDL compiler to emit *_p.c and *_data.c
4397     files if the /proxy and /dlldata switches are used (respectively).
4399   From Steven Knight:
4401   - Have --debug=explain report if a target is being rebuilt because
4402     AlwaysBuild() is specified (instead of "unknown reasons").
4404   - Support {Get,Set}Option('help') to make it easier for SConscript
4405     files to tell if a help option (-h, --help, etc.) has been specified.
4407   - Support {Get,Set}Option('random') so random-dependency interaction
4408     with CacheDir() is controllable from SConscript files.
4410   - Add a new AddOption() function to support user-defined command-
4411     line flags (like --prefix=, --force, etc.).
4413   - Replace modified Optik version with new optparse compatibility module
4414     for command line processing in Scripts/SConsOptions.py
4416   - Push and retrieve built symlinks to/from a CacheDir() as actual
4417     symlinks, not by copying the file contents.
4419   - Fix how the Action module handles stringifying the shared library
4420     generator in the Tool/mingw.py module.
4422   - When generating a config.h file, print "#define HAVE_{FEATURE} 1"
4423     instad of just "#define HAVE_{FEATURE}", for more compatibility
4424     with Autoconf-style projects.
4426   - Fix expansion of $TARGET, $TARGETS, $SOURCE and $SOURCES keywords in
4427     Visual C/C++ PDB file names.
4429   - Fix locating Visual C/C++ PDB files in build directories.
4431   - Support an env.AddMethod() method and an AddMethod() global function
4432     for adding a new method, respectively, to a construction environment
4433     or an arbitrary object (such as a class).
4435   - Fix the --debug=time option when the -j option is specified and all
4436     files are up to date.
4438   - Add a $SWIGOUTDIR variable to allow setting the swig -outdir option,
4439     and use it to identify files created by the swig -java option.
4441   - Add a $SWIGPATH variable that specifies the path to be searched
4442     for included SWIG files, Also add related $SWIGINCPREFIX and
4443     $SWIGINCSUFFIX variables that specify the prefix and suffix to
4444     be be added to each $SWIGPATH directory when expanded on the SWIG
4445     command line.
4447   - More efficient copying of construction environments (mostly borrowed
4448     from copy.deepcopy() in the standard Python library).
4450   - When printing --tree=prune output, don't print [brackets] around
4451     source files, only do so for built targets with children.
4453   - Fix interpretation of Builder source arguments when the Builder has
4454     a src_suffix *and* a source_builder and the argument has no suffix.
4456   - Fix use of expansions like ${TARGET.dir} or ${SOURCE.dir} in the
4457     following construction variables:  $FORTRANMODDIR, $JARCHDIR,
4458     $JARFLAGS, $LEXFLAGS, $SWIGFLAGS, $SWIGOUTDIR and $YACCFLAGS.
4460   - Fix dependencies on Java files generated by SWIG so they can be
4461     detected and built in one pass.
4463   - Fix SWIG when used with a BuildDir().
4465   From Leanid Nazdrynau:
4467   - When applying Tool modules after a construction environment has
4468     already been created, don't overwrite existing $CFILESUFFIX and
4469     $CXXFILESUFFIX value.
4471   - Support passing the Java() builder a list of explicit .java files
4472     (not only a list of directories to be scanned for .java files).
4474   - Support passing .java files to the Jar() and JavaH() builders, which
4475     then use the builder underlying the Java() builder to turn them into
4476     .class files.  (That is, the Jar()-Java() chain of builders become
4477     multi-step, like the Program()-Object()-CFile() builders.)
4479   - Support passing SWIG .i files to the Java builders (Java(),
4480     Jar(), JavaH()), to cause intermediate .java files to be created
4481     automatically.
4483   - Add $JAVACLASSPATH and $JAVASOURCEPATH variables, that get added to
4484     the javac "-classpath" and "-sourcepath" options.  (Note that SCons
4485     does *not* currently search these paths for implicit dependencies.)
4487   - Commonize initialization of Java-related builders.
4489   From Jan Nijtmans:
4491   - Find Java anonymous classes when the next token after the name is
4492     an open parenthesis.
4494   From Gary Oberbrunner:
4496   - Fix a code example in the man page.
4498   From Tilo Prutz:
4500   - Add support for the file names that Java 1.5 (and 1.6) generates for
4501     nested anonymous inner classes, which are different from Java 1.4.
4503   From Adam Simpkins:
4505   - Allow worker threads to terminate gracefully when all jobs are
4506     finished.
4508   From Sohail Somani:
4510   - Add LaTeX scanner support for finding dependencies specified with
4511     the \usepackage{} directive.
4515 RELEASE 0.97 - Thu, 17 May 2007 08:59:41 -0500
4517   From Steven Knight:
4519   - Fix a bug that would make parallel builds stop in their tracks if
4520     Nodes that depended on lists that contained some Nodes built together
4521     caused the reference count to drop below 0 if the Nodes were visited
4522     and commands finished in the wrong order.
4524   - Make sure the DirEntryScanner doesn't choke if it's handed something
4525     that's not a directory (Node.FS.Dir) Node.
4529 RELEASE 0.96.96 - Thu, 12 Apr 2007 12:36:25 -0500
4531   NOTE:  This is (Yet) a(nother) pre-release of 0.97 for testing purposes.
4533   From Joe Bloggs:
4535   - Man page fix:  remove cut-and-paste sentence in NoCache() description.
4537   From Dmitry Grigorenko and Gary Oberbrunner:
4539   - Use the Intel C++ compiler, not $CC, to link C++ source.
4541   From Helmut Grohne:
4543   - Fix the man page example of propagating a user's external environment.
4545   From Steven Knight:
4547   - Back out (most of) the Windows registry installer patch, which
4548     seems to not work on some versions of Windows.
4550   - Don't treat Java ".class" attributes as defining an inner class.
4552   - Fix detecting an erroneous Java anonymous class when the first
4553     non-skipped token after a "new" keyword is a closing brace.
4555   - Fix a regression when a CPPDEFINES list contains a tuple, the second
4556     item of which (the option value) is a construction variable expansion
4557     (e.g. $VALUE) and the value of the variable isn't a string.
4559   - Improve the error message if an IOError (like trying to read a
4560     directory as a file) occurs while deciding if a node is up-to-date.
4562   - Fix "maximum recursion" / "unhashable type" errors in $CPPPATH
4563     PathList expansion if a subsidiary expansion yields a stringable,
4564     non-Node object.
4566   - Generate API documentation from the docstrings (using epydoc).
4568   - Fix use of --debug=presub with Actions for out-of-the-box Builders.
4570   - Fix handling nested lists within $CPPPATH, $LIBPATH, etc.
4572   - Fix a "builders_used" AttributeError that real-world Qt initialization
4573     triggered in the refactored suffix handling for Builders.
4575   - Make the reported --debug=time timings meaningful when used with -j.
4576     Better documentation of what the times mean.
4578   - User Guide updates: --random, AlwaysBuild(), --tree=,
4579     --debug=findlibs, --debug=presub, --debug=stacktrace,
4580     --taskmastertrace.
4582   - Document (in both man page and User's Guide) that --implicit-cache
4583     ignores changes in $CPPPATH, $LIBPATH, etc.
4585   From Jean-Baptiste Lab:
4587   - Remove hard-coded dependency on Python 2.2 from Debian packaging files.
4589   From Jeff Mahovsky:
4591   - Handle spaces in the build target name in Visual Studio project files.
4593   From Rob Managan:
4595   - Re-run LaTeX after BibTeX has been re-run in response to a changed
4596     .bib file.
4598   From Joel B. Mohler:
4600   - Make additional TeX auxiliary files (.toc, .idx and .bbl files)
4601     Precious so their removal doesn't affect whether the necessary
4602     sections are included in output PDF or PostScript files.
4604   From Gary Oberbrunner:
4606   - Fix the ability to import modules in the site_scons directory from
4607     a subdirectory.
4609   From Adam Simpkins:
4611   - Make sure parallel (-j) builds all targets even if they show up
4612     multiple times in the child list (as a source and a dependency).
4614   From Matthias Troffaes:
4616   - Don't re-run TeX if the triggering strings (\makeindex, \bibliography
4617     \tableofcontents) are commented out.
4619   From Richard Viney:
4621   - Fix use of custom include and lib paths with Visual Studio 8.
4623   - Select the default .NET Framework SDK Dir based on the version of
4624     Visual Studio being used.
4628 RELEASE 0.96.95 - Mon, 12 Feb 2007 20:25:16 -0600
4630   From Anatoly Techtonik:
4632   - Add the scons.org URL and a package description to the setup.py
4633     arguments.
4635   - Have the Windows installer add a registry entry for scons.bat in the
4636     "App Paths" key, so scons.bat can be executed without adding the
4637     directory to the %PATH%.  (Python itself works this way.)
4639   From Anonymous:
4641   - Fix looking for default paths in Visual Studio 8.0 (and later).
4643   - Add -lm to the list of default D libraries for linking.
4645   From Matt Doar:
4647   - Provide a more complete write-your-own-Scanner example in the man page.
4649   From Ralf W. Grosse-Kunstleve:
4651   - Contributed upstream Python change to our copied subprocess.py module
4652     for more efficient standard input processing.
4654   From Steven Knight:
4656   - Fix the Node.FS.Base.rel_path() method when the two nodes are on
4657     different drive letters.  (This caused an infinite loop when
4658     trying to write .sconsign files.)
4660   - Fully support Scanners that use a dictionary to map file suffixes
4661     to other scanners.
4663   - Support delayed evaluation of the $SPAWN variable to allow selection
4664     of a function via ${} string expansions.
4666   - Add --srcdir as a synonym for -Y/--repository.
4668   - Document limitations of #include "file.h" with Repository().
4670   - Fix use of a toolpath under the source directory of a BuildDir().
4672   - Fix env.Install() with a file name portion that begins with '#'.
4674   - Fix ParseConfig()'s handling of multiple options in a string that's
4675     replaced a *FLAGS construction variable.
4677   - Have the C++ tools initialize common C compilation variables ($CCFLAGS,
4678     $SHCCFLAGS and $_CCCOMCOM) even if the 'cc' Tool isn't loaded.
4680   From Leanid Nazdrynau:
4682   - Fix detection of Java anonymous classes if a newline precedes the
4683     opening brace.
4685   From Gary Oberbrunner:
4687   - Document use of ${} to execute arbitrary Python code.
4689   - Add support for:
4690     1) automatically adding a site_scons subdirectory (in the top-level
4691        SConstruct directory) to sys.path (PYTHONPATH);
4692     2) automatically importing site_scons/site_init.py;
4693     3) automatically adding site_scons/site_tools to the toolpath.
4695   From John Pye:
4697   - Change ParseConfig() to preserve white space in arguments passed in
4698     as a list.
4700   From a smith:
4702   - Fix adding explicitly-named Java inner class files (and any
4703     other file names that may contain a '$') to Jar files.
4705   From David Vitek:
4707   - Add a NoCache() function to mark targets as unsuitable for propagating
4708     to (or retrieving from) a CacheDir().
4710   From Ben Webb:
4712   - If the swig -noproxy option is used, it won't generate a .py file,
4713     so don't emit it as a target that we expect to be built.
4717 RELEASE 0.96.94 - Sun, 07 Jan 2007 18:36:20 -0600
4719   NOTE:  This is a pre-release of 0.97 for testing purposes.
4721   From Anonymous:
4723   - Allow arbitrary white space after a SWIG %module declaration.
4725   From Paul:
4727   - When compiling resources under MinGW, make sure there's a space
4728     between the --include-dir option and its argument.
4730   From Jay Kint:
4732   - Alleviate long command line issues on Windows by executing command
4733     lines directly via os.spawnv() if the command line doesn't need
4734     shell interpretation (has no pipes, redirection, etc.).
4736   From Walter Franzini:
4738   - Exclude additional Debian packaging files from the copyright check.
4740   From Fawad Halim:
4742   - Handle the conflict between the impending Python 2.6 'as' keyword
4743     and our Tool/as.py module name.
4745   From Steven Knight:
4747   - Speed up the Node.FS.Dir.rel_path() method used to generate path names
4748     that get put into the .sconsign* file(s).
4750   - Optimize Node.FS.Base.get_suffix() by computing the suffix once, up
4751     front, when we set the Node's name.  (Duh...)
4753   - Reduce the Memoizer's responsibilities to simply counting hits and
4754     misses when the --debug=memoizer option is used, not to actually
4755     handling the key calculation and memoization itself.  This speeds
4756     up some configurations significantly, and should cause no functional
4757     differences.
4759   - Add a new scons-time script with subcommands for generating
4760     consistent timing output from SCons configurations, extracting
4761     various information from those timings, and displaying them in
4762     different formats.
4764   - Reduce some unnecessary stat() calls from on-disk entry type checks.
4766   - Fix SideEffect() when used with -j, which was badly broken in 0.96.93.
4768   - Propagate TypeError exceptions when evaluating construction variable
4769     expansions up the stack, so users can see what's going on.
4771   - When disambiguating a Node.FS.Entry into a Dir or File, don't look
4772     in the on-disk source directory until we've confirmed there's no
4773     on-disk entry locally and there *is* one in the srcdir.  This avoids
4774     creating a phantom Node that can interfere with dependencies on
4775     directory contents.
4777   - Add an AllowSubstExceptions() function that gives the SConscript
4778     files control over what exceptions cause a string to expand to ''
4779     vs. terminating processing with an error.
4781   - Allow the f90.py and f95.py Tool modules to compile earlier source
4782     source files of earlier Fortran version.
4784   - Fix storing signatures of files retrieved from CacheDir() so they're
4785     correctly identified as up-to-date next invocation.
4787   - Make sure lists of computed source suffixes cached by Builder objects
4788     don't persist across changes to the list of source Builders (so the
4789     addition of suffixes like .ui by the qt.py Tool module take effect).
4791   - Enhance the bootstrap.py script to allow it to be used to execute
4792     SCons more easily from a checked-out source tree.
4794   From Ben Leslie:
4796   - Fix post-Memoizer value caching misspellings in Node.FS._doLookup().
4798   From Rob Managan, Dmitry Mikhin and Joel B. Mohler:
4800   - Handle TeX/LaTeX files in subdirectories by changing directory
4801     before invoking TeX/LaTeX.
4803   - Scan LaTeX files for \bibliography lines.
4805   - Support multiple file names in a "\bibliography{file1,file2}" string.
4807   - Handle TeX warnings about undefined citations.
4809   - Support re-running LaTeX if necessary due to a Table of Contents.
4811   From Dmitry Mikhin:
4813   - Return LaTeX if "Rerun to get citations correct" shows up on the next
4814     line after the "Warning:" string.
4816   From Gary Oberbrunner:
4818   - Add #include lines to fix portability issues in two tests.
4820   - Eliminate some unnecessary os.path.normpath() calls.
4822   - Add a $CFLAGS variable for C-specific options, leaving $CCFLAGS
4823     for options common to C and C++.
4825   From Tom Parker:
4827   - Have the error message print the missing file that Qt can't find.
4829   From John Pye:
4831   - Fix env.MergeFlags() appending to construction variable value of None.
4833   From Steve Robbins:
4835   - Fix the "sconsign" script when the .sconsign.dblite file is explicitly
4836     specified on the command line (and not intuited from the old way of
4837     calling it with just ".sconsign").
4839   From Jose Pablo Ezequiel "Pupeno" Fernandez Silva:
4841   - Give the 'lex' tool knowledge of the additional target files produced
4842     by the flex "--header-file=" and "--tables-file=" options.
4844   - Give the 'yacc' tool knowledge of the additional target files produced
4845     by the bison "-g", "--defines=" and "--graph=" options.
4847   - Generate intermediate files with Objective C file suffixes (.m) when
4848     the lex and yacc source files have appropriate suffixes (.lm and .ym).
4850   From Sohail Somain:
4852   - Have the mslink.py Tool only look for a 'link' executable on Windows
4853     systems.
4855   From Vaclav Smilauer:
4857   - Add support for a "srcdir" keyword argument when calling a Builder,
4858     which will add a srcdir prefix to all non-relative string sources.
4860   From Jonathan Ultis:
4862   - Allow Options converters to take the construction environment as
4863     an optional argument.
4867 RELEASE 0.96.93 - Mon, 06 Nov 2006 00:44:11 -0600
4869   NOTE:  This is a pre-release of 0.97 for testing purposes.
4871   From Anonymous:
4873   - Allow Python Value Nodes to be Builder targets.
4875   From Matthias:
4877   - Only filter Visual Studio common filename prefixes on complete
4878     directory names.
4880   From Chad Austin:
4882   - Fix the build of the SCons documentation on systems that don't
4883     have "python" in the $PATH.
4885   From Ken Boortz:
4887   - Enhance ParseConfig() to recognize options that begin with '+'.
4889   From John Calcote, Elliot Murphy:
4891   - Document ways to override the CCPDBFLAGS variable to use the
4892     Microsoft linker's /Zi option instead of the default /Z7.
4894   From Christopher Drexler:
4896   - Make SCons aware bibtex must be called if any \include files
4897     cause creation of a bibliography.
4899   - Make SCons aware that "\bilbiography" in TeX source files means
4900     that related .bbl and .blg bibliography files will be created.
4901     (NOTE:  This still needs to search for the string in \include files.)
4903   From David Gruener:
4905   - Fix inconsistent handling of Action strfunction arguments.
4907   - Preserve white space in display Action strfunction strings.
4909   From James Y. Knight and Gerard Patel:
4911   - Support creation of shared object files from assembly language.
4913   From Steven Knight:
4915   - Speed up the Taskmaster significantly by avoiding unnecessary
4916     re-scans of Nodes to find out if there's work to be done, having it
4917     track the currently-executed top-level target directly and not
4918     through its presence on the target list, and eliminating some other
4919     minor list(s), method(s) and manipulation.
4921   - Fix the expansion of $TARGET and $SOURCE in the expansion of
4922     $INSTALLSTR displayed for non-environment calls to InstallAs().
4924   - Fix the ability to have an Alias() call refer to a directory
4925     name that's not identified as a directory until later.
4927   - Enhance runtest.py with an option to use QMTest as the harness.
4928     This will become the default behavior as we add more functionality
4929     to the QMTest side.
4931   - Let linking on mingw use the default function that chooses $CC (gcc)
4932     or $CXX (g++) depending on whether there are any C++ source files.
4934   - Work around a bug in early versions of the Python 2.4 profile module
4935     that caused the --profile= option to fail.
4937   - Only call Options validators and converters once when initializing a
4938     construction environment.
4940   - Fix the ability of env.Append() and env.Prepend(), in all known Python
4941     versions, to handle different input value types when the construction
4942     variable being updated is a dictionary.
4944   - Add a --cache-debug option for information about what files it's
4945     looking for in a CacheDir().
4947   - Document the difference in construction variable expansion between
4948     {Action,Builder}() and env.{Action,Builder}().
4950   - Change the name of env.Copy() to env.Clone(), keeping the old name
4951     around for backwards compatibility (with the intention of eventually
4952     phasing it out to avoid confusion with the Copy() Action factory).
4954   From Arve Knudsen:
4956   - Support cleaning and scanning SWIG-generated files.
4958   From Carsten Koch:
4960   - Allow selection of Visual Studio version by setting $MSVS_VERSION
4961     after construction environment initialization.
4963   From Jean-Baptiste Lab:
4965   - Try using zipimport if we can't import Tool or Platform modules
4966     using the normal "imp" module.  This allows SCons to be packaged
4967     using py2exe's all-in-one-zip-file approach.
4969   From Ben Liblit:
4971   - Do not re-scan files if the scanner returns no implicit dependencies.
4973   From Sanjoy Mahajan:
4975   - Change use of $SOURCES to $SOURCE in all TeX-related Tool modules.
4977   From Joel B. Mohler:
4979   - Make SCons aware that "\makeindex" in TeX source files means that
4980     related .ilg, .ind and .idx index files will be created.
4981     (NOTE:  This still needs to search for the string in \include files.)
4983   - Prevent scanning the TeX .aux file for additional files from
4984     trying to remove it twice when the -c option is used.
4986   From Leanid Nazdrynau:
4988   - Give the MSVC RES (resource) Builder a src_builder list and a .rc
4989     src_suffix so other builders can generate .rc files.
4991   From Matthew A. Nicholson:
4993   - Enhance Install() and InstallAs() to handle directory trees as sources.
4995   From Jan Nijtmans:
4997   - Don't use the -fPIC flag when using gcc on Windows (e.g. MinGW).
4999   From Greg Noel:
5001   - Add an env.ParseFlags() method that provides separate logic for
5002     parsing GNU tool chain flags into a dictionary.
5004   - Add an env.MergeFlags() method to apply an arbitrary dictionary
5005     of flags to a construction environment's variables.
5007   From Gary Oberbrunner:
5009   - Fix parsing tripartite Intel C compiler version numbers on Linux.
5011   - Extend the ParseConfig() function to recognize -arch and
5012     -isysroot options.
5014   - Have the error message list the known suffixes when a Builder call
5015     can't build a source file with an unknown suffix.
5017   From Karol Pietrzak:
5019   - Avoid recursive calls to main() in the program snippet used by the
5020     SConf subsystem to test linking against libraries.  This changes the
5021     default behavior of CheckLib() and CheckLibWithHeader() to print
5022     "Checking for C library foo..." instead of "Checking for main()
5023     in C library foo...".
5025   From John Pye:
5027   - Throw an exception if a command called by ParseConfig() or
5028     ParseFlags() returns an error.
5030   From Stefan Seefeld:
5032   - Initial infrastructure for running SCons tests under QMTest.
5034   From Sohail Somani:
5036   - Fix tests that fail due to gcc warnings.
5038   From Dobes Vandermeer:
5040   - In stack traces, print the full paths of SConscript files.
5042   From Atul Varma:
5044   - Fix detection of Visual C++ Express Edition.
5046   From Dobes Vandermeer:
5048   - Let the src_dir option to the SConscript() function affect all the
5049     the source file paths, instead of treating all source files paths
5050     as relative to the SConscript directory itself.
5052   From Nicolas Vigier:
5054   - Fix finding Fortran modules in build directories.
5056   - Fix use of BuildDir() when the source file in the source directory
5057     is a symlink with a relative path.
5059   From Edward Wang:
5061   - Fix the Memoizer when the SCons Python modules are executed from
5062     .pyo files at different locations from where they were compiled.
5064   From Johan Zander:
5066   - Fix missing os.path.join() when constructing the $FRAMEWORKSDKDIR/bin.
5070 RELEASE 0.96.92 - Mon, 10 Apr 2006 21:08:22 -0400
5072   NOTE:  This was a pre-release of 0.97 for testing purposes.
5074   From Anonymous:
5076   - Fix the intelc.py Tool module to not throw an exception if the
5077     only installed version is something other than ia32.
5079   - Set $CCVERSION when using gcc.
5081   From Matthias:
5083   - Support generating project and solution files for Microsoft
5084     Visual Studio version 8.
5086   - Support generating more than one project file for a Microsoft
5087     Visual Studio solution file.
5089   - Add support for a support "runfile" parameter to Microsoft
5090     Visual Studio project file creation.
5092   - Put the project GUID, not the solution GUID, in the right spot
5093     in the solution file.
5095   From Erling Andersen:
5097   - Fix interpretation of Node.FS objects wrapped in Proxy instances,
5098     allowing expansion of things like ${File(TARGET)} in command lines.
5100   From Stanislav Baranov:
5102   - Add a separate MSVSSolution() Builder, with support for the
5103     following new construction variables: $MSVSBUILDCOM, $MSVSCLEANCOM,
5104     $MSVSENCODING, $MSVSREBUILDCOM, $MSVSSCONS, $MSVSSCONSCOM,
5105     $MSVSSCONSFLAGS, $MSVSSCONSCRIPT and $MSVSSOLUTIONCOM.
5107   From Ralph W. Grosse-Kunstleve and Patrick Mezard:
5109   - Remove unneceesary (and incorrect) SCons.Util strings on some function
5110     calls in SCons.Util.
5112   From Bob Halley:
5114   - Fix C/C++ compiler selection on AIX to not always use the external $CC
5115     environment variable.
5117   From August Hörandl:
5119   - Add a scanner for \include and \import files, with support for
5120     searching a directory list in $TEXINPUTS (imported from the external
5121     environment).
5123   - Support $MAKEINDEX, $MAKEINDEXCOM, $MAKEINDEXCOMSTR and
5124     $MAKEINDEXFLAGS for generating indices from .idx files.
5126   From Steven Johnson:
5128   - Add a NoClean() Environment method and function to override removal
5129     of targets during a -c clean, including documentation and tests.
5131   From Steven Knight:
5133   - Check for whether files exist on disk by listing the directory
5134     contents, not calling os.path.exists() file by file.  This is
5135     somewhat more efficient in general, and may be significantly
5136     more efficient on Windows.
5138   - Minor speedups in the internal is_Dict(), is_List() and is_String()
5139     functions.
5141   - Fix a signature refactoring bug that caused Qt header files to
5142     get re-generated every time.
5144   - Don't fail when writing signatures if the .sconsign.dblite file is
5145     owned by a different user (e.g. root) from a previous run.
5147   - When deleting variables from stacked OverrideEnvironments, don't
5148     throw a KeyError if we were able to delte the variable from any
5149     Environment in the stack.
5151   - Get rid of the last indentation tabs in the SCons source files and
5152     add -tt to the Python invocations in the packaging build and the
5153     tests so they don't creep back in.
5155   - In Visual Studio project files, put quotes around the -C directory
5156     so everything works even if the path has spaces in it.
5158   - The Intel Fortran compiler uses -object:$TARGET, not "-o $TARGET",
5159     when building object files on Windows.  Have the the ifort Tool
5160     modify the default command lines appropriately.
5162   - Document the --debug=explain option in the man page.  (How did we
5163     miss this?)
5165   - Add a $LATEXRETRIES variable to allow configuration of the number of
5166     times LaTex can be re-called to try to resolve undefined references.
5168   - Change the order of the arguments to Configure.Checklib() to match
5169     the documentation.
5171   - Handle signature calculation properly when the Python function used
5172     for a FunctionAction is an object method.
5174   - On Windows, assume that absolute path names without a drive letter
5175     refer to the drive on which the SConstruct file lives.
5177   - Add /usr/ccs/bin to the end of the the default external execution
5178     PATH on Solaris.
5180   - Add $PKGCHK and $PKGINFO variables for use on Solaris when searching
5181     for the SunPRO C++ compiler.  Make the default value for $PKGCHK
5182     be /usr/sbin/pgkchk (since /usr/sbin isn't usually on the external
5183     execution $PATH).
5185   - Fix a man page example of overriding variables when calling
5186     SharedLibrary() to also set the $LIBSUFFIXES variable.
5188   - Add a --taskmastertrace=FILE option to give some insight on how
5189     the taskmaster decides what Node to build next.
5191   - Changed the names of the old $WIN32DEFPREFIX, $WIN32DEFSUFFIX,
5192     $WIN32DLLPREFIX and $WIN32IMPLIBPREFIX construction variables to
5193     new $WINDOWSDEFPREFIX, $WINDOWSDEFSUFFIX, $WINDOWSDLLPREFIX and
5194     $WINDOWSIMPLIBPREFIX construction variables.  The old names are now
5195     deprecated, but preserved for backwards compatibility.
5197   - Fix (?) a runtest.py hang on Windows when the --xml option is used.
5199   - Change the message when an error occurs trying to interact with the
5200     file system to report the target(s) in square brackets (as before) and
5201     the actual file or directory that encountered the error afterwards.
5203   From Chen Lee:
5205   - Add x64 support for Microsoft Visual Studio 8.
5207   From Baptiste Lepilleur:
5209   - Support the --debug=memory option on Windows when the Python version
5210     has the win32process and win32api modules.
5212   - Add support for Visual Studio 2005 Pro.
5214   - Fix portability issues in various tests: test/Case.py,
5215     Test/Java/{JAR,JARCHDIR,JARFLAGS,JAVAC,JAVACFLAGS,JAVAH,RMIC}.py,
5216     test/MSVS/vs-{6.0,7.0,7.1,8.0}-exec.py,
5217     test/Repository/{Java,JavaH,RMIC}.py,
5218     test/QT/{generated-ui,installed,up-to-date,warnings}.py,
5219     test/ZIP/ZIP.py.
5221   - Ignore pkgchk errors on Solaris when searching for the C++ compiler.
5223   - Speed up the SCons/EnvironmentTests.py unit tests.
5225   - Add a --verbose= option to runtest.py to print executed commands
5226     and their output at various levels.
5228   From Christian Maaser:
5230   - Add support for Visual Studio Express Editions.
5232   - Add support for Visual Studio 8 *.manifest files, includng
5233     new $WINDOWS_INSERT_MANIFEST, $WINDOWSPROGMANIFESTSUFFIX,
5234     $WINDOWSPROGMANIFESTPREFIX, $WINDOWSPROGMANIFESTSUFFIX,
5235     $WINDOWSSHLIBMANIFESTPREFIX and $WINDOWSSHLIBMANIFESTSUFFIX
5236     construction variables.
5238   From Adam MacBeth:
5240   - Fix detection of additional Java inner classes following use of a
5241     "new" keyword inside an inner class.
5243   From Sanjoy Mahajan:
5245   - Correct TeX-related command lines to just $SOURCE, not $SOURCES
5247   From Patrick Mezard:
5249   - Execute build commands for a command-line target if any of the
5250     files built along with the target is out of date or non-existent,
5251     not just if the command-line target itself is out of date.
5253   - Fix the -n option when used with -c to print all of the targets
5254     that will be removed for a multi-target Builder call.
5256   - If there's no file in the source directory, make sure there isn't
5257     one in the build directory, too, to avoid dangling files left
5258     over from previous runs when a source file is removed.
5260   - Allow AppendUnique() and PrependUnique() to append strings (and
5261     other atomic objects) to lists.
5263   From Joel B. Mohler:
5265   - Extend latex.py, pdflatex.py, pdftex.py and tex.py so that building
5266     from both TeX and LaTeX files uses the same logic to call $BIBTEX
5267     when it's necessary, to call $MAKEINDEX when it's necessary, and to
5268     call $TEX or $LATEX multiple times to handle undefined references.
5270   - Add an emitter to the various TeX builders so that the generated
5271     .aux and .log files also get deleted by the -c option.
5273   From Leanid Nazdrynau:
5275   - Fix the Qt UIC scanner to work with generated .ui files (by using
5276     the FindFile() function instead of checking by-hand for the file).
5278   From Jan Nieuwenhuizen:
5280   - Fix a problem with interpreting quoted argument lists on command lines.
5282   From Greg Noel:
5284   - Add /sw/bin to the default execution PATH on Mac OS X.
5286   From Kian Win Ong:
5288   - When building a .jar file and there is a $JARCHDIR, put the -C
5289     in front of each .class file on the command line.
5291   - Recognize the Java 1.5 enum keyword.
5293   From Asfand Yar Qazi:
5295   - Add /opt/bin to the default execution PATH on all POSIX platforms
5296     (between /usr/local/bin and /bin).
5298   From Jon Rafkind:
5300   - Fix the use of Configure() contexts from nested subsidiary
5301     SConscript files.
5303   From Christoph Schulz:
5305   - Add support for $CONFIGUREDIR and $CONFIGURELOG variables to control
5306     the directory and logs for configuration tests.
5308   - Add support for a $INSTALLSTR variable.
5310   - Add support for $RANLIBCOM and $RANLIBCOMSTR variables (which fixes
5311     a bug when setting $ARCOMSTR).
5313   From Amir Szekely:
5315   - Add use of $CPPDEFINES to $RCCOM (resource file compilation) on MinGW.
5317   From Erick Tryzelaar:
5319   - Fix the error message when trying to report that a given option is
5320     not gettable/settable from an SConscript file.
5322   From Dobes Vandermeer:
5324   - Add support for SCC and other settings in Microsoft Visual
5325     Studio project and solution files:  $MSVS_PROJECT_BASE_PATH,
5326     $MSVS_PROJECT_GUID, $MSVS_SCC_AUX_PATH, $MSVS_SCC_LOCAL_PATH,
5327     $MSVS_SCC_PROJECT_NAME, $MSVS_SCC_PROVIDER,
5329   - Add support for using a $SCONS_HOME variable (imported from the
5330     external environment, or settable internally) to put a shortened
5331     SCons execution line in the Visual Studio project file.
5333   From David J. Van Maren:
5335   - Only filter common prefixes from source files names in Visual Studio
5336     project files if the prefix is a complete (sub)directory name.
5338   From Thad Ward:
5340   - If $MSVSVERSIONS is already set, don't overwrite it with
5341     information from the registry.
5345 RELEASE 0.96.91 - Thu, 08 Sep 2005 07:18:23 -0400
5347   NOTE:  This was a pre-release of 0.97 for testing purposes.
5349   From Chad Austin:
5351   - Have the environment store the toolpath and re-use it to find Tools
5352     modules during later Copy() or Tool() calls (unless overridden).
5354   - Normalize the directory path names in SConsignFile() database
5355     files so the same signature file can interoperate on Windows and
5356     non-Windows systems.
5358   - Make --debug=stacktrace print a stacktrace when a UserError is thrown.
5360   - Remove an old, erroneous cut-and-paste comment in Scanner/Dir.py.
5362   From Stanislav Baranov:
5364   - Make it possible to support with custom Alias (sub-)classes.
5366   - Allow Builders to take empty source lists when called.
5368   - Allow access to both TARGET and SOURCE in $*PATH expansions.
5370   - Allow SConscript files to modify BUILD_TARGETS.
5372   From Timothee Besset:
5374   - Add support for Objective C/C++ .m and .mm file suffixes (for
5375     Mac OS X).
5377   From Charles Crain
5379   - Fix the PharLap linkloc.py module to use target+source arguments
5380     when calling env.subst().
5382   From Bjorn Eriksson:
5384   - Fix an incorrect Command() keyword argument in the man page.
5386   - Add a $TEMPFILEPREFIX variable to control the prefix or flag used
5387     to pass a long-command-line-execution tempfile to a command.
5389   From Steven Knight:
5391   - Enhanced the SCons setup.py script to install man pages on
5392     UNIX/Linux systems.
5394   - Add support for an Options.FormatOptionHelpText() method that can
5395     be overridden to customize the format of Options help text.
5397   - Add a global name for the Entry class (which had already been
5398     documented).
5400   - Fix re-scanning of generated source files for implicit dependencies
5401     when the -j option is used.
5403   - Fix a dependency problem that caused $LIBS scans to not be added
5404     to all of the targets in a multiple-target builder call, which
5405     could cause out-of-order builds when the -j option is used.
5407   - Store the paths of source files and dependencies in the .sconsign*
5408     file(s) relative to the target's directory, not relative to the
5409     top-level SConstruct directory.  This starts to make it possible to
5410     subdivide the dependency tree arbitrarily by putting an SConstruct
5411     file in every directory and using content signatures.
5413   - Add support for $YACCHFILESUFFIX and $YACCHXXFILESUFFIX variables
5414     that accomodate parser generators that write header files to a
5415     different suffix than the hard-coded .hpp when the -d option is used.
5417   - The default behavior is now to store signature information in a
5418     single .sconsign.dblite file in the top-level SConstruct directory.
5419     The old behavior of a separate .sconsign file in each directory can
5420     be specified by calling SConsignFile(None).
5422   - Remove line number byte codes within the signature calculation
5423     of Python function actions, so that changing the location of an
5424     otherwise unmodified Python function doesn't cause rebuilds.
5426   - Fix AddPreAction() and AddPostAction() when an action has more than
5427     one target file:  attach the actions to the Executor, not the Node.
5429   - Allow the source directory of a BuildDir / build_dir to be outside
5430     of the top-level SConstruct directory tree.
5432   - Add a --debug=nomemoizer option that disables the Memoizer for clearer
5433     looks at the counts and profiles of the underlying function calls,
5434     not the Memoizer wrappers.
5436   - Print various --debug= stats even if we exit early (e.g. using -h).
5438   - Really only use the cached content signature value if the file
5439     is older than --max-drift, not just if --max-drift is set.
5441   - Remove support for conversion from old (pre 0.96) .sconsign formats.
5443   - Add support for a --diskcheck option to enable or disable various
5444     on-disk checks:  that File and Dir nodes match on-disk entries;
5445     whether an RCS file exists for a missing source file; whether an
5446     SCCS file exists for a missing source file.
5448   - Add a --raw argument to the sconsign script, so it can print a
5449     raw representation of each entry's NodeInfo dictionary.
5451   - Add the 'f90' and 'f95' tools to the list of Fortran compilers
5452     searched for by default.
5454   - Add the +Z option by default when compiling shared objects on
5455     HP-UX.
5457   From Chen Lee:
5459   - Handle Visual Studio project and solution files in Unicode.
5461   From Sanjoy Mahajan:
5463   - Fix a bad use of Copy() in an example in the man page, and a
5464     bad regular expression example in the man page and User's Guide.
5466   From Shannon Mann:
5468   - Have the Visual Studio project file(s) echo "Starting SCons" before
5469     executing SCons, mainly to work around a quote-stripping bug in
5470     (some versions of?) the Windows cmd command executor.
5472   From Georg Mischler:
5474   - Remove the space after the -o option when invoking the Borland
5475     BCC compiler; some versions apparently require that the file name
5476     argument be concatenated with the option.
5478   From Leanid Nazdrynau:
5480   - Fix the Java parser's handling of backslashes in strings.
5482   From Greg Noel:
5484   - Add construction variables to support frameworks on Mac OS X:
5485     $FRAMEWORKS, $FRAMEWORKPREFIX, $FRAMEWORKPATH, $FRAMEWORKPATHPREFIX.
5487   - Re-order link lines so the -o option always comes right after the
5488     command name.
5490   From Gary Oberbrunner:
5492   - Add support for Intel C++ beta 9.0 (both 32 and 64 bit versions).
5494   - Document the new $FRAMEWORK* variables for Mac OS X.
5496   From Karol Pietrzak:
5498   - Add $RPATH (-R) support to the Sun linker Tool (sunlink).
5500   - Add a description of env.subst() to the man page.
5502   From Chris Prince:
5504   - Look in the right directory, not always the local directory, for a
5505     same-named file or directory conflict on disk.
5507   - On Windows, preserve the external environment's %SYSTEMDRIVE%
5508     variable, too.
5510   From Craig Scott:
5512   - Have the Fortran module emitter look for Fortan modules to be created
5513     relative to $FORTRANMODDIR, not the top-level directory.
5515   - When saving Options to a file, run default values through the
5516     converter before comparing them with the set values.  This correctly
5517     suppresses Boolean Option values from getting written to the saved
5518     file when they're one of the many synonyms for a default True or
5519     False value.
5521   - Fix the Fortran Scanner's ability to handle a module being used
5522     in the same file in which it is defined.
5524   From Steve-o:
5526   - Add the -KPIC option by default when compiling shared objects on
5527     Solaris.
5529   - Change the default suffix for Solaris objects to .o, to conform to
5530     Sun WorkShop's expectations.  Change the profix to so_ so they can
5531     still be differentiated from static objects in the same directory.
5533   From Amir Szekely:
5535   - When calling the resource compiler on MinGW, add --include-dir and
5536     the source directory so it finds the source file.
5538   - Update EnsureSConsVersion() to support revision numbers.
5540   From Greg Ward:
5542   - Fix a misplaced line in the man page.
5546 RELEASE 0.96.90 - Tue, 15 Feb 2005 21:21:12 +0000
5548   NOTE:  This was a pre-release of 0.97 for testing purposes.
5550   From Anonymous:
5552   - Fix Java parsing to avoid erroneously identifying a new array
5553     of class instances as an anonymous inner class.
5555   - Fix a typo in the man page description of PathIsDirCreate.
5557   From Chad Austin:
5559   - Allow Help() to be called multiple times, appending to the help
5560     text each call.
5562   - Allow Tools found on a toolpath to import Python modules from
5563     their local directory.
5565   From Steve Christensen:
5567   - Handle exceptions from Python functions as build actions.
5569   - Add a set of canned PathOption validators:  PathExists (the default),
5570     PathIsFile, PathIsDir and PathIsDirCreate.
5572   From Matthew Doar:
5574   - Add support for .lex and .yacc file suffixes for Lex and Yacc files.
5576   From Eric Frias:
5578   - Huge performance improvement:  wrap the tuples representing an
5579     include path in an object, so that the time it takes to hash the
5580     path doesn't grow porportionally to the length of the path.
5582   From Gottfried Ganssauge:
5584   - Fix SCons on SuSE/AMD-64 Linux by having the wrapper script also
5585     check for the build engine in the parent directory of the Python
5586     library directory (/usr/lib64 instead of /usr/lib).
5588   From Stephen Kennedy:
5590   - Speed up writing the .sconsign file at the end of a run by only
5591     calling sync() once at the end, not after every entry.
5593   From Steven Knight:
5595   - When compiling with Microsoft Visual Studio, don't include the ATL and
5596     MFC directories in the default INCLUDE and LIB environment variables.
5598   - Remove the following deprecated features:  the ParseConfig()
5599     global function (deprecated in 0.93); the misspelled "validater"
5600     keyword to the Options.Add() method (deprecated in 0.91); the
5601     SetBuildSignatureType(), SetContentSignatureType(), SetJobs() and
5602     GetJobs() global functions (deprecated in 0.14).
5604   - Fix problems with corrupting the .sconsign.dblite file when
5605     interrupting builds by writing to a temporary file and renaming,
5606     not writing the file directly.
5608   - Fix a 0.96 regression where when running with -k, targets built from
5609     walking dependencies later on the command line would not realize
5610     that a dependency had failed an earlier build attempt, and would
5611     try to rebuild the dependent targets.
5613   - Change the final messages when using -k and errors occur from
5614     "{building,cleaning} terminated because of errors" to "done
5615     {building,cleaning} targets (errors occurred during {build,clean})."
5617   - Allow Configure.CheckFunc() to take an optional header argument
5618     (already supported by Conftest.py) to specify text at the top of
5619     the compiled test file.
5621   - Fix the --debug=explain output when a Python function action changed
5622     so it prints a meaningful string, not the binary representation of
5623     the function contents.
5625   - Allow a ListOption's default value(s) to be a Python list of specified
5626     values, not just a string containing a comma-separated list of names.
5628   - Add a ParseDepends() function that will parse up a list of explicit
5629     dependencies from a "make depend" style file.
5631   - Support the ability to change directory when executing an Action
5632     through "chdir" keyword arguments to Action and Builder creation
5633     and calls.
5635   - Fix handling of Action ojects (and other callables that don't match
5636     our calling arguments) in construction variable expansions.
5638   - On Win32, install scons.bat in the Python directory when installing
5639     from setup.py.  (The bdist_wininst installer was already doing this.)
5641   - Fix env.SConscript() when called with a list of SConscipt files.
5642     (The SConscript() global function already worked properly.)
5644   - Add a missing newline to the end of the --debug=explain "unknown
5645     reasons" message.
5647   - Enhance ParseConfig() to work properly for spaces in between the -I,
5648     -L and -l options and their arguments.
5650   - Packaging build fix:  Rebuild the files that are use to report the
5651     --version of SCons whenever the development version number changes.
5653   - Fix the ability to specify a target_factory of Dir() to a Builder,
5654     which the default create-a-directory Builder was interfering with.
5656   - Mark a directory as built if it's created as part of the preparation
5657     for another target, to avoid trying to build it again when it comes
5658     up in the target list.
5660   - Allow a function with the right calling signature to be put directly
5661     in an Environment's BUILDERS dictionary, making for easier creation
5662     and use of wrappers (pseudo-Builders) that call other Builders.
5664   - On Python 2.x, wrap lists of Nodes returned by Builders in a UserList
5665     object that adds a method that makes str() object return a string
5666     with all of the Nodes expanded to their path names.  (Builders under
5667     Python 1.5.2 still return lists to avoid TypeErrors when trying
5668     to extend() list, so Python 1.5.2 doesn't get pretty-printing of Node
5669     lists, but everything should still function.)
5671   - Allow Aliases to have actions that will be executed whenever
5672     any of the expanded Alias targets are out of date.
5674   - Fix expansion of env.Command() overrides within target and
5675     source file names.
5677   - Support easier customization of what's displayed by various default
5678     actions by adding lots of new construction variables: $ARCOMSTR,
5679     $ASCOMSTR, $ASPPCOMSTR, $BIBTEXCOMSTR, $BITKEEPERCOMSTR, $CCCOMSTR,
5680     $CVSCOMSTR, $CXXCOMSTR, $DCOMSTR, $DVIPDFCOMSTR, $F77COMSTR,
5681     $F90COMSTR, $F95COMSTR, $FORTRANCOMSTR, $GSCOMSTR, $JARCOMSTR,
5682     $JAVACCOMSTR, $JAVAHCOMSTR, $LATEXCOMSTR, $LEXCOMSTR, $LINKCOMSTR,
5683     $M4COMSTR, $MIDLCOMSTR, $P4COMSTR, $PCHCOMSTR, $PDFLATEXCOMSTR,
5684     $PDFTEXCOMSTR, $PSCOMSTR, $QT_MOCFROMCXXCOMSTR, $QT_MOCFROMHCOMSTR,
5685     $QT_UICCOMSTR, $RCCOMSTR, $REGSVRCOMSTR, $RCS_COCOMSTR, $RMICCOMSTR,
5686     $SCCSCOMSTR, $SHCCCOMSTR, $SHCXXCOMSTR, $SHF77COMSTR, $SHF90COMSTR,
5687     $SHF95COMSTR, $SHFORTRANCOMSTR, $SHLINKCOMSTR, $SWIGCOMSTR,
5688     $TARCOMSTR, $TEXCOMSTR, $YACCCOMSTR and $ZIPCOMSTR.
5690   - Add an optional "map" keyword argument to ListOption() that takes a
5691     dictionary to map user-specified values to legal values from the list
5692     (like EnumOption() already doee).
5694   - Add specific exceptions to try:-except: blocks without any listed,
5695     so that they won't catch and mask keyboard interrupts.
5697   - Make --debug={tree,dtree,stree} print something even when there's
5698     a build failure.
5700   - Fix how Scanners sort the found dependencies so that it doesn't
5701     matter whether the dependency file is in a Repository or not.
5702     This may cause recompilations upon upgrade to this version.
5704   - Make AlwaysBuild() work with Alias and Python value Nodes (making
5705     it much simpler to support aliases like "clean" that just invoke
5706     an arbitrary action).
5708   - Have env.ParseConfig() use AppendUnique() by default to suppress
5709     duplicate entries from multiple calls.  Add a "unique" keyword
5710     argument to allow the old behavior to be specified.
5712   - Allow the library modules imported by an SConscript file to get at
5713     all of the normally-available global functions and variables by saying
5714     "from SCons.Script import *".
5716   - Add a --debug=memoizer option to print Memoizer hit/mass statistics.
5718   - Allow more than one --debug= option to be set at a time.
5720   - Change --debug=count to report object counts before and after
5721     reading SConscript files and before and after building targets.
5723   - Change --debug=memory output to line up the numbers and to better
5724     match (more or less) the headers on the --debug=count columns.
5726   - Speed things up when there are lists of targets and/or sources by
5727     getting rid of some N^2 walks of the lists involved.
5729   - Cache evaluation of LazyActions so we don't create a new object
5730     for each invocation.
5732   - When scanning, don't create Nodes for include files that don't
5733     actually exist on disk.
5735   - Make supported global variables CScanner, DScanner, ProgramScanner and
5736     SourceFileScanner.  Make SourceFileScanner.add_scanner() a supported
5737     part of the public interface.  Keep the old SCons.Defaults.*Scan names
5738     around for a while longer since some people were already using them.
5740   - By default, don't scan directories for on-disk files.  Add a
5741     DirScanner global scanner that can be used in Builders or Command()
5742     calls that want source directory trees scanned for on-disk changes.
5743     Have the Tar() and Zip() Builders use the new DirScanner to preserve
5744     the behavior of rebuilding a .tar or .zip file if any file or
5745     directory under a source tree changes.  Add Command() support for
5746     a source_scanner keyword argument to Command() that can be set to
5747     DirScanner to get this behavior.
5749   - Documentation changes:  Explain that $CXXFLAGS contains $CCFLAGS
5750     by default.  Fix a bad target_factory example in the man page.
5751     Add appendices to the User's Guide to cover the available Tools,
5752     Builders and construction variables.  Comment out the build of
5753     the old Python 10 paper, which doesn't build on all systems and
5754     is old enough at this point that it probably isn't worth the
5755     effort to make it do so.
5757   From Wayne Lee:
5759   - Avoid "maximum recursion limit" errors when removing $(-$) pairs
5760     from long command lines.
5762   From Clive Levinson:
5764   - Make ParseConfig() recognize and add -mno-cygwin to $LINKFLAGS and
5765     $CCFLAGS, and -mwindows to $LINKFLAGS.
5767   From Michael McCracken:
5769   - Add a new "applelink" tool to handle the things like Frameworks and
5770     bundles that Apple has added to gcc for linking.
5772   - Use more appropriate default search lists of linkers, compilers and
5773     and other tools for the 'darwin' platform.
5775   - Add a LoadableModule Builder that builds a bundle on Mac OS X (Darwin)
5776     and a shared library on other systems.
5778   - Improve SWIG tests for use on Mac OS X (Darwin).
5780   From Elliot Murphy:
5782   - Enhance the tests to guarantee persistence of ListOption
5783     values in saved options files.
5785   - Supply the help text when -h is used with the -u, -U or -D options.
5787   From Christian Neeb:
5789   - Fix the Java parser's handling of string definitions to avoid ignoring
5790     subsequent code.
5792   From Han-Wen Nienhuys:
5794   - Optimize variable expansion by:  using the re.sub() method (when
5795     possible); not using "eval" for variables for which we can fetch the
5796     value directory; avoiding slowing substitution logic when there's no
5797     '$' in the string.
5799   From Gary Oberbrunner:
5801   - Add an Environment.Dump() method to print the contents of a
5802     construction environment.
5804   - Allow $LIBS (and similar variables) to contain explicit File Nodes.
5806   - Change ParseConfig to add the found library names directly to the
5807     $LIBS variable, instead of returning them.
5809   - Add ParseConfig() support for the -framework GNU linker option.
5811   - Add a PRINT_CMD_LINE_FUNC construction variable to allow people
5812     to filter (or log) command-line output.
5814   - Print an internal Python stack trace in response to an otherwise
5815     unexplained error when --debug=stacktrace is specified.
5817   - Add a --debug=findlibs option to print what's happening when
5818     the scanner is searching for libraries.
5820   - Allow Tool specifications to be passed a dictionary of keyword
5821     arguments.
5823   - Support an Options default value of None, in which case the variable
5824     will not be added to the construction environment unless it's set
5825     explicitly by the user or from an Options file.
5827   - Avoid copying __builtin__ values into a construction environment's
5828     dictionary when evaluating construction variables.
5830   - Add a new cross-platform intelc.py Tool that can detect and
5831     configure the Intel C++ v8 compiler on both Windows, where it's
5832     named icl, and Linux, where it's named icc.  It also checks that
5833     the directory specified in the Windows registry exists, and sets a
5834     new $INTEL_C_COMPILER_VERSION construction variable to identify the
5835     version being used.  (Niall Douglas contributed an early prototype
5836     of parts of this module.)
5838   - Fix the private Conftest._Have() function so it doesn't change
5839     non-alphanumeric characters to underscores.
5841   - Supply a better error message when a construction variable expansion
5842     has an unknown attribute.
5844   - Documentation changes:  Update the man page to describe use of
5845     filenames or Nodes in $LIBS.
5847   From Chris Pawling:
5849   - Have the linkloc tool use $MSVS_VERSION to select the Microsoft
5850     Visual Studio version to use.
5852   From Kevin Quick:
5854   - Fix the Builder name returned from ListBuilders and other instances
5855     of subclasses of the BuilderBase class.
5857   - Add Builders and construction variables to support rpcgen:
5858     RPCGenClient(), RPCGenHeader(), RPCGenService(), RPCGenXDR(),
5859     $RPCGEN, $RPCGENFLAGS, $RPCGENCLIENTFLAGS, $RPCGENHEADERFLAGS,
5860     $RPCGENSERVICEFLAGS, $RPCGENXDRFLAGS.
5862   - Update the man page to document that prefix and suffix Builder
5863     keyword arguments can be strings, callables or dictionaries.
5865   - Provide more info in the error message when a user tries to build
5866     a target multiple ways.
5868   - Fix Delete() when a file doesn't exist and must_exist=1.  (We were
5869     unintentionally dependent on a bug in versions of the Python shutil.py
5870     module prior to Python 2.3, which would generate an exception for
5871     a nonexistent file even when ignore_errors was set.)
5873   - Only replace a Node's builder with a non-null source builder.
5875   - Fix a stack trace when a suffix selection dictionary is passed
5876     an empty source file list.
5878   - Allow optional names to be attached to Builders, for default
5879     Builders that don't get attached to construction environments.
5881   - Fix problems with Parallel Task Exception handling.
5883   - Build targets in an associated BuildDir even if there are targets
5884     or subdirectories locally in the source directory.
5886   - If a FunctionAction has a callable class as its underlying Python
5887     function, use its strfunction() method (if any) to display the
5888     action.
5890   - Fix handling when BuildDir() exists but is unwriteable.  Add
5891     "Stop." to those error messages for consistency.
5893   - Catch incidents of bad builder creation (without an action) and
5894     supply meaningful error messages.
5896   - Fix handling of src_suffix values that aren't extensions (don't
5897     begin with a '.').
5899   - Don't retrieve files from a CacheDir, but report what would happen,
5900     when the -n option is used.
5902   - Use the source_scanner from the target Node, not the source node
5903     itself.
5905   - Internal Scanners fixes:  Make sure Scanners are only passed Nodes.
5906     Fix how a Scanner.Selector called its base class initialization.
5907     Make comparisons of Scanner objects more robust.  Add a name to
5908     an internal default ObjSourceScanner.
5910   - Add a deprecated warning for use of the old "scanner" keyword argument
5911     to Builder creation.
5913   - Improve the --debug=explain message when the build action changes.
5915   - Test enhancements in SourceCode.py, option-n.py, midl.py.  Better
5916     Command() and Scanner test coverage.  Improved test infrastructure
5917     for -c output.
5919   - Refactor the interface between Action and Executor objects to treat
5920     Actions atomically.
5922   - The --debug=presub option will now report the pre-substitution
5923     each action seprately, instead of reporting the entire list before
5924     executing the actions one by one.
5926   - The --debug=explain option explaining a changed action will now
5927     (more correctly) show pre-substitution action strings, instead of
5928     the commands with substituted file names.
5930   - A Node (file) will now be rebuilt if its PreAction or PostAction
5931     actions change.
5933   - Python Function actions now have their calling signature (target,
5934     source, env) reported correctly when displayed.
5936   - Fix BuildDir()/build_dir handling when the build_dir is underneath
5937     the source directory and trying to use entries from the build_dir
5938     as sources for other targets in the build-dir.
5940   - Fix hard-coding of JDK path names in various Java tests.
5942   - Handle Python stack traces consistently (stop at the SConscript stack
5943     frame, by default) even if the Python source code isn't available.
5945   - Improve the performance of the --debug={tree,dtree} options.
5947   - Add --debug=objects logging of creation of OverrideWarner,
5948     EnvironmentCopy and EnvironmentOverride objects.
5950   - Fix command-line expansion of Python Value Nodes.
5952   - Internal cleanups:  Remove an unnecessary scan argument.  Associate
5953     Scanners only with Builders, not nodes.  Apply overrides once when
5954     a Builder is called, not in multiple places.  Cache results from the
5955     Node.FS.get_suffix() and Node.get_build_env() methods.  Use the Python
5956     md5 modules' hexdigest() method, if there is one.  Have Taskmaster
5957     call get_stat() once for each Node and re-use the value instead of
5958     calling it each time it needs the value.  Have Node.depends_on()
5959     re-use the list from the children() method instead of calling it
5960     multiple times.
5962   - Use the correct scanner if the same source file is used for targets in
5963     two different environments with the same path but different scanners.
5965   - Collect logic for caching values in memory in a Memoizer class,
5966     which cleans up a lot of special-case code in various methods and
5967     caches additional values to speed up most configurations.
5969   - Add a PathAccept validator to the list of new canned PathOption
5970     validators.
5972   From Jeff Squyres:
5974   - Documentation changes:  Use $CPPDEFINES instead of $CCFLAGS in man
5975     page examples.
5977   From Levi Stephen:
5979   - Allow $JARCHDIR to be expanded to other construction variables.
5981   From Christoph Wiedemann:
5983   - Add an Environment.SetDefault() method that only sets values if
5984     they aren't already set.
5986   - Have the qt.py Tool not override variables already set by the user.
5988   - Add separate $QT_BINPATH, $QT_CPPPATH and $QT_LIBPATH variables
5989     so these can be set individually, instead of being hard-wired
5990     relative to $QTDIR.
5992   - The %TEMP% and %TMP% external environment variables are now propagated
5993     automatically to the command execution environment on Windows systems.
5995   - A new --config= command-line option allows explicit control of
5996     of when the Configure() tests are run:  --config=force forces all
5997     checks to be run, --config=cache uses all previously cached values,
5998     --config=auto (the default) runs tests only when dependency analysis
5999     determines it's necessary.
6001   - The Configure() subsystem can now write a config.h file with values
6002     like HAVE_STDIO_H, HAVE_LIBM, etc.
6004   - The Configure() subsystem now executes its checks silently when the
6005     -Q option is specified.
6007   - The Configure() subsystem now reports if a test result is being
6008     taken from cache, and prints the standard output and error output
6009     of tests even when cached.
6011   - Configure() test results are now reported as "yes" or "no" instead of
6012     "ok" or "failed."
6014   - Fixed traceback printing when calling the env.Configure() method
6015     instead of the Configure() global function.
6017   - The Configure() subsystem now caches build failures in a .sconsign
6018     file in the subdirectory, not a .cache file.  This may cause
6019     tests to be re-executed the first time after you install 0.97.
6021   - Additional significant internal cleanups in the Configure() subsystem
6022     and its tests.
6024   - Have the Qt Builder make uic-generated files dependent on the .ui.h
6025     file, if one exists.
6027   - Add a test to make sure that SCons source code does not contain
6028     try:-except: blocks that catch all errors, which potentially catch
6029     and mask keyboard interrupts.
6031   - Fix us of TargetSignatures('content') with the SConf subsystem.
6033   From Russell Yanofsky:
6035   - Add support for the Metrowerks Codewarrior compiler and linker
6036     (mwcc and mwld).
6040 RELEASE 0.96.1 - Mon, 23 Aug 2004 12:55:50 +0000
6042   From Craig Bachelor:
6044   - Handle white space in the executable Python path name within in MSVS
6045     project files by quoting the path.
6047   - Correct the format of a GUID string in a solution (.dsw) file so
6048     MSVS can correctly "build enable" a project.
6050   From Steven Knight:
6052   - Add a must_exist flag to Delete() to let the user control whether
6053     it's an error if the specified entry doesn't exist.  The default
6054     behavior is now to silently do nothing if it doesn't exist.
6056   - Package up the new Platform/darwin.py, mistakenly left out of 0.96.
6058   - Make the scons.bat REM statements into @REM so they aren't printed.
6060   - Make the SCons packaging SConscript files platform independent.
6062   From Anthony Roach:
6064   - Fix scanning of pre-compiled header (.pch) files for #includes,
6065     broken in 0.96.
6069 RELEASE 0.96 - Wed, 18 Aug 2004 13:36:40 +0000
6071   From Chad Austin:
6073   - Make the CacheDir() directory if it doesn't already exist.
6075   - Allow construction variable substitutions in $LIBS specifications.
6077   - Allow the emitter argument to a Builder() to be or expand to a list
6078     of emitter functions, which will be called in sequence.
6080   - Suppress null values in construction variables like $LIBS that use
6081     the internal _concat() function.
6083   - Remove .dll files from the construction variables searched for
6084     libraries that can be fed to Win32 compilers.
6086   From Chad Austin and Christoph Wiedemann:
6088   - Add support for a $RPATH variable to supply a list of directories
6089     to search for shared libraries when linking a program.  Used by
6090     the GNU and IRIX linkers (gnulink and sgilink).
6092   From Charles Crain:
6094   - Restore the ability to do construction variable substitutions in all
6095     kinds of *PATH variables, even when the substitution returns a Node
6096     or other object.
6098   From Tom Epperly:
6100   - Allow the Java() Builder to take more than one source directory.
6102   From Ralf W. Grosse-Kunstleve:
6104   - Have SConsignFile() use, by default, a custom "dblite.py" that we can
6105     control and guarantee to work on all Python versions (or nearly so).
6107   From Jonathan Gurley:
6109   - Add support for the newer "ifort" versions of the Intel Fortran
6110     Compiler for Linux.
6112   From Bob Halley:
6114   - Make the new *FLAGS variable type work with copied Environments.
6116   From Chris Hoeppler:
6118   - Initialize the name of a Scanner.Classic scanner correctly.
6120   From James Juhasz:
6122   - Add support for the .dylib shared library suffix and the -dynamiclib
6123     linker option on Mac OS X.
6125   From Steven Knight:
6127   - Add an Execute() method for executing actions directly.
6129   - Support passing environment override keyword arguments to Command().
6131   - Fix use of $MSVS_IGNORE_IDE_PATHS, which was broken when we added
6132     support for $MSVS_USE_MFC_DIRS last release.
6134   - Make env.Append() and env.Prepend() act like the underlying Python
6135     behavior when the variable being appended to is a UserList object.
6137   - Fix a regression that prevented the Command() global function in
6138     0.95 from working with command-line strings as actions.
6140   - Fix checking out a file from a source code management system when
6141     the env.SourceCode() method was called with an individual file name
6142     or node, not a directory name or node.
6144   - Enhance the Task.make_ready() method to create a list of the
6145     out-of-date Nodes for the task for use by the wrapping interface.
6147   - Allow Scanners to pull the list of suffixes from the construction
6148     environment when the "skeys" keyword argument is a string containing
6149     a construction variable to be expanded.
6151   - Support new $CPPSUFFIXES, $DSUFFIXES $FORTRANSUFFIXES, and
6152     $IDLSUFFIXES.  construction variables that contain the default list
6153     of suffixes to be scanned by a given type of scanner, allowing these
6154     suffix lists to be easily added to or overridden.
6156   - Speed up Node creation when calling a Builder by comparing whether two
6157     Environments are the same object, not if their underlying dictionaries
6158     are equivalent.
6160   - Add a --debug=explain option that reports the reason(s) why SCons
6161     thinks it must rebuild something.
6163   - Add support for functions that return platform-independent Actions
6164     to Chmod(), Copy(), Delete(), Mkdir(), Move() and Touch() files
6165     and/or directories.  Like any other Actions, the returned Action
6166     object may be executed directly using the Execute() global function
6167     or env.Execute() environment method, or may be used as a Builder
6168     action or in an env.Command() action list.
6170   - Add support for the strfunction argument to all types of Actions:
6171     CommandAction, ListAction, and CommandGeneratorAction.
6173   - Speed up turning file system Nodes into strings by caching the
6174     values after we're finished reading the SConscript files.
6176   - Have ParseConfig() recognize and supporting adding the -Wa, -Wl,
6177     and -Wp, flags to ASFLAGS, LINKFLAGS and CPPFLAGS, respectively.
6179   - Change the .sconsign format and the checks for whether a Node is
6180     up-to-date to make dependency checks more efficient and correct.
6182   - Add wrapper Actions to SCons.Defaults for $ASCOM, $ASPPCOM, $LINKCOM,
6183     $SHLINKCOM, $ARCOM, $LEXCOM and $YACCCOM.  This makes it possible
6184     to replace the default print behavior with a custom strfunction()
6185     for each of these.
6187   - When a Node has been built, don't walk the whole tree back to delete
6188     the parents's implicit dependencies, let returning up the normal
6189     Taskmaster descent take care of it for us.
6191   - Add documented support for separate target_scanner and source_scanner
6192     arguments to Builder creation, which allows different scanners to
6193     be applied to source files
6195   - Don't re-install or (re-generate) .h files when a subsidiary #included
6196     .h file changes.  This eliminates incorrect circular dependencies
6197     with .h files generated from other source files.
6199   - Slim down the internal Sig.Calculator class by eliminating methods
6200     whose functionality is now covered by Node methods.
6202   - Document use of the target_factory and source_factory keyword
6203     arguments when creating Builder objects.  Enhance Dir Nodes so that
6204     they can be created with user-specified Builder objects.
6206   - Don't blow up with stack trace when the external $PATH environment
6207     variable isn't set.
6209   - Make Builder calls return lists all the time, even if there's only
6210     one target.  This keeps things consistent and easier to program to
6211     across platforms.
6213   - Add a Flatten() function to make it easier to deal with the Builders
6214     all returning lists of targets, not individual targets.
6216   - Performance optimizations in Node.FS.__doLookup().
6218   - Man page fixes:  formatting typos, misspellings, bad example.
6220   - User's Guide fixes: Fix the signatures of the various example
6221     *Options() calls.  Triple-quote properly a multi-line Split example.
6223   - User's Guide additions:  Chapter describing File and Directory
6224     Nodes.  Section describing declarative nature of SCons functions in
6225     SConscript files.  Better organization and clarification of points
6226     raised by Robert P. J. Day.  Chapter describing SConf (Autoconf-like)
6227     functionality.  Chapter describing how to install Python and
6228     SCons.  Chapter describing Java builds.
6230   From Chris Murray:
6232   - Add a .win32 attribute to force file names to expand with
6233     Windows backslash path separators.
6235   - Fix escaping file names on command lines when the expansion is
6236     concatenated with another string.
6238   - Add support for Fortran 90 and Fortran 95.  This adds $FORTRAN*
6239     variables that specify a default compiler, command-line, flags,
6240     etc. for all Fortran versions, plus separate $F90* and $F95*
6241     variables for when different compilers/flags/etc. must be specified
6242     for different Fortran versions.
6244   - Have individual tools that create libraries override the default
6245     $LIBPREFIX and $LIBSUFFIX values set by the platform.  This makes
6246     it easier to use Microsoft Visual Studio tools on a CygWin platform.
6248   From Gary Oberbrunner:
6250   - Add a --debug=presub option to print actions prior to substitution.
6252   - Add a warning upon use of the override keywords "targets" and
6253     "sources" when calling Builders.  These are usually mistakes which
6254     are otherwise silently (and confusingly) turned into construction
6255     variable overrides.
6257   - Try to find the ICL license file path name in the external environment
6258     and the registry before resorting to the hard-coded path name.
6260   - Add support for fetching command-line keyword=value arguments in
6261     order from an ARGLIST list.
6263   - Avoid stack traces when trying to read dangling symlinks.
6265   - Treat file "extensions" that only contain digits as part of the
6266     file basename.  This supports version numbers as part of shared
6267     library names, for example.
6269   - Avoid problems when there are null entries (None or '') in tool
6270     lists or CPPPATH.
6272   - Add an example and explanation of how to use "tools = ['default', ..."
6273     when creating a construction environment.
6275   - Add a section describing File and Directory Nodes and some of their
6276     attributes and methods.
6278   - Have ParseConfig() add a returned -pthread flag to both $CCFLAGS
6279     and $LINKFLAGS.
6281   - Fix some test portability issues on Mac OS X (darwin).
6283   From Simon Perkins:
6285   - Fix a bug introduced in building shared libraries under MinGW.
6287   From Kevin Quick:
6289   - Handling SCons exceptions according to Pythonic standards.
6291   - Fix test/chained-build.py on systems that execute within one second.
6293   - Fix tests on systems where 'ar' warns about archive creation.
6295   From Anthony Roach:
6297   - Fix use of the --implicit-cache option with timestamp signatures.
6299   - If Visual Studio is installed, assume the C/C++ compiler, the linker
6300     and the MIDL compiler that comes with it are available, too.
6302   - Better error messages when evaluating a construction variable
6303     expansion yields a Python syntax error.
6305   - Change the generation of PDB files when using Visual Studio from
6306     compile time to link time.
6308   From sam th:
6310   - Allow SConf.CheckLib() to search a list of libraries, like the
6311     Autoconf AC_SEARCH_LIBS macro.
6313   - Allow the env.WhereIs() method to take a "reject" argument to
6314     let it weed out specific path names.
6316   From Christoph Wiedemann:
6318   - Add new Moc() and Uic() Builders for more explicit control over
6319     Qt builds, plus new construction variables to control them:
6320     $QT_AUTOSCAN, $QT_DEBUG, $QT_MOCCXXPREFIX, $QT_MOCCXXSUFFIX,
6321     $QT_MOCHPREFIX, $QT_MOCHSUFFIX, $QT_UICDECLPREFIX, $QT_UICDECLSUFFIX,
6322     $QT_UICIMPLPREFIX, $QT_UICIMPLSUFFIX and $QT_UISUFFIX.
6324   - Add a new single_source keyword argument for Builders that enforces
6325     a single source file on calls to the Builder.
6329 RELEASE 0.95 - Mon, 08 Mar 2004 06:43:20 -0600
6331   From Chad Austin:
6333   - Replace print statements with calls to sys.stdout.write() so output
6334     lines stay together when -j is used.
6336   - Add portability fixes for a number of tests.
6338   - Accomodate the fact that Cygwin's os.path.normcase() lies about
6339     the underlying system being case-sensitive.
6341   - Fix an incorrect _concat() call in the $RCINCFLAGS definition for
6342     the mingw Tool.
6344   - Fix a problem with the msvc tool with Python versions prior to 2.3.
6346   - Add support for a "toolpath" Tool() and Environment keyword that
6347     allows Tool modules to be found in specified local directories.
6349   - Work around Cygwin Python's silly fiction that it's using a
6350     case-sensitive file system.
6352   - More robust handling of data in VCComponents.dat.
6354   - If the "env" command is available, spawn commands with the more
6355     general "env -" instead of "env -i".
6357   From Kerim Borchaev:
6359   - Fix a typo in a msvc.py's registry lookup:  "VCComponents.dat", not
6360     "VSComponents.dat".
6362   From Chris Burghart:
6364   - Fix the ability to save/restore a PackageOption to a file.
6366   From Steve Christensen:
6368   - Update the MSVS .NET and MSVC 6.0/7.0 path detection.
6370   From David M. Cooke:
6372   - Make the Fortran scanner case-insensitive for the INCLUDE string.
6374   From Charles Crain:
6376   - If no version of MSVC is detected but the tool is specified,
6377     use the MSVC 6.0 paths by default.
6379   - Ignore any "6.1" version of MSVC found in the registry; this is a
6380     phony version number (created by later service packs?) and would
6381     throw off the logic if the user had any non-default paths configure.
6383   - Correctly detect if the user has independently configured the MSVC
6384     "include," "lib" or "path" in the registry and use the appropriate
6385     values.  Previously, SCons would only use the values if all three
6386     were set in the registry.
6388   - Make sure side-effect nodes are prepare()d before building their
6389     corresponding target.
6391   - Preserve the ability to call BuildDir() multiple times with the
6392     same target and source directory arguments.
6394   From Andy Friesen:
6396   - Add support for the Digital Mars "D" programming language.
6398   From Scott Lystig Fritchie:
6400   - Fix the ability to use a custom _concat() function in the
6401     construction environment when calling _stripixes().
6403   - Make the message about ignoring a missing SConscript file into a
6404     suppressable Warning, not a hard-coded sys.stderr.write().
6406   - If a builder can be called multiple times for a target (because
6407     the sources and overrides are identical, or it's a builder with the
6408     "multi" flag set), allow the builder to be called through multiple
6409     environments so long as the builders have the same signature for
6410     the environments in questions (that is, they're the same action).
6412   From Bob Halley:
6414   - When multiple targets are built by a single action, retrieve all
6415     of them from cache, not just the first target, and exec the build
6416     command if any of the targets isn't present in the cache.
6418   From Zephaniah Hull:
6420   - Fix command-line ARGUMENTS with multiple = in them.
6422   From Steven Knight:
6424   - Fix EnsureSConsVersion() so it checks against the SCons version,
6425     not the Python version, on Pythons with sys.version_info.
6427   - Don't swallow the AttributeError when someone uses an expansion like
6428     $TARGET.bak, so we can supply a more informative error message.
6430   - Fix an odd double-quote escape sequence in the man page.
6432   - Fix looking up a naked drive letter as a directory (Dir('C:')).
6434   - Support using File nodes in the LIBS construction variable.
6436   - Allow the LIBS construction variable to be a single string or File
6437     node, not a list, when only one library is needed.
6439   - Fix typos in the man page:  JAVACHDIR => JARCHDIR; add "for_signature"
6440     to the __call__() example in the "Variable Substitution" section.
6442   - Correct error message spellings of "non-existant" to "non-existent."
6444   - When scanning for libraries to link with, don't append $LIBPREFIXES
6445     or $LIBSUFFIXES values to the $LIBS values if they're already present.
6447   - Add a ZIPCOMPRESSION construction variable to control whether the
6448     internal Python action for the Zip Builder compresses the file or
6449     not.  The default value is zipfile.ZIP_DEFLATED, which generates
6450     a compressed file.
6452   - Refactor construction variable expansion to support recursive
6453     expansion of variables (e.g. CCFLAGS = "$CCFLAGS -g") without going
6454     into an infinite loop.  Support this in all construction variable
6455     overrides, as well as when copying Environments.
6457   - Fix calling Configure() from more than one subsidiary SConscript file.
6459   - Fix the env.Action() method so it returns the correct type of
6460     Action for its argument(s).
6462   - Fix specifying .class files as input to JavaH with the .class suffix
6463     when they weren't generated using the Java Builder.
6465   - Make the check for whether all of the objects going into a
6466     SharedLibrary() are shared work even if the object was built in a
6467     previous run.
6469   - Supply meaningful error messages, not stack traces, if we try to add
6470     a non-Node as a source, dependency, or ignored dependency of a Node.
6472   - Generate MSVS Project files that re-invoke SCons properly regardless
6473     of whether the file was built via scons.bat or scons.py.
6474     (Thanks to Niall Douglas for contributing code and testing.)
6476   - Fix TestCmd.py, runtest.py and specific tests to accomodate being
6477     run from directories whose paths include white space.
6479   - Provide a more useful error message if a construction variable
6480     expansion contains a syntax error during evaluation.
6482   - Fix transparent checkout of implicit dependency files from SCCS
6483     and RCS.
6485   - Added new --debug=count, --debug=memory and --debug=objects options.
6486     --debug=count and --debug=objects only print anything when run
6487     under Python 2.1 or later.
6489   - Deprecate the "overrides" keyword argument to Builder() creation
6490     in favor of using keyword argument values directly (like we do
6491     for builder execution and the like).
6493   - Always use the Builder overrides in substitutions, not just if
6494     there isn't a target-specific environment.
6496   - Add new "rsrcpath" and "rsrcdir" and attributes to $TARGET/$SOURCE,
6497     so Builder command lines can find things in Repository source
6498     directories when using BuildDir.
6500   - Fix the M4 Builder so that it chdirs to the Repository directory
6501     when the input file is in the source directory of a BuildDir.
6503   - Save memory at build time by allowing Nodes to delete their build
6504     environments after they've been built.
6506   - Add AppendUnique() and PrependUnique() Environment methods, which
6507     add values to construction variables like Append() and Prepend()
6508     do, but suppress any duplicate elements in the list.
6510   - Allow the 'qt' tool to still be used successfully from a copied
6511     Environment.  The include and library directories previously ended up
6512     having the same string re-appended to the end, yielding an incorrect
6513     path name.
6515   - Supply a more descriptive error message when the source for a target
6516     can't be found.
6518   - Initialize all *FLAGS variables with objects do the right thing with
6519     appending flags as strings or lists.
6521   - Make things like ${TARGET.dir} work in *PATH construction variables.
6523   - Allow a $MSVS_USE_MFC_DIRS construction variable to control whether
6524     ATL and MFC directories are included in the default INCLUDE and
6525     LIB paths.
6527   - Document the dbm_module argument to the SConsignFile() function.
6529   From Vincent Risi:
6531   - Add support for the bcc32, ilink32 and tlib Borland tools.
6533   From Anthony Roach:
6535   - Supply an error message if the user tries to configure a BuildDir
6536     for a directory that already has one.
6538   - Remove documentation of the still-unimplemented -e option.
6540   - Add -H help text listing the legal --debug values.
6542   - Don't choke if a construction variable is a non-string value.
6544   - Build Type Libraries in the target directory, not the source
6545     directory.
6547   - Add an appendix to the User's Guide showing how to accomplish
6548     various common tasks in Python.
6550   From Greg Spencer:
6552   - Add support for Microsoft Visual Studio 2003 (version 7.1).
6554   - Evaluate $MSVSPROJECTSUFFIX and $MSVSSOLUTIONSUFFIX when the Builder
6555     is invoked, not when the tool is initialized.
6557   From Christoph Wiedemann:
6559   - When compiling Qt, make sure the moc_*.cc files are compiled using
6560     the flags from the environment used to specify the target, not
6561     the environment that first has the Qt Builders attached.
6565 RELEASE 0.94 - Fri, 07 Nov 2003 05:29:48 -0600
6567   From Hartmut Goebel:
6569   - Add several new types of canned functions to help create options:
6570     BoolOption(), EnumOption(), ListOption(), PackageOption(),
6571     PathOption().
6573   From Steven Knight:
6575   - Fix use of CPPDEFINES with C++ source files.
6577   - Fix env.Append() when the operand is an object with a __cmp__()
6578     method (like a Scanner instance).
6580   - Fix subclassing the Environment and Scanner classes.
6582   - Add BUILD_TARGETS, COMMAND_LINE_TARGETS and DEFAULT_TARGETS variables.
6584   From Steve Leblanc:
6586   - SGI fixes:  Fix C++ compilation, add a separate Tool/sgic++.py module.
6588   From Gary Oberbrunner:
6590   - Fix how the man page un-indents after examples in some browsers.
6592   From Vincent Risi:
6594   - Fix the C and C++ tool specifications for AIX.
6598 RELEASE 0.93 - Thu, 23 Oct 2003 07:26:55 -0500
6600   From J.T. Conklin:
6602   - On POSIX, execute commands with the more modern os.spawnvpe()
6603     function, if it's available.
6605   - Scan .S, .spp and .SPP files for C preprocessor dependencies.
6607   - Refactor the Job.Parallel() class to use a thread pool without a
6608     condition variable.  This improves parallel build performance and
6609     handles keyboard interrupts properly when -j is used.
6611   From Charles Crain:
6613   - Add support for a JARCHDIR variable to control changing to a
6614     directory using the jar -C option.
6616   - Add support for detecting Java manifest files when using jar,
6617     and specifying them using the jar m flag.
6619   - Fix some Python 2.2 specific things in various tool modules.
6621   - Support directories as build sources, so that a rebuild of a target
6622     can be triggered if anything underneath the directory changes.
6624   - Have the scons.bat and scons.py files look for the SCons modules
6625     in site-packages as well.
6627   From Christian Engel:
6629   - Support more flexible inclusion of separate C and C++ compilers.
6631   - Use package management tools on AIX and Solaris to find where
6632     the comilers are installed, and what version they are.
6634   - Add support for CCVERSION and CXXVERSION variables for a number
6635     of C and C++ compilers.
6637   From Sergey Fogel:
6639   - Add test cases for the new capabilities to run bibtex and to rerun
6640     latex as needed.
6642   From Ralf W. Grosse-Kunstleve:
6644   - Accomodate anydbm modules that don't have a sync() method.
6646   - Allow SConsignFile() to take an argument specifying the DBM
6647     module to be used.
6649   From Stephen Kennedy:
6651   - Add support for a configurable global .sconsign.dbm file which
6652     can be used to avoid cluttering each directory with an individual
6653     .sconsign file.
6655   From John Johnson:
6657   - Fix (re-)scanning of dependencies in generated or installed
6658     header files.
6660   From Steven Knight:
6662   - The -Q option suppressed too many messages; fix it so that it only
6663     suppresses the Reading/Building messages.
6665   - Support #include when there's no space before the opening quote
6666     or angle bracket.
6668   - Accomodate alphanumeric version strings in EnsurePythonVersion().
6670   - Support arbitrary expansion of construction variables within
6671     file and directory arguments to Builder calls and Environment methods.
6673   - Add Environment-method versions of the following global functions:
6674     Action(), AddPostAction(), AddPreAction(), Alias(), Builder(),
6675     BuildDir(), CacheDir(), Clean(), Configure(), Default(),
6676     EnsurePythonVersion(), EnsureSConsVersion(), Environment(),
6677     Exit(), Export(), FindFile(), GetBuildPath(), GetOption(), Help(),
6678     Import(), Literal(), Local(), Platform(), Repository(), Scanner(),
6679     SConscriptChdir(), SConsignFile(), SetOption(), SourceSignatures(),
6680     Split(), TargetSignatures(), Tool(), Value().
6682   - Add the following global functions that correspond to the same-named
6683     Environment methods:  AlwaysBuild(), Command(), Depends(), Ignore(),
6684     Install(), InstallAs(), Precious(), SideEffect() and SourceCode().
6686   - Add the following global functions that correspond to the default
6687     Builder methods supported by SCons: CFile(), CXXFile(), DVI(), Jar(),
6688     Java(), JavaH(), Library(), M4(), MSVSProject(), Object(), PCH(),
6689     PDF(), PostScript(), Program(), RES(), RMIC(), SharedLibrary(),
6690     SharedObject(), StaticLibrary(), StaticObject(), Tar(), TypeLibrary()
6691     and Zip().
6693   - Rearrange the man page to show construction environment methods and
6694     global functions in the same list, and to explain the difference.
6696   - Alphabetize the explanations of the builder methods in the man page.
6698   - Rename the Environment.Environment class to Enviroment.Base.
6699     Allow the wrapping interface to extend an Environment by using its own
6700     subclass of Environment.Base and setting a new Environment.Environment
6701     variable as the calling entry point.
6703   - Deprecate the ParseConfig() global function in favor of a same-named
6704     construction environment method.
6706   - Allow the Environment.WhereIs() method to take explicit path and
6707     pathext arguments (like the underlying SCons.Util.WhereIs() function).
6709   - Remove the long-obsolete {Get,Set}CommandHandler() functions.
6711   - Enhance env.Append() to suppress null values when appropriate.
6713   - Fix ParseConfig() so it works regardless of initial construction
6714     variable values.
6716     Extend CheckHeader(), CheckCHeader(), CheckCXXHeader() and
6717     CheckLibWithHeader() to accept a list of header files that will be
6718     #included in the test.  The last one in the list is assumed to be
6719     the one being checked for.  (Prototype code contributed by Gerard
6720     Patel and Niall Douglas).
6722   - Supply a warning when -j is used and threading isn't built in to
6723     the current version of Python.
6725   - First release of the User's Guide (finally, and despite a lot
6726     of things still missing from it...).
6728   From Clark McGrew:
6730   - Generalize the action for .tex files so that it will decide whether
6731     a file is TeX or LaTeX, check the .aux output to decide if it should
6732     run bibtex, and check the .log output to re-run LaTeX if needed.
6734   From Bram Moolenaar:
6736   - Split the non-SCons-specific functionality from SConf.py to a new,
6737     re-usable Conftest.py module.
6739   From Gary Oberbrunner:
6741   - Allow a directory to be the target or source or dependency of a
6742     Depends(), Ignore(), Precious() or SideEffect() call.
6744   From Gerard Patel:
6746   - Use the %{_mandir} macro when building our RPM package.
6748   From Marko Rauhamaa:
6750   - Have the closing message say "...terminated because of errors" if
6751     there were any.
6753   From Anthony Roach:
6755   - On Win32 systems, only use "rm" to delete files if Cygwin is being
6756     used.   ("rm" doesn't understand Win32-format path names.)
6758   From Christoph Wiedemann:
6760   - Fix test/SWIG.py to find the Python include directory in all cases.
6762   - Fix a bug in detection of Qt installed on the local system.
6764   - Support returning Python 2.3 BooleanType values from Configure checks.
6766   - Provide an error message if someone mistakenly tries to call a
6767     Configure check from within a Builder function.
6769   - Support calling a Builder when a Configure context is still open.
6771   - Handle interrupts better by eliminating all try:-except: blocks
6772     which caught any and all exceptions, including KeyboardInterrupt.
6774   - Add a --duplicate= option to control how files are duplicated.
6778 RELEASE 0.92 - Wed, 20 Aug 2003 03:45:28 -0500
6780   From Charles Crain and Gary Oberbrunner:
6782   - Fix Tool import problems with the Intel and PharLap linkers.
6784   From Steven Knight
6786   - Refactor the DictCmdGenerator class to be a Selector subclass.
6788   - Allow the DefaultEnvironment() function to take arguments and pass
6789     them to instantiation of the default construction environment.
6791   - Update the Debian package so it uses Python 2.2 and more closely
6792     resembles the currently official Debian packaging info.
6794   From Gerard Patel
6796   - When the yacc -d flag is used, take the .h file base name from the
6797     target .c file, not the source (matching what yacc does).
6801 RELEASE 0.91 - Thu, 14 Aug 2003 13:00:44 -0500
6803   From Chad Austin:
6805   - Support specifying a list of tools when calling Environment.Copy().
6807   - Give a Value Nodes a timestamp of the system time when they're
6808     created, so they'll work when using timestamp-based signatures.
6810   - Add a DefaultEnvironment() function that only creates a default
6811     environment on-demand (for fetching source files, e.g.).
6813   - Portability fix for test/M4.py.
6815   From Steven Knight:
6817   - Tighten up the scons -H help output.
6819   - When the input yacc file ends in .yy and the -d flag is specified,
6820     recognize that a .hpp file (not a .h file) will be created.
6822   - Make builder prefixes work correctly when deducing a target
6823     from a source file name in another directory.
6825   - Documentation fixes: typo in the man page; explain up-front about
6826     not propagating the external environment.
6828   - Use "cvs co -d" instead of "cvs co -p >" when checking out something
6829     from CVS with a specified module name.  This avoids zero-length
6830     files when there is a checkout error.
6832   - Add an "sconsign" script to print the contents of .sconsign files.
6834   - Speed up maintaining the various lists of Node children by using
6835     dictionaries to avoid "x in list" searches.
6837   - Cache the computed list of Node children minus those being Ignored
6838     so it's only calculated once.
6840   - Fix use of the --cache-show option when building a Program()
6841     (or using any other arbitrary action) by making sure all Action
6842     instances have strfunction() methods.
6844   - Allow the source of Command() to be a directory.
6846   - Better error handling of things like raw TypeErrors in SConscripts.
6848   - When installing using "setup.py install --prefix=", suppress the
6849     distutils warning message about adding the (incorrect) library
6850     directory to your search path.
6852   - Correct the spelling of the "validater" option to "validator."
6853     Add a DeprecatedWarning when the old spelling is used.
6855   - Allow a Builder's emitter to be a dictionary that maps source file
6856     suffixes to emitter functions, using the suffix of the first file
6857     in the source list to pick the right one.
6859   - Refactor the creation of the Program, *Object and *Library Builders
6860     so that they're moved out of SCons.Defaults and created on demand.
6862   - Don't split SConscript file names on white space.
6864   - Document the SConscript function's "dirs" and "name" keywords.
6866   - Remove the internal (and superfluous) SCons.Util.argmunge() function.
6868   - Add /TP to the default CXXFLAGS for msvc, so it can compile all
6869     of the suffixes we use as C++ files.
6871   - Allow the "prefix" and "suffix" attributes of a Builder to be
6872     callable objects that return generated strings, or dictionaries
6873     that map a source file suffix to the right prefix/suffix.
6875   - Support a MAXLINELINELENGTH construction variable on Win32 systems
6876     to control when a temporary file is used for long command lines.
6878   - Make how we build .rpm packages not depend on the installation
6879     locations from the distutils being used.
6881   - When deducing a target Node, create it directly from the first
6882     source Node, not by trying to create the right string to pass to
6883     arg2nodes().
6885   - Add support for SWIG.
6887   From Bram Moolenaar:
6889   - Test portability fixes for FreeBSD.
6891   From Gary Oberbrunner:
6893   - Report the target being built in error messages when building
6894     multiple sources from different extensions, or when the target file
6895     extension can't be deduced, or when we don't have an action for a
6896     file suffix.
6898   - Provide helpful error messages when the arguments to env.Install()
6899     are incorrect.
6901   - Fix the value returned by the Node.prevsiginfo() method to conform
6902     to a previous change when checking whether a node is current.
6904   - Supply a stack trace if the Taskmaster catches an exception.
6906   - When using a temporary file for a long link line on Win32 systems,
6907     (also) print the command line that is being executed through the
6908     temporary file.
6910   - Initialize the LIB environment variable when using the Intel
6911     compiler (icl).
6913   - Documentation fixes:  better explain the AlwaysBuild() function.
6915   From Laurent Pelecq:
6917   - When the -debug=pdb option is specified, use pdb.Pdb().runcall() to
6918     call pdb directly, don't call Python recursively.
6920   From Ben Scott:
6922   - Add support for a platform-independent CPPDEFINES variable.
6924   From Christoph Wiedemann:
6926   - Have the g++ Tool actually use g++ in preference to c++.
6928   - Have the gcc Tool actually use gcc in preference to cc.
6930   - Add a gnutools.py test of the GNU tool chain.
6932   - Be smarter about linking: use $CC by default and $CXX only if we're
6933     linking with any C++ objects.
6935   - Avoid SCons hanging when a piped command has a lot of output to read.
6937   - Add QT support for preprocessing .ui files into .c files.
6941 RELEASE 0.90 - Wed, 25 Jun 2003 14:24:52 -0500
6943   From Chad Austin:
6945   - Fix the _concat() documentation, and add a test for it.
6947   - Portability fixes for non-GNU versions of lex and yacc.
6949   From Matt Balvin:
6951   - Fix handling of library prefixes when the subdirectory matches
6952     the prefix.
6954   From Timothee Bessett:
6956   - Add an M4 Builder.
6958   From Charles Crain:
6960   - Use '.lnk' as the suffix on the temporary file for linking long
6961     command lines (necessary for the Phar Lap linkloc linker).
6963   - Save non-string Options values as their actual type.
6965   - Save Options string values that contain a single quote correctly.
6967   - Save any Options values that are changed from the default
6968     Environment values, not just ones changed on the command line or in
6969     an Options file.
6971   - Make closing the Options file descriptor exception-safe.
6973   From Steven Knight:
6975   - SCons now enforces (with an error) that construction variables
6976     must have the same form as valid Python identifiers.
6978   - Fix man page bugs: remove duplicate AddPostAction() description;
6979     document no_import_lib; mention that CPPFLAGS does not contain
6980     $_CPPINCFLAGS; mention that F77FLAGS does not contain $_F77INCFLAGS;
6981     mention that LINKFLAGS and SHLINKFLAGS contains neither $_LIBFLAGS
6982     nor $_LIBDIRFLAGS.
6984   - Eliminate a dependency on the distutils.fancy_getopt module by
6985     copying and pasting its wrap_text() function directly.
6987   - Make the Script.Options() subclass match the underlying base class
6988     implementation.
6990   - When reporting a target is up to date, quote the target like make
6991     (backquote-quote) instead of with double quotes.
6993   - Fix handling of ../* targets when using -U, -D or -u.
6995   From Steve Leblanc:
6997   - Don't update the .sconsign files when run with -n.
6999   From Gary Oberbrunner:
7001   - Add support for the Intel C Compiler (icl.exe).
7003   From Anthony Roach
7005   - Fix Import('*').
7007   From David Snopek
7009   - Fix use of SConf in paths with white space in them.
7011   - Add CheckFunc and CheckType functionality to SConf.
7013   - Fix use of SConf with Builders that return a list of nodes.
7015   From David Snopek and Christoph Wiedemann
7017   - Fix use of the SConf subsystem with SConscriptChdir().
7019   From Greg Spencer
7021   - Check for the existence of MS Visual Studio on disk before using it,
7022     to avoid getting fooled by leftover junk in the registry.
7024   - Add support for MSVC++ .NET.
7026   - Add support for MS Visual Studio project files (DSP, DSW,
7027     SLN and VCPROJ files).
7029   From Christoph Wiedemann
7031   - SConf now works correctly when the -n and -q options are used.
7035 RELEASE 0.14 - Wed, 21 May 2003 05:16:32 -0500
7037   From Chad Austin:
7039   - Use .dll (not .so) for shared libraries on Cygwin; use -fPIC
7040     when compiling them.
7042   - Use 'rm' to remove files under Cygwin.
7044   - Add a PLATFORM variable to construction environments.
7046   - Remove the "platform" argument from tool specifications.
7048   - Propogate PYTHONPATH when running the regression tests so distutils
7049     can be found in non-standard locations.
7051   - Using MSVC long command-line linking when running Cygwin.
7053   - Portability fixes for a lot of tests.
7055   - Add a Value Node class for dependencies on in-core Python values.
7057   From Allen Bierbaum:
7059   - Pass an Environment to the Options validator method, and
7060     add an Options.Save() method.
7062   From Steve Christensen:
7064   - Add an optional sort function argument to the GenerateHelpText()
7065     Options function.
7067   - Evaluate the "varlist" variables when computing the signature of a
7068     function action.
7070   From Charles Crain:
7072   - Parse the source .java files for class names (including inner class
7073     names) to figure out the target .class files that will be created.
7075   - Make Java support work with Repositories and SConscriptChdir(0).
7077   - Pass Nodes, not strings, to Builder emitter functions.
7079   - Refactor command-line interpolation and signature calculation
7080     so we can use real Node attributes.
7082   From Steven Knight:
7084   - Add Java support (javac, javah, jar and rmic).
7086   - Propagate the external SYSTEMROOT environment variable into ENV on
7087     Win32 systems, so external commands that use sockets will work.
7089   - Add a .posix attribute to PathList expansions.
7091   - Check out CVS source files using POSIX path names (forward slashes
7092     as separators) even on Win32.
7094   - Add Node.clear() and Node.FS.Entry.clear() methods to wipe out a
7095     Node's state, allowing it to be re-evaluated by continuous
7096     integration build interfaces.
7098   - Change the name of the Set{Build,Content}SignatureType() functions
7099     to {Target,Source}Signatures().  Deprecate the old names but support
7100     them for backwards compatibility.
7102   - Add internal SCons.Node.FS.{Dir,File}.Entry() methods.
7104   - Interpolate the null string if an out-of-range subscript is used
7105     for a construction variable.
7107   - Fix the internal Link function so that it properly links or copies
7108     files in subsidiary BuildDir directories.
7110   - Refactor the internal representation of a single execution instance
7111     of an action to eliminate redundant signature calculations.
7113   - Eliminate redundant signature calculations for Nodes.
7115   - Optimize out calling hasattr() before accessing attributes.
7117   - Say "Cleaning targets" (not "Building...") when the -c option is
7118     used.
7120   From Damyan Pepper:
7122   - Quote the "Entering directory" message like Make.
7124   From Stefan Reichor:
7126   - Add support for using Ghostscript to convert Postscript to PDF files.
7128   From Anthony Roach:
7130   - Add a standalone "Alias" function (separate from an Environment).
7132   - Make Export() work for local variables.
7134   - Support passing a dictionary to Export().
7136   - Support Import('*') to import everything that's been Export()ed.
7138   - Fix an undefined exitvalmap on Win32 systems.
7140   - Support new SetOption() and GetOption() functions for setting
7141     various command-line options from with an SConscript file.
7143   - Deprecate the old SetJobs() and GetJobs() functions in favor of
7144     using the new generic {Set,Get}Option() functions.
7146   - Fix a number of tests that searched for a Fortran compiler using the
7147     external PATH instead of what SCons would use.
7149   - Fix the interaction of SideEffect() and BuildDir() so that (for
7150     example) PDB files get put correctly in a BuildDir().
7152   From David Snopek:
7154   - Contribute the "Autoscons" code for Autoconf-like checking for
7155     the existence of libraries, header files and the like.
7157   - Have the Tool() function add the tool name to the $TOOLS
7158     construction variable.
7160   From Greg Spencer:
7162   - Support the C preprocessor #import statement.
7164   - Allow the SharedLibrary() Builder on Win32 systems to be able to
7165     register a newly-built dll using regsvr32.
7167   - Add a Builder for Windows type library (.tlb) files from IDL files.
7169   - Add an IDL scanner.
7171   - Refactor the Fortran, C and IDL scanners to share common logic.
7173   - Add .srcpath and .srcdir attributes to $TARGET and $SOURCE.
7175   From Christoph Wiedemann:
7177   - Integrate David Snopek's "Autoscons" code as the new SConf
7178     configuration subsystem, including caching of values between
7179     runs (using normal SCons dependency mechanisms), tests, and
7180     documentation.
7184 RELEASE 0.13 - Mon, 31 Mar 2003 20:22:00 -0600
7186   From Charles Crain:
7188   - Fix a bug when BuildDir(duplicate=0) is used and SConscript
7189     files are called from within other SConscript files.
7191   - Support (older) versions of Perforce which don't set the Windows
7192     registry.
7196 RELEASE 0.12 - Thu, 27 Mar 2003 23:52:09 -0600
7198   From Charles Crain:
7200   - Added support for the Perforce source code management system.
7202   - Fix str(Node.FS) so that it returns a path relative to the calling
7203     SConscript file's directory, not the top-level directory.
7205   - Added support for a separate src_dir argument to SConscript()
7206     that allows explicit specification of where the source files
7207     for an SConscript file can be found.
7209   - Support more easily re-usable flavors of command generators by
7210     calling callable variables when strings are expanded.
7212   From Steven Knight:
7214   - Added an INSTALL construction variable that can be set to a function
7215     to control how the Install() and InstallAs() Builders install files.
7216     The default INSTALL function now copies, not links, files.
7218   - Remove deprecated features:  the "name" argument to Builder objects,
7219     and the Environment.Update() method.
7221   - Add an Environment.SourceCode() method to support fetching files
7222     from source code systems.  Add factory methods that create Builders
7223     to support BitKeeper, CVS, RCS, and SCCS.  Add support for fetching
7224     files from RCS or SCCS transparently (like GNU Make).
7226   - Make the internal to_String() function more efficient.
7228   - Make the error message the same as other build errors when there's a
7229     problem unlinking a target file in preparation for it being built.
7231   - Make TARGET, TARGETS, SOURCE and SOURCES reserved variable names and
7232     warn if the user tries to set them in a construction environment.
7234   - Add support for Tar and Zip files.
7236   - Better documentation of the different ways to export variables to a
7237     subsidiary SConscript file.  Fix documentation bugs in a tools
7238     example, places that still assumed SCons split strings on white
7239     space, and typos.
7241   - Support fetching arbitrary files from the TARGETS or SOURCES lists
7242     (e.g. ${SOURCES[2]}) when calculating the build signature of a
7243     command.
7245   - Don't silently swallow exceptions thrown by Scanners (or other
7246     exceptions while finding a node's dependent children).
7248   - Push files to CacheDir() before calling the superclass built()
7249     method (which may clear the build signature as part of clearing
7250     cached implicit dependencies, if the file has a source scanner).
7251     (Bug reported by Jeff Petkau.)
7253   - Raise an internal error if we attempt to push a file to CacheDir()
7254     with a build signature of None.
7256   - Add an explicit Exit() function for terminating early.
7258   - Change the documentation to correctly describe that the -f option
7259     doesn't change to the directory in which the specified file lives.
7261   - Support changing directories locally with SConscript directory
7262     path names relative to any SConstruct file specified with -f.
7263     This allows you to build in another directory by simply changing
7264     there and pointing at the SConstruct file in another directory.
7266   - Change the default SConscriptChdir() behavior to change to the
7267     SConscript directory while it's being read.
7269   - Fix an exception thrown when the -U option was used with no
7270     Default() target specified.
7272   - Fix -u so that it builds things in corresponding build directories
7273     when used in a source directory.
7275   From Lachlan O'Dea:
7277   - Add SharedObject() support to the masm tool.
7279   - Fix WhereIs() to return normalized paths.
7281   From Jeff Petkau:
7283   - Don't copy a built file to a CacheDir() if it's already there.
7285   - Avoid partial copies of built files in a CacheDir() by copying
7286     to a temporary file and renaming.
7288   From Anthony Roach:
7290   - Fix incorrect dependency-cycle errors when an Aliased source doesn't
7291     exist.
7295 RELEASE 0.11 - Tue, 11 Feb 2003 05:24:33 -0600
7297   From Chad Austin:
7299   - Add support for IRIX and the SGI MIPSPro tool chain.
7301   - Support using the MSVC tool chain when running Cygwin Python.
7303   From Michael Cook:
7305   - Avoid losing signal bits in the exit status from a command,
7306     helping terminate builds on interrupt (CTRL+C).
7308   From Charles Crain:
7310   - Added new AddPreAction() and AddPostAction() functions that support
7311     taking additional actions before or after building specific targets.
7313   - Add support for the PharLap ETS tool chain.
7315   From Steven Knight:
7317   - Allow Python function Actions to specify a list of construction
7318     variables that should be included in the Action's signature.
7320   - Allow libraries in the LIBS variable to explicitly include the prefix
7321     and suffix, even when using the GNU linker.
7322     (Bug reported by Neal Becker.)
7324   - Use DOS-standard CR-LF line endings in the scons.bat file.
7325     (Bug reported by Gary Ruben.)
7327   - Doc changes:  Eliminate description of deprecated "name" keyword
7328     argument from Builder definition (reported by Gary Ruben).
7330   - Support using env.Append() on BUILDERS (and other dictionaries).
7331     (Bug reported by Bj=F6rn Bylander.)
7333   - Setting the BUILDERS construction variable now properly clears
7334     the previous Builder attributes from the construction Environment.
7335     (Bug reported by Bj=F6rn Bylander.)
7337   - Fix adding a prefix to a file when the target isn't specified.
7338     (Bug reported by Esa Ilari Vuokko.)
7340   - Clean up error messages from problems duplicating into read-only
7341     BuildDir directories or into read-only files.
7343   - Add a CommandAction.strfunction() method, and add an "env" argument
7344     to the FunctionAction.strfunction() method, so that all Action
7345     objects have strfunction() methods, and the functions for building
7346     and returning a string both take the same arguments.
7348   - Add support for new CacheDir() functionality to share derived files
7349     between builds, with related options --cache-disable, --cache-force,
7350     and --cache-show.
7352   - Change the default behavior when no targets are specified to build
7353     everything in the current directory and below (like Make).  This
7354     can be disabled by specifying Default(None) in an SConscript.
7356   - Revamp SCons installation to fix a case-sensitive installation
7357     on Win32 systems, and to add SCons-specific --standard-lib,
7358     --standalone-lib, and --version-lib options for easier user
7359     control of where the libraries get installed.
7361   - Fix the ability to directly import and use Platform and Tool modules
7362     that have been implicitly imported into an Environment().
7364   - Add support for allowing an embedding interface to annotate a node
7365     when it's created.
7367   - Extend the SConscript() function to accept build_dir and duplicate
7368     keyword arguments that function like a BuildDir() call.
7370   From Steve Leblanc:
7372   - Fix the output of -c -n when directories are involved, so it
7373     matches -c.
7375   From Anthony Roach:
7377   - Use a different shared object suffix (.os) when using gcc so shared
7378     and static objects can exist side-by-side in the same directory.
7380   - Allow the same object files on Win32 to be linked into either
7381     shared or static libraries.
7383   - Cache implicit cache values when using --implicit-cache.
7387 RELEASE 0.10 - Thu, 16 Jan 2003 04:11:46 -0600
7389   From Derrick 'dman' Hudson:
7391   - Support Repositories on other file systems by symlinking or
7392     copying files when hard linking won't work.
7394   From Steven Knight:
7396   - Remove Python bytecode (*.pyc) files from the scons-local packages.
7398   - Have FunctionActions print a description of what they're doing
7399     (a representation of the Python call).
7401   - Fix the Install() method so that, like other actions, it prints
7402     what would have happened when the -n option is used.
7404   - Don't create duplicate source files in a BuildDir when the -n
7405     option is used.
7407   - Refactor the Scanner interface to eliminate unnecessary Scanner
7408     calls and make it easier to write efficient scanners.
7410   - Added a "recursive" flag to Scanner creation that specifies the
7411     Scanner should be invoked recursively on dependency files returned
7412     by the scanner.
7414   - Significant performance improvement from using a more efficient
7415     check, throughout the code, for whether a Node has a Builder.
7417   - Fix specifying only the source file to MultiStepBuilders such as
7418     the Program Builder.  (Bug reported by Dean Bair.)
7420   - Fix an exception when building from a file with the same basename as
7421     the subdirectory in which it lives.  (Bug reported by Gerard Patel.)
7423   - Fix automatic deduction of a target file name when there are
7424     multiple source files specified; the target is now deduced from just
7425     the first source file in the list.
7427   - Documentation fixes: better initial explanation of SConscript files;
7428     fix a misformatted "table" in the StaticObject explanation.
7430   From Steven Knight and Steve Leblanc:
7432   - Fix the -c option so it will remove symlinks.
7434   From Steve Leblanc:
7436   - Add a Clean() method to support removing user-specified targets
7437     when using the -c option.
7439   - Add a development script for running SCons through PyChecker.
7441   - Clean up things found by PyChecker (mostly unnecessary imports).
7443   - Add a script to use HappyDoc to create HTML class documentation.
7445   From Lachlan O'Dea:
7447   - Make the Environment.get() method return None by default.
7449   From Anthony Roach:
7451   - Add SetJobs() and GetJobs() methods to allow configuration of the
7452     number of default jobs (still overridden by -j).
7454   - Convert the .sconsign file format from ASCII to a pickled Python
7455     data structure.
7457   - Error message cleanups:  Made consistent the format of error
7458     messages (now all start with "scons: ***") and warning messages (now
7459     all start with "scons: warning:").  Caught more cases with the "Do
7460     not know how to build" error message.
7462   - Added support for the MinGW tool chain.
7464   - Added a --debug=includes option.
7468 RELEASE 0.09 - Thu,  5 Dec 2002 04:48:25 -0600
7470   From Chad Austin:
7472   - Add a Prepend() method to Environments, to append values to
7473     the beginning of construction variables.
7475   From Matt Balvin:
7477   - Add long command-line support to the "lib" Tool (Microsoft library
7478     archiver), too.
7480   From Charles Crain:
7482   - Allow $$ in a string to be passed through as $.
7484   - Support file names with odd characters in them.
7486   - Add support for construction variable substition on scanner
7487     directories (in CPPPATH, F77PATH, LIBPATH, etc.).
7489   From Charles Crain and Steven Knight:
7491   - Add Repository() functionality, including the -Y option.
7493   From Steven Knight:
7495   - Fix auto-deduction of target names so that deduced targets end
7496     up in the same subdirectory as the source.
7498   - Don't remove source files specified on the command line!
7500   - Suport the Intel Fortran Compiler (ifl.exe).
7502   - Supply an error message if there are no command-line or
7503     Default() targets specified.
7505   - Fix the ASPPCOM values for the GNU assembler.
7506     (Bug reported by Brett Polivka.)
7508   - Fix an exception thrown when a Default() directory was specified
7509     when using the -U option.
7511   - Issue a warning when -c can't remove a target.
7513   - Eliminate unnecessary Scanner calls by checking for the
7514     existence of a file before scanning it.  (This adds a generic
7515     hook to check an arbitrary condition before scanning.)
7517   - Add explicit messages to tell when we're "Reading SConscript files
7518     ...," "done reading SConscript files," "Building targets," and
7519     "done building targets."  Add a -Q option to supress these.
7521   - Add separate $SHOBJPREFIX and $SHOBJSUFFIX construction variables
7522     (by default, the same as $OBJPREFIX and $OBJSUFFIX).
7524   - Add Make-like error messages when asked to build a source file,
7525     and before trying to build a file that doesn't have all its source
7526     files (including when an invalid drive letter is used on WIN32).
7528   - Add an scons-local-{version} package (in both .tar.gz and .zip
7529     flavors) to help people who want to ship SCons as a stand-alone
7530     build tool in their software packages.
7532   - Prevent SCons from unlinking files in certain situations when
7533     the -n option is used.
7535   - Change the name of Tool/lib.py to Tool/mslib.py.
7537   From Steven Knight and Anthony Roach:
7539   - Man page:  document the fact that Builder calls return Node objects.
7541   From Steve LeBlanc:
7543   - Refactor option processing to use our own version of Greg Ward's
7544     Optik module, modified to run under Python 1.5.2.
7546   - Add a ParseConfig() command to modify an environment based on
7547     parsing output from a *-config command.
7549   From Jeff Petkau:
7551   - Fix interpretation of '#/../foo' on Win32 systems.
7553   From Anthony Roach:
7555   - Fixed use of command lines with spaces in their arguments,
7556     and use of Nodes with spaces in their string representation.
7558   - Make access and modification times of files in a BuildDir match
7559     the source file, even when hard linking isn't available.
7561   - Make -U be case insensitive on Win32 systems.
7563   - Issue a warning and continue when finding a corrupt .sconsign file.
7565   - Fix using an alias as a dependency of a target so that if one of the
7566     alias' dependencies gets rebuilt, the resulting target will, too.
7568   - Fix differently ordered targets causing unnecessary rebuilds
7569     on case insensitive systems.
7571   - Use os.system() to execute external commands whenever the "env"
7572     utility is available, which is much faster than fork()/exec(),
7573     and fixes the -j option on several platforms.
7575   - Fix use of -j with multiple targets.
7577   - Add an Options() object for friendlier accomodation of command-
7578     line arguments.
7580   - Add support for Microsoft VC++ precompiled header (.pch) files,
7581     debugger (.pdb) files, and resource (.rc) files.
7583   - Don't compute the $_CPPINCFLAGS, $_F77INCFLAGS, $_LIBFLAGS and
7584     $_LIBDIRFLAGS variables each time a command is executed, define
7585     them so they're computed only as needed.  Add a new _concat
7586     function to the Environment that allows people to define their
7587     own similar variables.
7589   - Fix dependency scans when $LIBS is overridden.
7591   - Add EnsurePythonVersion() and EnsureSConsVersion() functions.
7593   - Fix the overly-verbose stack trace on ListBuilder build errors.
7595   - Add a SetContentSignatureType() function, allowing use of file
7596     timestamps instead of MD5 signatures.
7598   - Make -U and Default('source') fail gracefully.
7600   - Allow the File() and Dir() methods to take a path-name string as
7601     the starting directory, in addition to a Dir object.
7603   - Allow the command handler to be selected via the SPAWN, SHELL
7604     and ESCAPE construction variables.
7606   - Allow construction variables to be overridden when a Builder
7607     is called.
7609   From sam th:
7611   - Dynamically check for the existence of utilities with which to
7612     initialize Environments by default.
7616 RELEASE 0.08 - Mon, 15 Jul 2002 12:08:51 -0500
7618   From Charles Crain:
7620   - Fixed a bug with relative CPPPATH dirs when using BuildDir().
7621     (Bug reported by Bob Summerwill.)
7623   - Added a warnings framework and a --warn option to enable or
7624     disable warnings.
7626   - Make the C scanner warn users if files referenced by #include
7627     directives cannot be found and --warn=dependency is specified.
7629   - The BUILDERS construction variable should now be a dictionary
7630     that maps builder names to actions.  Existing uses of lists,
7631     and the Builder name= keyword argument, generate warnings
7632     about use of deprecated features.
7634   - Removed the "shared" keyword argument from the Object and
7635     Library builders.
7637   - Added separated StaticObject, SharedObject, StaticLibrary and
7638     SharedLibrary builders.  Made Object and Library synonyms for
7639     StaticObject and StaticLibrary, respectively.
7641   - Add LIBS and LIBPATH dependencies for shared libraries.
7643   - Removed support for the prefix, suffix and src_suffix arguments
7644     to Builder() to be callable functions.
7646   - Fix handling file names with multiple dots.
7648   - Allow a build directory to be outside of the SConstruct tree.
7650   - Add a FindFile() function that searches for a file node with a
7651     specified name.
7653   - Add $CPPFLAGS to the shared-object command lines for g++ and gcc.
7655   From Charles Crain and Steven Knight:
7657   - Add a "tools=" keyword argument to Environment instantiation,
7658     and a separate Tools() method, for more flexible specification
7659     of tool-specific environment changes.
7661   From Steven Knight:
7663   - Add a "platform=" keyword argument to Environment instantiation,
7664     and a separate Platform() method, for more flexible specification
7665     of platform-specific environment changes.
7667   - Updated README instructions and setup.py code to catch an
7668     installation failure from not having distutils installed.
7670   - Add descriptions to the -H help text for -D, -u and -U so
7671     people can tell them apart.
7673   - Remove the old feature of automatically splitting strings
7674     of file names on white space.
7676   - Add a dependency Scanner for native Fortran "include" statements,
7677     using a new "F77PATH" construction variable.
7679   - Fix C #include scanning to detect file names with characters like
7680     '-' in them.
7682   - Add more specific version / build output to the -v option.
7684   - Add support for the GNU as, Microsoft masm, and nasm assemblers.
7686   - Allow the "target" argument to a Builder call to be omitted, in
7687     which case the target(s) are deduced from the source file(s) and the
7688     Builder's specified suffix.
7690   - Add a tar archive builder.
7692   - Add preliminary support for the OS/2 Platform, including the icc
7693     and ilink Tools.
7695   From Jeff Petkau:
7697   - Fix --implicit-cache if the scanner returns an empty list.
7699   From Anthony Roach:
7701   - Add a "multi" keyword argument to Builder creation that specifies
7702     it's okay to call the builder multiple times for a target.
7704   - Set a "multi" on Aliases so multiple calls will append to an Alias.
7706   - Fix emitter functions' use of path names when using BuildDir or
7707     in subdirectories.
7709   - Fix --implicit-cache causing redundant rebuilds when the header
7710     file list changed.
7712   - Fix --implicit-cache when a file has no implicit dependencies and
7713     its source is generated.
7715   - Make the drive letters on Windows always be the same case, so that
7716     changes in the case of drive letters don't cause a rebuild.
7718   - Fall back to importing the SCons.TimeStamp module if the SCons.MD5
7719     module can't be imported.
7721   - Fix interrupt handling to guarantee that a single interrupt will
7722     halt SCons both when using -j and not.
7724   - Fix .sconsign signature storage so that output files of one build
7725     can be safely used as input files to another build.
7727   - Added a --debug=time option to print SCons execution times.
7729   - Print an error message if a file can't be unlinked before being
7730     built, rather than just silently terminating the build.
7732   - Add a SideEffect() method that can be used to tell the build
7733     engine that a given file is created as a side effect of building
7734     a target.  A file can be specified as a side effect of more than
7735     one build comand, in which case the commands will not be executed
7736     simultaneously.
7738   - Significant performance gains from not using our own version of
7739     the inefficient stock os.path.splitext() method, caching source
7740     suffix computation, code cleanup in MultiStepBuilder.__call__(),
7741     and replicating some logic in scons_subst().
7743   - Add --implicit-deps-changed and --implicit-deps-unchanged options.
7745   - Add a GetLaunchDir() function.
7747   - Add a SetBuildSignatureType() function.
7749   From Zed Shaw:
7751   - Add an Append() method to Environments, to append values to
7752     construction variables.
7754   - Change the name of Update() to Replace().  Keep Update() as a
7755     deprecated synonym, at least for now.
7757   From Terrel Shumway:
7759   - Use a $PYTHON construction variable, initialized to sys.executable,
7760     when using Python to build parts of the SCons packages.
7762   - Use sys.prefix, not sys.exec_prefix, to find pdb.py.
7766 RELEASE 0.07 - Thu,  2 May 2002 13:37:16 -0500
7768   From Chad Austin:
7770   - Changes to build SCons packages on IRIX (and other *NIces).
7772   - Don't create a directory Node when a file already exists there,
7773     and vice versa.
7775   - Add 'dirs' and 'names' keyword arguments to SConscript for
7776     easier specification of subsidiary SConscript files.
7778   From Charles Crain:
7780   - Internal cleanup of environment passing to function Actions.
7782   - Builders can now take arbitrary keyword arguments to create
7783     attributes to be passed to: command generator functions,
7784     FunctionAction functions, Builder emitter functions (below),
7785     and prefix/suffix generator functions (below).
7787   - Command generator functions can now return ANYTHING that can be
7788     converted into an Action (a function, a string, a CommandGenerator
7789     instance, even an ActionBase instance).
7791   - Actions now call get_contents() with the actual target and source
7792     nodes used for the build.
7794   - A new DictCmdGenerator class replaces CompositeBuilder to support
7795     more flexible Builder behavior internally.
7797   - Builders can now take an emitter= keyword argument.  An emitter
7798     is a function that takes target, source, and env argument, then
7799     return a 2-tuple of (new sources, new targets).  The emitter is
7800     called when the Builder is __call__'ed, allowing a user to modify
7801     source and target lists.
7803   - The prefix, suffix and src_suffix Builder arguments now take a
7804     callable as well a string.  The callable is passed the Environment
7805     and any extra Builder keyword arguments and is expected to return
7806     the appropriate prefix or suffix.
7808   - CommandActions can now be a string, a list of command + argument
7809     strings, or a list of commands (strings or lists).
7811   - Added shared library support.  The Object and Library Builders now
7812     take a "shared=1" keyword argument to specify that a shared object
7813     or shared library should be built.  It is an error to try to build
7814     static objects into a shared library or vice versa.
7816   - Win32 support for .def files has been added.  Added the Win32-specific
7817     construction variables $WIN32DEFPREFIX, $WIN32DEFSUFFIX,
7818     $WIN32DLLPREFIX and $WIN32IMPLIBPREFIX.  When building a .dll,
7819     the new construction variable $WIN32_INSERT_DEF, controls whether
7820     the appropriately-named .def file is inserted into the target
7821     list (if not already present).  A .lib file is always added to
7822     a Library build if not present in the list of targets.
7824   - ListBuilder now passes all targets to the action, not just the first.
7826   - Fix so that -c now deletes generated yacc .h files.
7828   - Builder actions and emitter functions can now be initialized, through
7829     construction variables, to things other than strings.
7831   - Make top-relative '#/dir' lookups work like '#dir'.
7833   - Fix for relative CPPPATH directories in subsidiary SConscript files
7834     (broken in 0.06).
7836   - Add a for_signature argument to command generators, so that
7837     generators that need to can return distinct values for the
7838     command signature and for executing the command.
7840   From Alex Jacques:
7842   - Create a better scons.bat file from a py2bat.py script on the Python
7843     mailing list two years ago (modeled after pl2bat.pl).
7845   From Steven Knight:
7847   - Fix so that -c -n does *not* remove the targets!
7849   - Man page:  Add a hierarchical libraries + Program example.
7851   - Support long MSVC linker command lines through a builder action
7852     that writes to a temporary file and uses the magic MSVC "link @file"
7853     argument syntax if the line is longer than 2K characters.
7855   - Fix F77 command-line options on Win32 (use /Fo instead of -o).
7857   - Use the same action to build from .c (lower case) and .C (upper
7858     case) files on case-insensitive systems like Win32.
7860   - Support building a PDF file directly from a TeX or LaTeX file
7861     using pdftex or pdflatex.
7863   - Add a -x option to runtest.py to specify the script being tested.
7864     A -X option indicates it's an executable, not a script to feed
7865     to the Python interpreter.
7867   - Add a Split() function (identical to SCons.Util.argmunge()) for use
7868     in the next release, when Builders will no longer automatically split
7869     strings on white space.
7871   From Steve Leblanc:
7873   - Add the SConscriptChdir() method.
7875   From Anthony Roach:
7877   - Fix --debug=tree when used with directory targets.
7879   - Significant internal restructuring of Scanners and Taskmaster.
7881   - Added new --debug=dtree option.
7883   - Fixes for --profile option.
7885   - Performance improvement in construction variable substitution.
7887   - Implemented caching of content signatures, plus added --max-drift
7888     option to control caching.
7890   - Implemented caching of dependency signatures, enabled by new
7891     --implicit-cache option.
7893   - Added abspath construction variable modifier.
7895   - Added $SOURCE variable as a synonym for $SOURCES[0].
7897   - Write out .sconsign files on error or interrupt so intermediate
7898     build results are saved.
7900   - Change the -U option to -D.  Make a new -U that builds just the
7901     targets from the local SConscript file.
7903   - Fixed use of sys.path so Python modules can be imported from
7904     the SConscript directory.
7906   - Fix for using Aliases with the -u, -U and -D options.
7908   - Fix so that Nodes can be passed to SConscript files.
7910   From Moshe Zadka:
7912   - Changes for official Debian packaging.
7916 RELEASE 0.06 - Thu, 28 Mar 2002 01:24:29 -0600
7918   From Charles Crain:
7920   - Fix command generators to expand construction variables.
7922   - Make FunctionAction arguments be Nodes, not strings.
7924   From Stephen Kennedy:
7926   - Performance:  Use a dictionary, not a list, for a Node's parents.
7928   From Steven Knight:
7930   - Add .zip files to the packages we build.
7932   - Man page:  document LIBS, fix a typo, document ARGUMENTS.
7934   - Added RANLIB and RANLIBFLAGS construction variables.  Only use them
7935     in ARCOM if there's a "ranlib" program on the system.
7937   - Add a configurable CFILESUFFIX for the Builder of .l and .y files
7938     into C files.
7940   - Add a CXXFile Builder that turns .ll and .yy files into .cc files
7941     (configurable via a CXXFILESUFFIX construction variable).
7943   - Use the POSIX-standard lex -t flag, not the GNU-specific -o flag.
7944     (Bug reported by Russell Christensen.)
7946   - Fixed an exception when CPPPATH or LIBPATH is a null string.
7947     (Bug reported by Richard Kiss.)
7949   - Add a --profile=FILE option to make profiling SCons easier.
7951   - Modify the new DVI builder to create .dvi files from LaTeX (.ltx
7952     and .latex) files.
7954   - Add support for Aliases (phony targets).
7956   - Add a WhereIs() method for searching for path names to executables.
7958   - Add PDF and PostScript document builders.
7960   - Add support for compiling Fortran programs from a variety of
7961     suffixes (a la GNU Make):  .f, .F, .for, .FOR, .fpp and .FPP
7963   - Support a CPPFLAGS variable on all default commands that use the
7964     C preprocessor.
7966   From Steve Leblanc:
7968   - Add support for the -U option.
7970   - Allow CPPPATH, LIBPATH and LIBS to be specified as white-space
7971     separated strings.
7973   - Add a document builder to create .dvi files from TeX (.tex) files.
7975   From Anthony Roach:
7977   - Fix:  Construction variables with values of 0 were incorrectly
7978     interpolated as ''.
7980   - Support env['VAR'] to fetch construction variable values.
7982   - Man page:  document Precious().
7986 RELEASE 0.05 - Thu, 21 Feb 2002 16:50:03 -0600
7988   From Chad Austin:
7990   - Set PROGSUFFIX to .exe under Cygwin.
7992   From Charles Crain:
7994   - Allow a library to specified as a command-line source file, not just
7995     in the LIBS construction variable.
7997   - Compensate for a bug in os.path.normpath() that returns '' for './'
7998     on WIN32.
8000   - More performance optimizations:  cache #include lines from files,
8001     eliminate unnecessary calls.
8003   - If a prefix or suffix contains white space, treat the resulting
8004     concatenation as separate arguments.
8006   - Fix irregularities in the way we fetch DevStudio information from
8007     the Windows registry, and in our registry error handling.
8009   From Steven Knight:
8011   - Flush stdout after print so it intermixes correctly with stderr
8012     when redirected.
8014   - Allow Scanners to return a list of strings, and document how to
8015     write your own Scanners.
8017   - Look up implicit (scanned) dependencies relative to the directory
8018     of file being scanned.
8020   - Make writing .sconsign files more robust by first trying to write
8021     to a temp file that gets renamed.
8023   - Create all of the directories for a list of targets before trying
8024     to build any of the targets.
8026   - WIN32 portability fixes in tests.
8028   - Allow the list of variables exported to an SConscript file to be
8029     a UserList, too.
8031   - Document the overlooked LIBPATH construction variable.
8032     (Bug reported by Eicke Godehardt.)
8034   - Fix so that Ignore() ignores indirect, implicit dependencies
8035     (included files), not just direct dependencies.
8037   - Put the man page in the Debian distribution.
8039   - Run HTML docs through tidy to clean up the HTML (for Konqueror).
8041   - Add preliminary support for Unicode strings.
8043   - Efficiency:  don't scan dependencies more than once during the
8044     walk of a tree.
8046   - Fix the -c option so it doesn't stop removing targets if one doesn't
8047     already exist.
8048     (Bug reported by Paul Connell.)
8050   - Fix the --debug=pdb option when run on Windows NT.
8051     (Bug reported by Paul Connell.)
8053   - Add support for the -q option.
8055   From Steve Leblanc:
8057   - Add support for the -u option.
8059   - Add .cc and .hh file suffixes to the C Scanner.
8061   From Anthony Roach:
8063   - Make the scons script return an error code on failures.
8065   - Add support for using code to generate a command to build a target.
8069 RELEASE 0.04 - Wed, 30 Jan 2002 11:09:42 -0600
8071   From Charles Crain:
8073   - Significant performance improvements in the Node.FS and
8074     Scanner subsystems.
8076   - Fix signatures of binary files on Win32 systems.
8078   - Allow LIBS and LIBPATH to be strings, not just arrays.
8080   - Print a traceback if a Python-function builder throws an exception.
8082   From Steven Knight:
8084   - Fix using a directory as a Default(), and allow Default() to
8085     support white space in file names for strings in arrays.
8087   - Man page updates:  corrected some mistakes, documented various
8088     missing Environment methods, alphabetized the construction
8089     variables and other functions, defined begin and end macros for
8090     the example sections, regularized white space separation, fixed
8091     the use of Export() in the Multiple Variants example.
8093   - Function action fixes:  None is now a successful return value.
8094     Exceptions are now reported.  Document function actions.
8096   - Add 'Action' and 'Scanner' to the global keywords so SConscript
8097     files can use them too.
8099   - Removed the Wrapper class between Nodes and Walkers.
8101   - Add examples using Library, LIBS, and LIBPATH.
8103   - The C Scanner now always returns a sorted list of dependencies
8104     so order changes don't cause unnecessary rebuilds.
8106   - Strip $(-$) bracketed text from command lines.  Use this to
8107     surround $_INCDIRS and $_LIBDIRS so we don't rebuild in response
8108     to changes to -I or -L options.
8110   - Add the Ignore() method to ignore dependencies.
8112   - Provide an error message when a nonexistent target is specified
8113     on the command line.
8115   - Remove targets before building them, and add an Environment
8116     Precious() method to override that.
8118   - Eliminate redundant calls to the same builder when the target is a
8119     list of targets:  Add a ListBuilder class that wraps Builders to
8120     handle lists atomically.  Extend the Task class to support building
8121     and updating multiple targets in a single Task.  Simplify the
8122     interface between Task and Taskmaster.
8124   - Add a --debug=pdb option to re-run SCons under the Python debugger.
8126   - Only compute a build signature once for each node.
8128   - Changes to our sys.path[] manipulation to support installation into
8129     an arbitrary --prefix value.
8131   From Steve Leblanc:
8133   - Add var=value command-line arguments.
8137 RELEASE 0.03 - Fri, 11 Jan 2002 01:09:30 -0600
8139   From Charles Crain:
8141   - Performance improvements in the Node.FS and Sig.Calculator classes.
8143   - Add the InstallAs() method.
8145   - Execute commands through an external interpreter (sh, cmd.exe, or
8146     command.com) to handle redirection metacharacters.
8148   - Allow the user to supply a command handler.
8150   From Steven Knight:
8152   - Search both /usr/lib and /usr/local/lib for scons directories by
8153     adding them both to sys.path, with whichever is in sys.prefix first.
8155   - Fix interpreting strings of multiple white-space separated file names
8156     as separate file names, allowing prefixes and suffixes to be appended
8157     to each individually.
8159   - Refactor to move CompositeBuilder initialization logic from the
8160     factory wrapper to the __init__() method, and allow a Builder to
8161     have both an action and a src_builder (or array of them).
8163   - Refactor BuilderBase.__call__() to separate Node creation/lookup
8164     from initialization of the Node's builder information.
8166   - Add a CFile Builder object that supports turning lex (.l) and
8167     yacc (.y) files into .c files.
8169   - Document: variable interpretation attributes; how to propogate
8170     the user's environment variables to executed commands; how to
8171     build variants in multiple BuildDirs.
8173   - Collect String, Dict, and List type-checking in common utility
8174     routines so we can accept User{String,Dict,List}s all over.
8176   - Put the Action factory and classes into their own module.
8178   - Use one CPlusPlusAction in the Object Builder's action dictionary,
8179     instead of letting it create multiple identical instances.
8181   - Document the Install() and InstallAs() methods.
8183   From Steve Leblanc:
8185   - Require that a Builder be given a name argument, supplying a
8186     useful error message when it isn't.
8188   From Anthony Roach:
8190   - Add a "duplicate" keyword argument to BuildDir() that can be set
8191     to prevent linking/copying source files into build directories.
8193   - Add a "--debug=tree" option to print an ASCII dependency tree.
8195   - Fetch the location of the Microsoft Visual C++ compiler(s) from
8196     the Registry, instead of hard-coding the location.
8198   - Made Scanner objects take Nodes, not path names.
8200   - Have the C Scanner cache the #include file names instead of
8201     (re-)scanning the file each time it's called.
8203   - Created a separate class for parent "nodes" of file system roots,
8204     eliminating the need for separate is-parent-null checks everywhere.
8206   - Removed defined __hash__() and __cmp() methods from FS.Entry, in
8207     favor of Python's more efficient built-in identity comparisons.
8211 RELEASE 0.02 - Sun, 23 Dec 2001 19:05:09 -0600
8213   From Charles Crain:
8215   - Added the Install(), BuildDir(), and Export() methods.
8217   - Fix the -C option by delaying setting the top of the FS tree.
8219   - Avoid putting the directory path on the libraries in the LIBS
8220     construction variable.
8222   - Added a GetBuildPath() method to return the full path to the
8223     Node for a specified string.
8225   - Fixed variable substitution in CPPPATH and LIBPATH.
8227   From Steven Knight:
8229   - Fixed the version comment in the scons.bat (the UNIX geek used
8230     # instead of @rem).
8232   - Fix to setup.py so it doesn't require a sys.argv[1] argument.
8234   - Provide make-like warning message for "command not found" and
8235     similar errors.
8237   - Added an EXAMPLES section to the man page.
8239   - Make Default() targets properly relative to their SConscript
8240     file's subdirectory.
8242   From Anthony Roach:
8244   - Documented CXXFLAGS, CXXCOM, and CPPPATH.
8246   - Fixed SCONS_LIB_DIR to work as documented.
8248   - Made Default() accept Nodes as arguments.
8250   - Changed Export() to make it easier to use.
8252   - Added the Import() and Return() methods.
8256 RELEASE 0.01 - Thu Dec 13 19:25:23 CST 2001
8258 A brief overview of important functionality available in release 0.01:
8260   - C and C++ compilation on POSIX and Windows NT.
8262   - Automatic scanning of C/C++ source files for #include dependencies.
8264   - Support for building libraries; setting construction variables
8265     allows creation of shared libraries.
8267   - Library and C preprocessor search paths.
8269   - File changes detected using MD5 signatures.
8271   - User-definable Builder objects for building files.
8273   - User-definable Scanner objects for scanning for dependencies.
8275   - Parallel build (-j) support.
8277   - Dependency cycles detected.
8279   - Linux packages available in RPM and Debian format.
8281   - Windows installer available.