Add a stub compat/_scon_dbm.py module and copy whichdb.whichdb() to
[scons.git] / src / RELEASE.txt
index 3973eb6851225a969f2c3326694436d3b9a52087..6342483d65be32170b8ab19f7cd03b82c1e1b551 100644 (file)
@@ -14,19 +14,19 @@ to solve build problems.  You do not, however, need to know Python to
 use SCons effectively.
 
 So that everyone using SCons can help each other learn how to use it
-more effectively, please sign up for the scons-users mailing list at:
+more effectively, please sign up for the scons-users mailing list using
+the instructions on the following page:
 
-    http://lists.sourceforge.net/lists/listinfo/scons-users
+     http://scons.org/lists.php
 
 
 
-RELEASE 1.2.0.d20090113 - Tue, 13 Jan 2009 02:50:30 -0800
+RELEASE 1.3.0 - Tue, 23 Mar 2010 21:44:19 -0400
 
   Please consult the CHANGES.txt file for a list of specific changes
   since last release.
 
-  Please note the following important changes scheduled for the next
-  minor release (1.3.0):
+  Please note the following important changes in this release:
 
     --  DEPRECATED FEATURES WILL GENERATE MANDATORY WARNINGS IN 1.3.0
 
@@ -34,7 +34,7 @@ RELEASE 1.2.0.d20090113 - Tue, 13 Jan 2009 02:50:30 -0800
         features will still be supported in 1.3.0 but will generate
         mandatory, non-disableable warnings:
 
-            --  Support for Python versions 1.5, 1.6, 2.0 and 2.1.
+            --  Support for Python versions 1.5, 1.6, 2.0, 2.1, 2.2, and 2.3.
             --  The overrides= keyword argument to the Builder() call.
             --  The scanner= keyword argument to the Builder() call.
             --  The BuildDir() function and env.BuildDir() method.
@@ -58,6 +58,44 @@ RELEASE 1.2.0.d20090113 - Tue, 13 Jan 2009 02:50:30 -0800
 
   Please note the following important changes since release 1.2.0:
 
+    --  MICROSOFT VISUAL STUDIO VERSION/ARCH DETECTION HAS CHANGED
+
+        The way SCons detects Visual Studio on Windows has changed in
+        1.3.  By default, it should now use the latest installed
+        Visual Studio version on your machine, and compile for 32 or
+        64 bits according to whether your OS is 32 or 64 bits (32/64
+        bit python makes no difference).
+
+       Two new variables control Visual Studio: MSVC_VERSION and
+       TARGET_ARCH.  These variables ONLY take effect when passed to
+       the Environment() constructor; setting them later has no
+       effect.  To use a non-default Visual Studio version, set
+       MSVC_VERSION to e.g. "8.0" or "7.1".  Setting it to "xxx" (or
+       any nonexistent value) will make it print out the valid
+       versions on your system.  To use a non-default architecture,
+       set TARGET_ARCH to "x86" or "x86_64" (various synonyms are
+       accepted).
+
+       In addition, MSVC_USE_SCRIPT can be used to bypass the 
+       above autodetection; setting it to the path of a Visual
+       Studio .bat file (e.g. vcvars.bat) will cause SCons to
+       run that bat file and extract the relevant variables
+       from the result (typically %INCLUDE%, %LIB%, and %PATH%).
+       Setting MSVC_USE_SCRIPT to None bypasses the Visual Studio
+       autodetection entirely; use this if you are importing
+       the shell env and running SCons in a Visual Studio cmd window.
+
+       Note that if you use MSVS_VERSION to build Visual Studio
+       projects from your SConstructs, MSVS_VERSION must be set to
+       the same version as MSVC_VERSION.
+
+        Support for HOST_OS,HOST_ARCH,TARGET_OS, TARGET_ARCH has been
+        added to allow specifying different target arch than the host 
+        system. This is only supported for Visual Studio/Visual C++
+        at this time.
+
+    --  Support for Latex glossaries and acronyms has been added
+
     --  VISUAL C/C++ PRECOMPILED HEADERS WILL BE REBUILT
 
         Precompiled header files built with Visual C/C++ will be
@@ -80,6 +118,9 @@ RELEASE 1.2.0.d20090113 - Tue, 13 Jan 2009 02:50:30 -0800
         these tools have been redefined to remove unnecessary nested $(
         and $) character strings.
 
+    --  MSVS_USE_MFC_DIRS and MSVS_IGNORE_IDE_PATHS are obsoleted and
+        have no effect.
+
   Please note the following important changes since release 1.1.0:
 
     --  THE $CHANGED_SOURCES, $CHANGED_TARGETS, $UNCHANGED_SOURCES
@@ -867,6 +908,18 @@ RELEASE 1.2.0.d20090113 - Tue, 13 Jan 2009 02:50:30 -0800
 
                     EnsureSConsVersion(0, 96, 93)
 
+    --  THE CheckLib Configure TEST WILL CHANGE BEHAVIOR
+
+       The CheckLib() Configure test appends the lib(s) to the
+       Environment's LIBS list in 1.3 and earlier.  In 1.3 there is a
+       new CheckLib argument, append, which defaults to True to
+       preserve the old behavior.  In a future release, append will
+       be changed to default to False, to conform with autoconf and
+       user expectations, since it is usually used to build up
+       library lists in a right-to-left way.
+
+
+
   SCons is developed with an extensive regression test suite, and a
   rigorous development methodology for continually improving that suite.
   Because of this, SCons is of sufficient quality that you can use it