From cbf751b2a58f446e7a6a4230c918c4816710b3fa Mon Sep 17 00:00:00 2001 From: Steven Knight Date: Thu, 5 Dec 2002 16:43:51 +0000 Subject: Prepare the 0.09 release. --- README | 26 +++++++++++++++++----- debian/changelog | 7 ++++++ doc/man/scons.1 | 13 +++++++++-- src/CHANGES.txt | 68 +++++++++++++++++++++++++++++--------------------------- src/RELEASE.txt | 55 ++++++++++++++++++++++++++++++--------------- 5 files changed, 110 insertions(+), 59 deletions(-) diff --git a/README b/README index aa20969..13888aa 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 243d545..44c7d9c 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 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 7136721..3e75d77 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 9156d58..487b1d6 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 17b75d3..93d9a87 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. -- cgit v0.12