changeset 4280:a9336520a4ee

Improve documentation for patchbomb and email
author John Goerzen <jgoerzen@complete.org>
date Thu, 22 Mar 2007 14:02:39 -0500
parents 126d1967a3f8
children 384672d8080f
files hgext/patchbomb.py
diffstat 1 files changed, 26 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/hgext/patchbomb.py	Mon Mar 26 13:57:49 2007 -0500
+++ b/hgext/patchbomb.py	Thu Mar 22 14:02:39 2007 -0500
@@ -79,7 +79,7 @@
 def patchbomb(ui, repo, *revs, **opts):
     '''send changesets as a series of patch emails
 
-    The series starts with a "[PATCH 0 of N]" introduction, which
+    By default, the series starts with a "[PATCH 0 of N]" introduction, which
     describes the series as a whole.
 
     Each patch email has a Subject line of "[PATCH M of N] ...", using
@@ -90,8 +90,32 @@
     Finally, the patch itself, as generated by "hg export".
 
     With --outgoing, emails will be generated for patches not
-    found in the target repository (or only those which are
+    found in the destination repository (or only those which are
     ancestors of the specified revisions if any are provided)
+
+    With --bundle, changesets are selected as for --outgoing,
+    but a single email containing a binary Mercurial bundle as an
+    attachment will be sent.
+
+    Examples:
+
+    hg email -r 3000          # send patch 3000 only
+    hg email -r 3000 -r 3001  # send patches 3000 and 3001
+    hg email -r 3000:3005     # send patches 3000 through 3005
+    hg email 3000             # send patch 3000 (deprecated)
+
+    hg email -o               # send all patches not in default
+    hg email -o DEST          # send all patches not in DEST
+    hg email -o -r 3000       # send all ancestors of 3000 not in default
+    hg email -o -r 3000 DEST  # send all ancestors of 3000 not in DEST
+
+    hg email -b               # send bundle of all patches not in default
+    hg email -b DEST          # send bundle of all patches not in DEST
+    hg email -b -r 3000       # bundle of all ancestors of 3000 not in default
+    hg email -b -r 3000 DEST  # bundle of all ancestors of 3000 not in DEST
+
+    Before using this command, you will need to enable email in your hgrc.
+    See hgrc(5) for details.
     '''
 
     def prompt(prompt, default = None, rest = ': ', empty_ok = False):