-# ./darcs-all [-q] [-s] [-i] [-r repo] [--nofib] [--testsuite] get [darcs get flags]
-# This gets the GHC core repos, if they do not already exist.
+# ./darcs-all [-q] [-s] [-i] [-r repo]
+# [--nofib] [--testsuite] [--checked-out] cmd [darcs flags]
+#
+# Applies the darcs command "cmd" to each repository in the tree.
+#
+# e.g.
+# ./darcs-all -r http://darcs.haskell.org/ghc get
+# To get any repos which do not exist in the local tree
+#
+# ./darcs-all -r ~/ghc-validate push
+# To push all your repos to the ~/ghc-validate tree
+#
+# ./darcs-all pull -a
+# To pull everything from the default repos
+#
+# ./darc-all push --dry-run
+# To see what local patches you have relative to the main repos
+#