summaryrefslogtreecommitdiffstats
path: root/HOWTO
diff options
context:
space:
mode:
authorSteven Knight <knight@baldmt.com>2001-12-24 07:12:35 (GMT)
committerSteven Knight <knight@baldmt.com>2001-12-24 07:12:35 (GMT)
commitc7277b31e581ad30fc9badad57cd8ba37bded6ee (patch)
treeb1147de5353aa38f74e2c1f5c7317cad0eb08e77 /HOWTO
parent2fa2b20ae2c04bca6a52600d76bedd29eb59e313 (diff)
downloadSCons-c7277b31e581ad30fc9badad57cd8ba37bded6ee.zip
SCons-c7277b31e581ad30fc9badad57cd8ba37bded6ee.tar.gz
SCons-c7277b31e581ad30fc9badad57cd8ba37bded6ee.tar.bz2
Update the release instructions, add an announcement.
Diffstat (limited to 'HOWTO')
-rw-r--r--HOWTO/release.txt163
1 files changed, 147 insertions, 16 deletions
diff --git a/HOWTO/release.txt b/HOWTO/release.txt
index 48496fa..9cbd498 100644
--- a/HOWTO/release.txt
+++ b/HOWTO/release.txt
@@ -36,15 +36,43 @@ Things to do to release a version of SCons:
Can probably keep a lot of the existing text, read
it through to make sure it's okay and edit appropriately.
+ Prepare debian/changelog
+ date -R the latest release
+
+
+
+ END THE BRANCH
+
+ ae_p scons.0
+
+ aede scons {2}
+
+ aerpass {2}
+
+ aeib {2}
+
+ aeb
+
+ aet
+
+ aet -reg
+
+ aed
+
+ aeipass
- END THE BRANCH (need more info)
+ START THE NEW BRANCH
- START THE NEW BRANCH (need more info)
+ aenbr -p scons.0 {3}
- aenbr -p {newbranch}
+ aenc -p {scons.0.3}
- aenc -p {newbranch}
+ Call it something like, "Initialize the new
+ branch." Cause = internal_enhancement. Exempt
+ it from all tests (*_exempt = true).
+
+ ae_p scons.0.3
aedb 100
@@ -53,10 +81,12 @@ Things to do to release a version of SCons:
# Change the hard-coded package version numbers
# in the following files.
aecp Construct debian/changelog rpm/scons.spec
+
vi Construct debian/changelog rpm/scons.spec
# Optionally, do the same in the following:
[optional] aecp HOWTO/change.txt debian/scons.postinst
+
[optional] vi HOWTO/change.txt debian/scons.postinst
aeb
@@ -75,19 +105,60 @@ Things to do to release a version of SCons:
- Upload the packages to the SourceForge project page
+ Upload the packages to the SourceForge incoming FTP:
+
+ ftp upload.sourceforge.net
+ anonymous
+ <your email>
+ cd incoming
+ bin
+ put scons-0.02-1.noarch.rpm
+ put scons-0.02-1.src.rpm
+ put scons-0.02.tar.gz
+ put scons-0.01.win32.exe
+ put scons-src-0.01.tar.gz
+ put scons_0.01-1_all.deb
+
+ Create the new release at the SourceForge project page:
+
+ Cut-and-paste or upload the RELEASE.txt file.
+
+ Cut-and-paste or upload the CHANGES.txt file.
+
+ (If you cut-and-paste, check the "Preserve my
+ pre-formatted text." box!)
+
+ Check the SCons files you uploaded
+
+ Click "Submit/Refresh"
+
+ Edit the files
+
+ scons-0.02-1.noarch.rpm Any .rpm
+ scons-0.02-1.src.rpm Any Source .rpm
+ scons-0.02.tar.gz Any .gz
+ scons-0.01.win32.exe i386 Other
+ scons-src-0.01.tar.gz Any Source .gz
+ scons_0.01-1_all.deb Any .deb
+
+ (This has to be done one at a time.)
Test downloading from the SourceForge project page
+ You'll need to wait a good bit; they update this on, at
+ best, half-hour cycles.
+
Update the web site:
- new version number (template)
- announcement on the home page
- check packages on the download page
- checkin new scons-doc.tar.gz on the web site
- update the CHANGES.txt file
+ template: new version number
+
+ src/index.in: announcement on the home page
+
+ src/scons-doc.tar.gz: update
+
+ src/CHANGES.txt: update
Test downloading from the web site download page
@@ -95,9 +166,9 @@ Things to do to release a version of SCons:
Add news item to the SourceForge project page
- Prepare an announcement
-
- Announce to the following mailing lists:
+
+
+ Announce to the following mailing lists (template below):
scons-announce@lists.sourceforge.net
scons-users@lists.sourceforge.net
@@ -109,8 +180,68 @@ Things to do to release a version of SCons:
[optional] cons-discuss@gnu.org
- linux-announce@news.ornl.gov?
+ linux-announce@news.ornl.gov
- Notify freshmeat.net
-
Notify www.cmtoday.com/contribute.html
+
+ [This guy wants an announcement no more frequently than
+ once a month, so save it for a future release if it's
+ been too soon since the previous one.]
+
+ Notify freshmeat.net
+
+
+
+
+=======================
+
+Template release announcement:
+
+
+
+I'm pleased to announce that version 0.XXX of SCons has been released
+and is available for download from the SCons web site:
+
+ http://www.scons.org/
+
+Or through the download link at the SCons project page at SourceForge:
+
+ http://sourceforge.net/projects/scons/
+
+RPM and Debian packages and a Win32 installer are all available, in
+addition to the traditional .tar.gz files.
+
+SCons is a software construction tool (build tool, 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).
+
+Distinctive features of SCons include:
+
+ - configuration files are Python scripts, allowing the full use of a
+ real scripting language to solve 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
+ - easily extensible through user-defined Builder and Scanner objects
+
+An scons-users mailing list has been created for those interested in
+getting started using SCons. You can subscribe at:
+
+ http://lists.sourceforge.net/lists/listinfo/scons-users
+
+Alternatively, we invite you to subscribe to the low-volume
+scons-announce mailing list to receive notification when new versions of
+SCons become available:
+
+ http://lists.sourceforge.net/lists/listinfo/scons-announce
+
+Special thanks to XXX for his/her/their contributions to this release.
+
+On behalf of the SCons team,
+
+ --SK