Prepare the 0.09 release.

5 files changed, 110 insertions, 59 deletions

diff --git a/README b/README
index aa209699..13888aa4 100644
--- a/README
+++ b/README
@@ -279,9 +279,21 @@ LICENSE
         A copy of the copyright and terms under which SCons is
         distributed (the Open Source Initiative-approved MIT license).
 
+LICENSE-local
+        A copy of the copyright and terms under which SCons is
+        distributed for inclusion in the scons-local-{version} packages.
+        This is the same as LICENSE with a preamble that specifies
+        the licensing terms are for SCons itself, not any other
+        package that includes SCons.
+
 README
         What you're looking at right now.
 
+README-local
+        A README file for inclusion in the scons-local-{version}
+        packages.  Similar to this file, but stripped down and modified
+        for people looking at including SCons in their shipped software.
+
 rpm/
         The .spec file for building our RPM packages.
 
@@ -295,12 +307,14 @@ runtest.py
 SConstruct
         The "Makefile" for the SCons distribution.
 
-        (It has been pointed out that it's hard to find the SCons API in
-        this SConstruct file, and that it looks a lot more like a pure
-        Python script than a build configuration file.  That's mainly
-        because all of the magick we have to perform to deal with all of
-        the different packaging formats requires a lot of pure Python
-        manipulation.)
+        (It has been pointed out that it's hard to find the SCons API
+        in this SConstruct file, and that it looks a lot more like a
+        pure Python script than a build configuration file.  That's
+        mainly because all of the magick we have to perform to deal with
+        all of the different packaging formats requires a lot of pure
+        Python manipulation.  In other words, don't look at this file
+        for an example of how easy it is to use SCons to build "normal"
+        software.)
 
 src/
         Where the actual source code is kept, of course.
diff --git a/debian/changelog b/debian/changelog
index 243d545c..44c7d9cf 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,10 @@
+scons (0.09-1) unstable; urgency=low
+
+  * Third post-official-Debian build cycle
+
+ -- Steven Knight <knight@baldmt.com>  Thu,  5 Dec 2002 04:48:25 -0600
+
+
 scons (0.08-1) unstable; urgency=low
 
   * Second post-official-Debian build cycle
diff --git a/doc/man/scons.1 b/doc/man/scons.1
index 71367211..3e75d774 100644
--- a/doc/man/scons.1
+++ b/doc/man/scons.1
@@ -870,8 +870,8 @@ env.SharedLibrary('word', 'word.cpp', SHLIBSUFFIX='.ocx')
 
 All Builders return a Node or a list of Nodes,
 representing the target or targets that will be built.
-A list of Nodes is returned if there is more than one target, and a
-single Node is returned if there is only one target.
+A list of Nodes is returned if there is more than one target,
+and a single Node is returned if there is only one target.
 A
 .I Node
 is an internal SCons object
@@ -898,6 +898,15 @@ by avoiding having to specify
 a platform-specific object suffix
 when calling the Program() builder.
 
+The path name for a Node's file may be used
+by passing the Node to the Python-builtin
+.B str()
+function:
+
+.ES
+bar_obj = env.StaticObject('bar.c', CCFLAGS='-DBAR')
+print "The path to bar_obj is:", str(bar_obj)
+
 .B scons
 provides the following builders:
 
diff --git a/src/CHANGES.txt b/src/CHANGES.txt
index 9156d58b..487b1d62 100644
--- a/src/CHANGES.txt
+++ b/src/CHANGES.txt
@@ -8,40 +8,42 @@
 
 
 
-RELEASE 0.09 - 
+RELEASE 0.09 - Thu,  5 Dec 2002 04:48:25 -0600
 
- From Chad Austin:
+  From Chad Austin:
 
   - Add a Prepend() method to Environments, to append values to
     the beginning of construction variables.
 
-  - Add support for construction variable substition on scanner
-    directories (in CPPPATH, F77PATH, LIBPATH, etc.).
+  From Matt Balvin:
 
- From Charles Crain and Steven Knight:
+  - Add long command-line support to the "lib" Tool (Microsoft library
+    archiver), too.
 
-  - Add Repository() functionality, including the -Y option.
+  From Charles Crain:
 
   - Allow $$ in a string to be passed through as $.
 
   - Support file names with odd characters in them.
 
- From Matt Balvin:
+  - Add support for construction variable substition on scanner
+    directories (in CPPPATH, F77PATH, LIBPATH, etc.).
 
- - Add long command-line support to the "lib" (MicroSoft static library)
-   Tool, too.
+  From Charles Crain and Steven Knight:
+
+  - Add Repository() functionality, including the -Y option.
 
- From Steven Knight:
+  From Steven Knight:
 
- - Fix auto-deduction of target names so that deduced targets end
-   up in the same subdirectory as the source.
+  - Fix auto-deduction of target names so that deduced targets end
+    up in the same subdirectory as the source.
 
- - Don't remove source files specified on the command line!
+  - Don't remove source files specified on the command line!
 
- - Suport the Intel Fortran Compiler (ifl.exe).
+  - Suport the Intel Fortran Compiler (ifl.exe).
 
- - Supply an error message if there are no command-line or
-   Default() targets specified.
+  - Supply an error message if there are no command-line or
+    Default() targets specified.
 
   - Fix the ASPPCOM values for the GNU assembler.
     (Bug reported by Brett Polivka.)
@@ -75,11 +77,11 @@ RELEASE 0.09 -
 
   - Change the name of Tool/lib.py to Tool/mslib.py.
 
- From Steven Knight and Anthony Roach:
+  From Steven Knight and Anthony Roach:
 
   - Man page:  document the fact that Builder calls return Node objects.
 
- From Steve LeBlanc:
+  From Steve LeBlanc:
 
   - Refactor option processing to use our own version of Greg Ward's
     Optik module, modified to run under Python 1.5.2.
@@ -87,31 +89,31 @@ RELEASE 0.09 -
   - Add a ParseConfig() command to modify an environment based on
     parsing output from a *-config command.
 
- From Jeff Petkau:
+  From Jeff Petkau:
 
   - Fix interpretation of '#/../foo' on Win32 systems.
 
- From Anthony Roach:
+  From Anthony Roach:
 
- - Fixed use of command lines with spaces in their arguments,
-   and use of Nodes with spaces in their string representation.
+  - Fixed use of command lines with spaces in their arguments,
+    and use of Nodes with spaces in their string representation.
 
- - Make access and modification times of files in a BuildDir match
-   the source file, even when hard linking isn't available.
+  - Make access and modification times of files in a BuildDir match
+    the source file, even when hard linking isn't available.
 
- - Make -U be case insensitive on Win32 systems.
+  - Make -U be case insensitive on Win32 systems.
 
- - Issue a warning and continue when finding a corrupt .sconsign file.
+  - Issue a warning and continue when finding a corrupt .sconsign file.
 
- - Fix using an alias as a dependency of a target so that if one of the
-   alias' dependencies gets rebuilt, the resulting target will, too.
+  - Fix using an alias as a dependency of a target so that if one of the
+    alias' dependencies gets rebuilt, the resulting target will, too.
 
- - Fix differently ordered targets causing unnecessary rebuilds
-   on case insensitive systems.
+  - Fix differently ordered targets causing unnecessary rebuilds
+    on case insensitive systems.
 
- - Use os.system() to execute external commands whenever the "env"
-   utility is available, which is much faster than fork()/exec(),
-   and fixes the -j option on several platforms.
+  - Use os.system() to execute external commands whenever the "env"
+    utility is available, which is much faster than fork()/exec(),
+    and fixes the -j option on several platforms.
 
   - Fix use of -j with multiple targets.
 
diff --git a/src/RELEASE.txt b/src/RELEASE.txt
index 17b75d37..93d9a877 100644
--- a/src/RELEASE.txt
+++ b/src/RELEASE.txt
@@ -20,7 +20,7 @@ more effectively, please sign up for the scons-users mailing list at:
 
 
 
-RELEASE 0.09 - XXX
+RELEASE 0.09 - Thu,  5 Dec 2002 04:48:25 -0600
 
   This is the ninth alpha release of SCons.  Please consult the
   CHANGES.txt file for a list of specific changes since last release.
@@ -44,6 +44,17 @@ RELEASE 0.09 - XXX
 
           env = Environment(tools = [ Tool('mslib') ])
 
+    - In order to make it clear what SCons is doing when, SCons now
+      prints explicit messages:
+      
+                scons: Reading SConscript files ...
+                scons: done reading SConscript files.
+                scons: Building targets ...
+                scons: done building targets.
+
+      These message might interfere with scripts that examine SCons
+      output.  These messages may be suppressed with the new -Q option.
+
   Please note the following important changes since release 0.07:
 
     - Builder objects no longer automatically split target and source
@@ -56,9 +67,8 @@ RELEASE 0.09 - XXX
 
           env.Program(target = 'foo', source = 'f1.c f2.c')
 
-      These calls will need to be changed by next release.  You may
-      either split up the string into an array of individual file name
-      strings by hand:
+      These calls must be changed.  You may either split up the string
+      into an array of individual file name strings by hand:
 
           env.Program(target = 'foo', source = ['f1.c', 'f2.c'])
 
@@ -75,12 +85,12 @@ RELEASE 0.09 - XXX
       (You may, of course, also use the string.split() function from
       the standard Python library to convert your strings.)
 
-   -  The Object and Library builders no longer use the "shared"
-      keyword argument to specify if the target object or library is a
+    - The Object and Library builders no longer use the "shared" keyword
+      argument to specify if the target object or library is a
       shared library.  Instead, separate StaticObject, SharedObject,
-      StaticLibrary and SharedLibrary builders exist to explicitly build
-      the appropriate target.  The Object and Library buidlers are now
-      synonyms for StaticObject and StaticLibrary, respecitvely.
+      StaticLibrary and SharedLibrary builders exist to build the
+      appropriate target explicitly.  The Object and Library builders
+      are now synonyms for StaticObject and StaticLibrary, respecitvely.
 
     - The prefix, suffix, and src_suffix keyword arguments to the
       Builder() function may no longer be callable functions.
@@ -154,23 +164,32 @@ RELEASE 0.09 - XXX
       processed builder specification overwrites all other builders,
       without any warning.
 
-    - There is not yet a mechanism to configure using file timestamps
-      instead of MD5 signatures to determine if a file is up-to-date.
-
     - Executing the -u or -U option from a source directory that has an
       associated BuildDir() does not build the targets in the BuildDir().
 
     - No support yet for the following future features:
 
-        - Configurable signature calculation
-
         - No support for caching built files.
 
         - No support yet for the following command-line options:
 
              -d -e -l --list-actions --list-derived --list-where
-             -o -p -r -R --random -w --write-filenames -W
-             --warn-undefined-variables
+             -o --override -p -r -R --random -w --write-filenames
+             -W --warn-undefined-variables
+
+
+
+Thank you for your interest, and please let us know how we can help
+improve SCons for your needs.
+
+Steven Knight
+knight at baldmt dot com
+http://www.baldmt.com/~knight/
+
+With plenty of help from the SCons Development team:
+        Chad Austin
+        Charles Crain
+        Steve Leblanc
+        Anthony Roach
+        Terrel Shumway
 
-  Thank you for your interest, and please let us know how we can help
-  improve SCons for your needs.