summaryrefslogtreecommitdiff
path: root/HOWTO
diff options
context:
space:
mode:
authorSteven Knight <knight@baldmt.com>2002-05-04 04:51:40 +0000
committerSteven Knight <knight@baldmt.com>2002-05-04 04:51:40 +0000
commita79fc1da313aa09ed0007b8c797ab080b038fee8 (patch)
treeffd857dec56003d3be30af22be48249cdc708a49 /HOWTO
parent291533b4080c7db76da6b030cd8b7b8c1a70aa2a (diff)
downloadscons-a79fc1da313aa09ed0007b8c797ab080b038fee8.tar.gz
Initialize the new branch.
Diffstat (limited to 'HOWTO')
-rw-r--r--HOWTO/change.txt20
-rw-r--r--HOWTO/release.txt183
2 files changed, 111 insertions, 92 deletions
diff --git a/HOWTO/change.txt b/HOWTO/change.txt
index 23ecab52..8824e874 100644
--- a/HOWTO/change.txt
+++ b/HOWTO/change.txt
@@ -30,28 +30,28 @@ Handling a change set:
-- Distribute the change to scons-aedist:
- aedist -s -p scons.0.7 {cnum} > scons.0.7.C{cnum}.ae
- pine -attach scons.0.7.C{cnum}.ae scons-aedist@lists.sourceforge.net
- Subject: scons.0.7 - {SUMMARY}
- Body: aegis -l -p scons.0.7 -c {cnum} cd
+ aedist -s -p scons.0.8 {cnum} > scons.0.8.C{cnum}.ae
+ pine -attach scons.0.8.C{cnum}.ae scons-aedist@lists.sourceforge.net
+ Subject: scons.0.8 - {SUMMARY}
+ Body: aegis -l -p scons.0.8 -c {cnum} cd
- rm scons.0.7.C{cnum}.ae
+ rm scons.0.8.C{cnum}.ae
[This will eventually be automated.]
-- Update the aedist baseline on the web site:
- aedist -s -bl -p scons.0.7 > scons.0.7.ae
- scp scons.0.7.ae stevenknight@scons.sourceforge.net:/home/groups/s/sc/scons/htdocs/scons.0.7.ae
- rm scons.0.7.ae
+ aedist -s -bl -p scons.0.8 > scons.0.8.ae
+ scp scons.0.8.ae stevenknight@scons.sourceforge.net:/home/groups/s/sc/scons/htdocs/scons.0.8.ae
+ rm scons.0.8.ae
[This will eventually be automated.]
-- Distribute the change to CVS:
export CVS_RSH=ssh
- ae2cvs -n -aegis -p scons.0.7 -c {cnum} -u ~/SCons/scons
- ae2cvs -X -aegis -p scons.0.7 -c {cnum} -u ~/SCons/scons
+ ae2cvs -n -aegis -p scons.0.8 -c {cnum} -u ~/SCons/scons
+ ae2cvs -X -aegis -p scons.0.8 -c {cnum} -u ~/SCons/scons
If you need the "ae2cvs" Perl script, you can find a copy
checked in to the bin/subdirectory.
diff --git a/HOWTO/release.txt b/HOWTO/release.txt
index a24caa41..4f3a691d 100644
--- a/HOWTO/release.txt
+++ b/HOWTO/release.txt
@@ -83,18 +83,16 @@ Things to do to release a new version of SCons:
# Change the hard-coded package version numbers
# in the following files.
- aecp README SConstruct debian/changelog debian/files rpm/scons.spec
+ aecp README SConstruct debian/changelog rpm/scons.spec
- vi README SConstruct debian/changelog debian/files rpm/scons.spec
+ vi README SConstruct debian/changelog rpm/scons.spec
# Optionally, do the same in the following:
[optional] aecp HOWTO/change.txt
[optional] aecp HOWTO/release.txt
- [optional] aecp debian/scons.postinst
[optional] vi HOWTO/change.txt
[optional] vi HOWTO/release.txt
- [optional] vi debian/scons.postinst
aeb
@@ -119,14 +117,14 @@ Things to do to release a new version of SCons:
<your email>
cd incoming
bin
- put scons-0.07-1.noarch.rpm
- put scons-0.07-1.src.rpm
- put scons-0.07.tar.gz
- put scons-0.07.win32.exe
- put scons-0.07.zip
- put scons-src-0.07.tar.gz
- put scons-src-0.07.zip
- put scons_0.07-1_all.deb
+ put scons-0.08-1.noarch.rpm
+ put scons-0.08-1.src.rpm
+ put scons-0.08.tar.gz
+ put scons-0.08.win32.exe
+ put scons-0.08.zip
+ put scons-src-0.08.tar.gz
+ put scons-src-0.08.zip
+ put scons_0.08-1_all.deb
Create the new release at the SourceForge project page:
@@ -138,7 +136,7 @@ Things to do to release a new version of SCons:
=> Add Release
- New release name: 0.07
+ New release name: 0.08
Cut-and-paste or upload the RELEASE.txt file.
@@ -155,23 +153,29 @@ Things to do to release a new version of SCons:
Edit the file info:
- scons-0.07-1.noarch.rpm Any .rpm
- scons-0.07-1.src.rpm Any Source .rpm
- scons-0.07.tar.gz Any .gz
- scons-0.07.win32.exe i386 .exe (32-bit Windows)
- scons-0.07.zip Any .zip
- scons_0.07-1_all.deb Any .deb
+ scons-0.08-1.noarch.rpm Any .rpm
+ scons-0.08-1.src.rpm Any Source .rpm
+ scons-0.08.tar.gz Any .gz
+ scons-0.08.win32.exe i386 .exe (32-bit Windows)
+ scons-0.08.zip Any .zip
+ scons_0.08-1_all.deb Any .deb
Click "Update/Refresh" for each file; this must be done
one at a time.
+ Check "I'm sure." and click "Send Notice" in the Email
+ Release Notice section.
+
+
+ Go to the Admin page
+
=> Edit/Add File Releases
Package Name: scons-src
=> Add Release
- New release name: 0.07
+ New release name: 0.08
Cut-and-paste or upload the RELEASE.txt file.
@@ -188,12 +192,57 @@ Things to do to release a new version of SCons:
Edit the file info:
- scons-src-0.07.tar.gz Any .gz
- scons-src-0.07.zip Any .zip
+ scons-src-0.08.tar.gz Any .gz
+ scons-src-0.08.zip Any .zip
Click "Update/Refresh" for each file; this must be done
one at a time.
+ Check "I'm sure." and click "Send Notice" in the Email
+ Release Notice section.
+
+
+ Hide release {0.06} 2 at the SourceForge download page:
+
+ Go to the Admin page
+
+ => Edit/Add File Releases
+
+ Package Name: scons
+
+ => Edit Releases
+
+ Release Name: {0.06}
+
+ => Edit This Release
+
+ Status: => Hidden
+
+ Click Submit/Refresh
+
+
+ Go to the Admin page
+
+ => Edit/Add File Releases
+
+ Package Name: scons-src
+
+ => Edit Releases
+
+ Release Name: {0.06}
+
+ => Edit This Release
+
+ Status: => Hidden
+
+ Click Submit/Refresh
+
+
+
+ In the Bugs Tracker, add a Group for the new release (0.08)
+
+
+
Test downloading from the SourceForge project page
You may need to wait a good bit; they seem to update
@@ -219,10 +268,6 @@ Things to do to release a new version of SCons:
- In the Bugs Tracker, add a Group for the new release (0.07)
-
-
-
Announce to the following mailing lists (template below):
scons-announce@lists.sourceforge.net
@@ -267,13 +312,9 @@ Things to do to release a new version of SCons:
=======================
-Template scons-devel announcement:
+Template describe-the-release section:
-SConspirators--
-
-SCons alpha release 0.07 is now available for download.
-
-IMPORTANT: This release contains the following interface changes:
+IMPORTANT: Release 0.08 contains the following interface changes:
- XXX
This release adds the following features:
@@ -290,14 +331,23 @@ The following changes have been made to the SCons packaging:
The documentation has been improved:
- XXX
+=======================
+Template scons-devel announcement:
-Thanks to XXX, XXX, and XXX for contributing to this release.
+SConspirators--
+
+SCons alpha release 0.08 is now available for download.
+
+XXX Template describe-the-release section goes here XXX
+
+Special thanks to XXX, XXX, and XXX for their contributions to this
+release.
--SK
=======================
Template scons-users + scons-announce announcement:
-Version 0.07 of SCons has been released and is available for download
+Version 0.08 of SCons has been released and is available for download
from the SCons web site:
http://www.scons.org/
@@ -312,23 +362,7 @@ addition to the traditional .tar.gz and .zip files.
WHAT'S NEW IN THIS RELEASE?
-IMPORTANT: Version 0.07 contains the following interface changes:
- - XXX
-
-This release adds the following features:
- - XXX
-
-The following fixes have been added:
- - XXX
-
-Performance has been improved as follows:
- - XXX
-
-The following changes have been made to the SCons packaging:
- - XXX
-
-The documentation has been improved:
- - XXX
+XXX Template describe-the-release section goes here XXX
ACKNOWLEDGEMENTS
@@ -342,7 +376,11 @@ On behalf of the SCons team,
=======================
Template python-announce, linux-announce and python-list announcement:
-Version 0.07 of SCons has been released and is available for download
+SCons is a software construction tool (build tool, or make tool) written
+in Python. It is based on the design which won the Software Carpentry
+build tool competition in August 2000.
+
+Version 0.08 of SCons has been released and is available for download
from the SCons web site:
http://www.scons.org/
@@ -357,48 +395,29 @@ addition to the traditional .tar.gz and .zip files.
WHAT'S NEW IN THIS RELEASE?
-IMPORTANT: Version 0.07 contains the following interface changes:
- - XXX
-
-This release adds the following features:
- - XXX
-
-The following fixes have been added:
- - XXX
-
-Performance has been improved as follows:
- - XXX
-
-The following changes have been made to the SCons packaging:
- - XXX
+XXX Template describe-the-release section goes here XXX
-The documentation has been improved:
- - XXX
-
-WHAT IS SCONS?
-
-SCons is a software construction tool (build tool, or make tool) written
-in Python. Its design is based on the design which won the Software
-Carpentry build tool competition in August 2000 (in turn derived from
-the Perl-based Cons build tool).
+ABOUT SCONS
Distinctive features of SCons include:
+ - a global view of all dependencies; no multiple passes to get
+ everything built properly
- configuration files are Python scripts, allowing the full use of a
- real scripting language to solve build problems
+ real scripting language to solve difficult build problems
- a modular architecture allows the SCons Build Engine to be
embedded in other Python software
- - a global view of all dependencies; no multiple passes to get
- everything built
- the ability to scan files for implicit dependencies (#include files);
- - improved parallel build (-j) support
- - use of MD5 signatures to decide if a file has changed
+ - improved parallel build (-j) support that provides consistent
+ build speedup regardless of source tree layout
+ - use of MD5 signatures to decide if a file has really changed; no
+ need to "touch" files to fool make that something is up-to-date
- easily extensible through user-defined Builder and Scanner objects
- build actions can be Python code, as well as external commands
-An scons-users mailing list has been created for those interested in
-getting started using SCons. You can subscribe at:
+An scons-users mailing list is available for those interested in getting
+started using SCons. You can subscribe at:
http://lists.sourceforge.net/lists/listinfo/scons-users