summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGravatar Joey Hess <joey@kitenet.net>2010-10-25 15:46:53 -0400
committerGravatar Joey Hess <joey@kitenet.net>2010-10-25 15:46:53 -0400
commit1f3088fb945bbe241e5309a961a5b2df0fa9f93a (patch)
tree99ce9d126203706b414cc5eee686951dee18bbd2
parent7fe4bfa20fc9e6ced0b0e933891becb0546b79bb (diff)
wording
-rw-r--r--Commands.hs8
1 files changed, 4 insertions, 4 deletions
diff --git a/Commands.hs b/Commands.hs
index f4286abf5..cda34d1bd 100644
--- a/Commands.hs
+++ b/Commands.hs
@@ -25,17 +25,17 @@ import qualified Remotes
import qualified TypeInternals
{- A subcommand runs in three stages. Each stage can return the next stage
- - to run.
+ - to run.
-
- 1. The start stage is run before anything is printed about the
- subcommand, and can early abort it if the input does not make sense.
- It should run quickly and should not modify Annex state.
-
- 2. The perform stage is run after a message is printed about the subcommand
- - being run.
+ - being run, and it should be where the bulk of the work happens.
-
- - 3. The cleanup stage is run only if the do stage succeeds, and it returns
- - the overall success/fail of the subcommand.
+ - 3. The cleanup stage is run only if the perform stage succeeds, and it
+ - returns the overall success/fail of the subcommand.
-}
type SubCmdStart = String -> Annex (Maybe SubCmdPerform)
type SubCmdPerform = Annex (Maybe SubCmdCleanup)