release 2.4.02.4.0

1 files changed, 114 insertions, 0 deletions

diff --git a/HOWTO/subrelease.txt b/HOWTO/subrelease.txt
new file mode 100644
index 0000000..06b757a
--- /dev/null
+++ b/HOWTO/subrelease.txt
@@ -0,0 +1,114 @@
+__COPYRIGHT__
+
+This document covers how to prepare subreleases of SCons--that is,
+releases numbered with X.Y.Z format, such as 0.94.1, 1.0.1, etc.
+
+If you need to prepare a release (X.Y, such as 0.93, 1.0, etc.), then
+see the document HOWTO/release.txt.
+
+Things to do to release a new X.Y.Z version of SCons:
+
+    BEFORE STARTING THE SUB-BRANCH:
+    
+        Update the user's guide on the parent
+
+            sh bin/docdiff
+
+            sh bin/docupdate
+
+    START THE NEW SUB-BRANCH FOR SUBRELEASE
+
+        aenbr -p scons.0.{94} {1}
+
+        aenc -p scons.0.{94}.{1}
+
+            Call it something like,
+            "Prepare a new sub-release for XYZ."
+            Cause = internal_enhancement.
+            Exempt it from all tests (*_exempt = true).
+
+        ae_p scons.0.{94}.{1}
+
+        aedb 100
+
+        aecd
+
+        # Change the hard-coded package version numbers
+        # in the following files.
+        aecp README
+        vi README
+
+        aecp SConstruct
+        vi SConstruct
+
+        aecp QMTest/TestSCons.py
+        vi QMTest/TestSCons.py
+
+        # Read through and update the README files if necessary
+        [optional] aecp README
+        [optional] vi README
+
+        [optional] aecp src/README.txt
+        [optional] vi src/README.txt
+
+        # Prepare src/CHANGES.txt
+        aecp src/CHANGES.txt
+        vi src/CHANGES.txt
+
+            change the release line to reflect
+            the new subrelease
+
+            date -R the new subrelease
+
+            add an explanatory not after the subrelease line:
+
+                    NOTE:  This is a pre-release of 0.{95}
+                    for testing purposes.  When 0.{95} is
+                    released, all these changes will show
+                    up as 0.95 changes.
+
+        # Prepare src/RELEASE.txt
+        aecp src/RELEASE.txt
+        vi src/RELEASE.txt
+
+            date -R the release only if necessary
+
+            Read through and edit appropriately.
+
+            Can probably keep most of the existing text
+
+            Add any new known problems
+
+        # Prepare debian/changelog
+        aecp debian/changelog
+        vi debian/changelog
+
+            add the new subrelease
+
+            date -R the new subrelease
+
+        # Now build and prepare the release itself.
+        aeb
+
+        aet -reg
+
+        aed
+
+        aede
+
+        etc.
+
+
+
+    Make the relevant packages available for by-hand pickup directly
+    off the web site:
+
+        scp scons-0.{94}.{1}.tar.gz stevenknight@scons.sourceforge.net:/home/groups/s/sc/scons/htdocs
+        scp scons-0.{94}.{1}.zip stevenknight@scons.sourceforge.net:/home/groups/s/sc/scons/htdocs
+
+
+    Test downloading from the web site.
+
+
+
+    Announce to scons-dev@scons.org