changeset 7:a2ad7553ba79

Improve help text (in particular, clarify meaning of --print0).
author Greg Ward <greg@gerg.ca>
date Sun, 24 Apr 2011 10:07:03 -0400
parents 11fd0da50daa
children ecc4fd16555d
files onsub.py test-onsub.t
diffstat 2 files changed, 15 insertions(+), 15 deletions(-) [+]
line wrap: on
line diff
--- a/onsub.py	Wed Mar 30 11:32:17 2011 +0200
+++ b/onsub.py	Sun Apr 24 10:07:03 2011 -0400
@@ -14,15 +14,15 @@
 def onsub(ui, repo, *args, **opts):
     """execute a command in each subrepository
 
-    The command is executed with the current working directory set to
-    the root of each subrepository. By default, execution stops if the
-    command returns a non-zero exit code. Use --ignore-errors to
-    override this.
+    Executes CMD with the current working directory set to the root of
+    each subrepository. By default, execution stops if CMD returns a
+    non-zero exit code. Use --ignore-errors to override this.
 
-    Use --verbose/-v to print the name of each subrepo before the
-    command is executed, use --print0/-0 to terminate this line with a
-    NUL character instead of a newline. This can for instance be
-    useful in combination with :hg:`status --print0`.
+    Use --verbose/-v to print the command being run and the subrepo
+    name for each run of CMD in a subrepo. Alternately, use
+    --print0/-0 to print just the subrepo name followed by a NUL
+    character instead of a newline. This can be useful in combination
+    with :hg:`status --print0`.
 
     The command has access to the following environment variables:
 
--- a/test-onsub.t	Wed Mar 30 11:32:17 2011 +0200
+++ b/test-onsub.t	Sun Apr 24 10:07:03 2011 -0400
@@ -10,14 +10,14 @@
   
   execute a command in each subrepository
   
-      The command is executed with the current working directory set to the root
-      of each subrepository. By default, execution stops if the command returns
-      a non-zero exit code. Use --ignore-errors to override this.
+      Executes CMD with the current working directory set to the root of each
+      subrepository. By default, execution stops if CMD returns a non-zero exit
+      code. Use --ignore-errors to override this.
   
-      Use --verbose/-v to print the name of each subrepo before the command is
-      executed, use --print0/-0 to terminate this line with a NUL character
-      instead of a newline. This can for instance be useful in combination with
-      "hg status --print0".
+      Use --verbose/-v to print the command being run and the subrepo name for
+      each run of CMD in a subrepo. Alternately, use --print0/-0 to print just
+      the subrepo name followed by a NUL character instead of a newline. This
+      can be useful in combination with "hg status --print0".
   
       The command has access to the following environment variables: