summaryrefslogtreecommitdiffstats
path: root/HOWTO
diff options
context:
space:
mode:
authorSteven Knight <knight@baldmt.com>2001-10-03 14:50:33 (GMT)
committerSteven Knight <knight@baldmt.com>2001-10-03 14:50:33 (GMT)
commit659c690b1a731e72a8f79b726bc1ba8b8691a5ac (patch)
treea52a833c5a710910a22c703176d076eecbb40825 /HOWTO
parent7252d1fd0ab4108f751a47778235f30880c12595 (diff)
downloadSCons-659c690b1a731e72a8f79b726bc1ba8b8691a5ac.zip
SCons-659c690b1a731e72a8f79b726bc1ba8b8691a5ac.tar.gz
SCons-659c690b1a731e72a8f79b726bc1ba8b8691a5ac.tar.bz2
Add a bin/ subdirectory for admin utilities, and a HOWTO/ (replaces admin/) for the documents.
Diffstat (limited to 'HOWTO')
-rw-r--r--HOWTO/README7
-rw-r--r--HOWTO/change.txt59
2 files changed, 66 insertions, 0 deletions
diff --git a/HOWTO/README b/HOWTO/README
new file mode 100644
index 0000000..32f1170
--- /dev/null
+++ b/HOWTO/README
@@ -0,0 +1,7 @@
+Here you'll find plain text documentation of how to handle various SCons
+project procedures. Files contained herein:
+
+change.txt
+ How changes are integrated, including generating and
+ distributing aedist change sets, and updating the CVS repository
+ on SourceForge.
diff --git a/HOWTO/change.txt b/HOWTO/change.txt
new file mode 100644
index 0000000..8080a12
--- /dev/null
+++ b/HOWTO/change.txt
@@ -0,0 +1,59 @@
+Handling a change set:
+
+ -- Start the change:
+
+ aedb {cnum} [if it's initiated locally]
+ aedist -r [if it's a remote submission]
+
+ -- Normal development cycle:
+
+ aeb
+ aet
+ aet -bl
+ aet -reg [optional]
+ aed
+ aede
+
+ -- As the reviewer:
+
+ aerpass {cnum}
+
+ -- As the integrator:
+
+ aeib {cnum}
+ aeb
+ aet
+ aet -bl
+ aet -reg
+ aed
+ aeipass
+
+ -- Distribute the change to scons-aedist:
+
+ aedist -s -p scons.0.1 {cnum} > scons.0.1.C{cnum}.ae
+ pine -attach scons.0.1.C{cnum}.ae scons-aedist@lists.sourceforge.net
+ Subject: scons.0.1 - {SUMMARY}
+ Body: aegis -l -p scons.0.1 -c {cnum} cd
+
+ rm scons.0.1.C{cnum}.ae
+
+ [This will eventually be automated.]
+
+ -- Update the aedist baseline on the web site:
+
+ aedist -s -bl -p scons.0.1 > scons.0.1.ae
+ scp scons.0.1.ae stevenknight@scons.sourceforge.net:/home/groups/s/sc/scons/htdocs/scons.0.1.ae
+ rm scons.0.1.ae
+
+ [This will eventually be automated.]
+
+ -- Distribute the change to CVS:
+
+ export CVS_RSH=ssh
+ ae2cvs -n -aegis -p scons.0.1 -c {cnum} -u ~/SCons/scons
+ ae2cvs -X -aegis -p scons.0.1 -c {cnum} -u ~/SCons/scons
+
+ If you need the "ae2cvs" Perl script, you can find a copy
+ checked in to the bin/subdirectory.
+
+ [This may eventually be automated.]