Add a bin/ subdirectory for admin utilities, and a HOWTO/ (replaces admin/) for the documents.

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.]