Index: /branches/eam_branches/ipp-pstamp-20260421/ippTasks/simtest.quickmos.auto
===================================================================
--- /branches/eam_branches/ipp-pstamp-20260421/ippTasks/simtest.quickmos.auto	(revision 43083)
+++ /branches/eam_branches/ipp-pstamp-20260421/ippTasks/simtest.quickmos.auto	(revision 43084)
@@ -1,25 +1,29 @@
 
 automate MULTI
+
+# stages cycle between states of 'INIT.xxx' and 'RUN.xxx'
+
+# a stage starts in state INIT.BLOCK.
+
+# the "automate.block" task runs the 'block' command regularly on
+# stages in state INIT.BLOCK.  if it returns a valid result, the block
+# is set and the stage remains in state INIT.BLOCK.  if there is no
+# result (ie, no matching BIAS, etc), the stage is put to state
+# INIT.CHECK.
+
+# the "automate.check" tasks runs the 'check' command regularly on
+# stages in state INIT.CHECK.  if it returns 'ncheck' valid entries
+# (default ncheck = 1), the stage is set to state INIT.LAUNCH.
+
+# the "automate.launch" tasks runs the 'launch' command once on stages
+# in state INIT.LAUNCH.  after the command is run, the state goes to
+# RUN.LAUNCH.  After the command has been successfully completed, the
+# state goes to DONE.LAUNCH
+
+# XXX these steps all refer to "@DBNAME@"; they need to be more generic, even for the basic simtest analysis
 
 # we run in the sequence BLOCK -> CHECK -> LAUNCH -> BLOCK -> CHECK
 # success on CHECK -> LAUNCH
 # failure on BLOCK -> CHECK
-
-# a stage starts in state INIT.BLOCK.
-
-# the "automate.block" task runs the 'block' command regularly.  if it
-# returns a valid result, the block is set and the state remains in
-# block.  if there is no result (ie, no matching BIAS, etc), the stage
-# is put to state INIT.CHECK.
-
-# the "automate.check" tasks runs the 'check' command regularly.  if
-# it returns ncheck valid entries (default ncheck = 1), the state goes
-# to INIT.LAUNCH.
-
-# the "automate.launch" tasks runs the 'launch' command once.  if it returns
-# ncheck valid entries (default ncheck = 1), the state goes to
-# INIT.LAUNCH.
-
-# XXX these steps all refer to "@DBNAME@"; they need to be more generic, even for the basic simtest analysis
 
 automate METADATA