Start the deprecation cycle for the BuildDir() method and the build_dir

keyword parameter.

Several existing tests were still using BuildDir() or build_dir; they were
converted to use VariantDir() and variant_dir.

New tests were added to validate that the --warn=deprecated-build-dir option
and the SetOption method did the right thing.  This led to the discovery that
a commonly-used test pattern provided by the infrastructure gobbled up too
much, causing tests to succeed when they should have failed.  Fixing the
pattern led to other tests needing to be fixed.

In the process, it was discovered that the SCONSFLAG environment variable was
not getting correctly reset to its original value.  Fixing this also caused
additional tests to misbehave, requiring them to be updated.

And test/Sig.py, which tests the deprecated SCons.Sig module, was moved to
the test/Deprecated directory.

All in all, quite a lot of action for what was supposed to be a simple change.

1 files changed, 10 insertions, 5 deletions

diff --git a/src/RELEASE.txt b/src/RELEASE.txt
index 4a21fa7..bc12077 100644
--- a/src/RELEASE.txt
+++ b/src/RELEASE.txt
@@ -1,11 +1,12 @@
-  A new SCons checkpoint release, 2.0.0.alpha.20100508, is now available.
-  The primary purpose of this release is to remove support for
-  Python versions prior to 2.4 and streamline the SCons code base
-  using more modern python idioms.
-  The checkpoint is available at the SCons download page:
+  A new SCons checkpoint release, 2.0.0.beta.yyyymmdd, is now available on
+  the SCons download page:
 
           http://www.scons.org/download.php
 
+  The primary purpose of this release is to remove support for Python
+  versions prior to 2.4 and streamline the SCons code base using more
+  modern python idioms.
+
   A SCons "checkpoint release" is intended to provide early access to
   new features so they can be tested in the field before being released
   for adoption by other software distributions.
@@ -40,6 +41,8 @@
   - All features or usages deprecated in 1.3 should have been removed.
     Uses of formerly-deprecated features should get an error.
 
+  - The BuildDir() method and the build_dir option now get warnings.
+
   CHANGED/ENHANCED EXISTING FUNCTIONALITY
 
   - Any Command() or env.Command() calls that use the following Action
@@ -84,6 +87,8 @@
   DEVELOPMENT
 
   - Code no longer has to be compatible with Python versions back to 1.5.2.
+    Although code is tested with Python 2.3 and is still believed to work,
+    the official new floor is Python 2.4.
 
   Thanks to Greg Noel and Steven Knight for their contributions to this
   release.