Updates for release 3.0.2

5 files changed, 120 insertions, 74 deletions

diff --git a/ReleaseConfig b/ReleaseConfig
index c9d98e3..2e2e1e7 100644..100755
--- a/ReleaseConfig
+++ b/ReleaseConfig
@@ -32,7 +32,7 @@ __revision__ = "__FILE__ __REVISION__ __DATE__ __DEVELOPER__"
 # 'final', the patchlevel is set to the release date.  This value is
 # mandatory and must be present in this file.
 #version_tuple = (2, 2, 0, 'final', 0)
-version_tuple = (3, 1, 0, 'alpha', 0)
+version_tuple = (3, 0, 2, 'final', 0)
 
 # Python versions prior to unsupported_python_version cause a fatal error
 # when that version is used.  Python versions prior to deprecate_python_version
@@ -51,7 +51,7 @@ deprecated_python_version = (2, 7, 0)
 #month_year = 'December 2012'
 
 # If copyright years is not given, the release year is used as the end.
-copyright_years = '2001 - 2017'
+copyright_years = '2001 - 2018'
 
 # Local Variables:
 # tab-width:4
diff --git a/debian/changelog b/debian/changelog
index 8353f7a..7fe610e 100644..100755
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,9 @@
+scons (3.0.2) unstable; urgency=low
+
+  * Maintenance Release
+
+ -- William Deegan <bill@baddogconsulting.com>  Mon, 31 Dec 2018 15:14:21 -0700
+
 scons (3.0.1) unstable; urgency=low
 
   * Maintenance Release
diff --git a/src/Announce.txt b/src/Announce.txt
index 266e6c8..16560a2 100644..100755
--- a/src/Announce.txt
+++ b/src/Announce.txt
@@ -18,7 +18,7 @@ So that everyone using SCons can help each other learn how to use it more
 effectively, please go to http://scons.org/lists.html#users to sign up for
 the scons-users mailing list.
 
-RELEASE 3.1.0.alpha.yyyymmdd - NEW DATE WILL BE INSERTED HERE
+RELEASE 3.0.2 - Mon, 31 Dec 2018 15:14:21 -0700
 
   Please consult the RELEASE.txt file for a summary of changes since the last
   release and consult the CHANGES.txt file for complete a list of changes
@@ -29,7 +29,41 @@ RELEASE 3.1.0.alpha.yyyymmdd - NEW DATE WILL BE INSERTED HERE
        This is the initial release supporting both python 3.5+ and 2.7.x and pypy
        There are some important changes:
 
-       - Any print statements must now use python 3 syntax of "print()"
+      - Properly support versioned shared libraries for MacOS.  We've also introduced two
+        new env variables APPLELINK_CURRENT_VERSION and APPLELINK_COMPATIBILITY_VERSION which will specify
+        what is passed to the linkers -current_version and -compatibility_version flags.  If not specified
+        they will be derived from SHLIBVERSION as such:
+            - APPLELINK_CURRENT_VERSION = SHLIBVERSION
+            - APPLELINK_COMPATIBILITY_VERSION = all but the last digit in SHLIBVERSION with .0 appended.
+            Note that the values of the above will be validated. Valid format for either APPLELINK variable is
+            X[.Y[.Z]] where 0 <= X <= 65535, 0 <= Y <= 255, 0 <= Z <= 255.
+       - Fix issue #2980 with credit to Piotr Bartosik (and William Blevins).  This is an issue where using
+         TimeStamp-MD5 Decider and CacheDir can yield incorrect md5's being written into the .sconsign.  
+         The difference between Piotr Bartosik's patch and the current code is that the more complicated 
+         creation of file to csig map is only done when the count of children for the current node doesn't 
+         match the previous count which is loaded from the sconsign.
+       - Add flag must_exist to SConscript() call to fail on missing script.
+         Not failing on missing script is now considered deprecated, and the first instance will print a
+         deprecation message.
+       - Add xz compression format to packaging choices.
+       - Add Textfile/Substfile to default environment. (issue #3147)
+       - Remove long deprecated SCons.Options which have been replaced by *Variable() 
+         many years ago.
+       - Updated logic for mingw and clang on win32 to search default tool install paths if not
+         found in normal SCons PATH.  If the user specifies PATH or tool specific paths they
+         will be used and the default paths below will be ignored.
+            - Default path for clang/clangxx : C:\Program Files\LLVM\bin
+            - Default path for mingw         : C:\MinGW\bin and/or  C:\mingw-w64\*\mingw64\bin
+            - Key program to locate mingw    : mingw32-make (as the gcc with mingw prefix has no fixed name)
+        - Added virtualenv support. A new function Virtualenv() determines whether
+          SCons runs in a virtualenv. The search PATH may also be extended to
+          prefer executables from the current virtualenv over the ones provided by
+          base environment. New option --enable-virtualenv provided to import some
+          virtualenv-related variables to SCons and extend every env['ENV']['PATH']
+          automatically. New option --ignore-virtualenv disables this. Two
+          environment variables, SCONS_ENABLE_VIRTUALENV and
+          SCONS_IGNORE_VIRTUALENV are supported for the same purpose.
+       - Recognize new java 9, 10, 11 (as 9.0 and 10.0, 11.0)
        - All node content should be in bytes. This is the default in python 2.7.x,
          in Python 3 all strings are by default unicode. byte and/or bytearray
          should be used if you construct content for return by a custom node type's
diff --git a/src/CHANGES.txt b/src/CHANGES.txt
index e96cdbb..d8d566b 100644
--- a/src/CHANGES.txt
+++ b/src/CHANGES.txt
@@ -5,21 +5,10 @@
                             Change Log
 
 
-RELEASE 3.1.0.alpha.yyyymmdd - NEW DATE WILL BE INSERTED HERE
-** Please add to this version's notes ordered by contributors last name. NOT newest at top of list **
+RELEASE 3.0.2 - Mon, 31 Dec 2018 15:14:21 -0700
 
   From Bernard Blackham:
-   - Fixed handling of side-effects in task master (fixes #3013).
-
-  From Ray Donnelly:
-    - Fix the PATH created by scons.bat (and other .bat files) to provide a normalized
-      PATH.  Some pythons in the 3.6 series are no longer able to handle paths which
-      have ".." in them and end up crashing.  This is done by cd'ing into the directory
-      we want to add to the path and then using %CD% to give us the normalized directory
-      See bug filed under Python 3.6: https://bugs.python.org/issue32457.
-      Note: On Win32 PATH's which have not been normalized may cause undefined behavior
-      by other executables being run by SCons (or any subprocesses of executables being run by SCons).
-      Resolving this issue should eliminate that possibility going forward.
+    - Fixed handling of side-effects in task master (fixes #3013).
 
   From William Deegan:
     - Remove long deprecated SCons.Options code and tests.  This removes BoolOption,EnumOption,
@@ -68,9 +57,23 @@ RELEASE 3.1.0.alpha.yyyymmdd - NEW DATE WILL BE INSERTED HERE
       with logic to set HANDLE_FLAG_INHERIT flag on the file handle.  Python 3.4+ automatically sets this according
       to Python docs: https://docs.python.org/3/library/os.html#fd-inheritance
 
+  From Ray Donnelly:
+    - Fix the PATH created by scons.bat (and other .bat files) to provide a normalized
+      PATH.  Some pythons in the 3.6 series are no longer able to handle paths which
+      have ".." in them and end up crashing.  This is done by cd'ing into the directory
+      we want to add to the path and then using %CD% to give us the normalized directory
+      See bug filed under Python 3.6: https://bugs.python.org/issue32457.
+      Note: On Win32 PATH's which have not been normalized may cause undefined behavior
+      by other executables being run by SCons (or any subprocesses of executables being run by SCons).
+      Resolving this issue should eliminate that possibility going forward.
+
   From Andrew Featherstone
     - Removed unused --warn options from the man page and source code.
 
+  From Arda Fu
+    - Fix cpp scanner regex logic to treat ifndef for py3.5+. Previously it was 
+      not properly differentiating between if, ifdef, and ifndef.
+
   From Philipp Maierhöfer
     - Added a __hash__ method to the class Scons.Subst.Literal. Required when substituting Literal
       objects when SCons runs with Python 3.
@@ -208,11 +211,6 @@ RELEASE 3.1.0.alpha.yyyymmdd - NEW DATE WILL BE INSERTED HERE
     - Typo in customized decider example in user guide
     - Replace usage of unittest.TestSuite with unittest.main() (fix #3113)
 
-  From Arda Fu
-    - Fix cpp scanner regex logic to treat ifndef for py3.5+. Previously it was 
-      not properly differentiating between if, ifdef, and ifndef.
-
-
 RELEASE 3.0.1 - Mon, 12 Nov 2017 15:31:33 -0700
 
   From Daniel Moody:
diff --git a/src/RELEASE.txt b/src/RELEASE.txt
index 1334aa3..ca25dec 100644..100755
--- a/src/RELEASE.txt
+++ b/src/RELEASE.txt
@@ -1,73 +1,81 @@
-  A new SCons checkpoint release, 3.0.1, is now available
-  on the SCons download page:
+  A new SCons release, 3.0.2, is now available on the SCons download page:
 
-          http://www.scons.org/download.php
+          https://scons.org/pages/download.html
 
-  XXX The primary purpose of this release ... XXX
 
-  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.
-
-  Note that a checkpoint release is developed using the same test-driven
-  development methodology as all SCons releases.  Existing SCons
-  functionality should all work as it does in previous releases (except
-  for any changes identified in the release notes) and early adopters
-  should be able to use a checkpoint release safely for production work
-  with existing SConscript files.  If not, it represents not only a bug
-  in SCons but also a hole in the regression test suite, and we want to
-  hear about it.
-
-  New features may be more lightly tested than in past releases,
-  especially as concerns their interaction with all of the other
-  functionality in SCons.  We are especially interested in hearing bug
-  reports about new functionality.
-
-  We do not recommend that downstream distributions (Debian, Fedora,
-  etc.) package a checkpoint release, mainly to avoid confusing the
-  "public" release numbering with the long checkpoint release names.
-
-  Here is a summary of the changes since 1.3.0:
+  Here is a summary of the changes since 3.0.1:
 
   NEW FUNCTIONALITY
 
-    - List new features (presumably why a checkpoint is being released)
+    - Properly support versioned shared libraries for MacOS.  We've also introduced two
+      new env variables APPLELINK_CURRENT_VERSION and APPLELINK_COMPATIBILITY_VERSION which will specify
+      what is passed to the linkers -current_version and -compatibility_version flags.  If not specified
+      they will be derived from SHLIBVERSION as such:
+          - APPLELINK_CURRENT_VERSION = SHLIBVERSION
+          - APPLELINK_COMPATIBILITY_VERSION = all but the last digit in SHLIBVERSION with .0 appended.
+          Note that the values of the above will be validated. Valid format for either APPLELINK variable is
+          X[.Y[.Z]] where 0 <= X <= 65535, 0 <= Y <= 255, 0 <= Z <= 255.
+    - Add flag must_exist to SConscript() call to fail on missing script.
+        Not failing on missing script is now considered deprecated, and the first instance will print a
+        deprecation message.
+    - Add xz compression format to packaging choices.
+    - Add Textfile/Substfile to default environment. (issue #3147)
+    - Added virtualenv support. A new function Virtualenv() determines whether
+        SCons runs in a virtualenv. The search PATH may also be extended to
+        prefer executables from the current virtualenv over the ones provided by
+        base environment. New option --enable-virtualenv provided to import some
+        virtualenv-related variables to SCons and extend every env['ENV']['PATH']
+        automatically. New option --ignore-virtualenv disables this. Two
+        environment variables, SCONS_ENABLE_VIRTUALENV and
+        SCONS_IGNORE_VIRTUALENV are supported for the same purpose.
 
   DEPRECATED FUNCTIONALITY
 
-    - List anything that's been deprecated since the last release
+    - Going forward calling SConscript on a non-existing SConscript file will issue a warning.  Currently
+      it will issue a deprecation notice.
 
   CHANGED/ENHANCED EXISTING FUNCTIONALITY
 
-    - List modifications to existing features, where the previous behavior
-      wouldn't actually be considered a bug
+    - Recognize new java 9, 10, 11 (as 9.0 and 10.0, 11.0)
 
   FIXES
 
-    - List fixes of outright bugs
-
-  IMPROVEMENTS
-
-    - List improvements that wouldn't be visible to the user in the
-      documentation:  performance improvements (describe the circumstances
-      under which they would be observed), or major code cleanups
+    - Fix issue #2980 with credit to Piotr Bartosik (and William Blevins).  This is an issue where using
+         TimeStamp-MD5 Decider and CacheDir can yield incorrect md5's being written into the .sconsign.  
+         The difference between Piotr Bartosik's patch and the current code is that the more complicated 
+         creation of file to csig map is only done when the count of children for the current node doesn't 
+         match the previous count which is loaded from the sconsign.
 
-  PACKAGING
 
-    - List changes in the way SCons is packaged and/or released
-
-  DOCUMENTATION
-
-    - List any significant changes to the documentation (not individual
-      typo fixes, even if they're mentioned in src/CHANGES.txt to give
-      the contributor credit)
-
-  DEVELOPMENT
-
-    - List visible changes in the way SCons is developed
-
-  Thanks to CURLY, LARRY, and MOE for their contributions to this release.
+  Thanks to Bernard Blackham, William Deegan, Ray Donnelly, Andrew Featherstone, Arda Fu, 
+  Philipp Maierhöfer,  Matthew Marinets, Fredrik Medley, Daniel Moody, Gary Oberbrunner, 
+  Jonathon Reinhart, Zachary Tessler, Paweł Tomulik, Richard West, Mats Wichmann, Bernhard M. Wiedemann,
+  and Hao Wu for their contributions to this release.
   Contributors are listed alphabetically by their last name.
 
+git shortlog --no-merges -ns 3.0.1..HEAD
+   226  William Deegan
+    79  Daniel Moody
+    72  Mats Wichmann
+    17  Paweł Tomulik
+    16  Andrew Featherstone
+     8  grbd
+     7  maiphi
+     6  Gary Oberbrunner
+     6  Daniel
+     4  Hao Wu
+     3  Gabriel Russell
+     2  MatthewMarinets
+     2  Jonathon Reinhart
+     2  ArdaFu
+     1  Bernhard M. Wiedemann
+     1  Isaac Pascual Monells
+     1  Fredrik Medley
+     1  Philipp Maierhoefer
+     1  Piotr Kasprzyk
+     1  Ray Donnelly
+     1  Zachary Tessler
+     1  cclauss
+
 __COPYRIGHT__
 __FILE__ __REVISION__ __DATE__ __DEVELOPER__