- quilt mail: Document the possibility to specifiy a patch range.

3 files changed, 16 insertions, 7 deletions

diff --git a/doc/README.MAIL b/doc/README.MAIL
index 20cc023..c997048 100644
--- a/doc/README.MAIL
+++ b/doc/README.MAIL
@@ -4,9 +4,10 @@ QUILT MAIL COMMAND
 The mail command starts up the system editor ($EDITOR, or vi if $EDITOR
 is undefined) with an template in Internet Message Format (RFC 2822).
 This template is used to generate an introduction, as well as one
-message for each patch in the series file.  The template is used as
-follows: The headers are used in each message generated, and modified as
-required.  The template body is used only for the introduction.
+message for each patch in the selected range of the series file.  The
+template is used as follows: The headers are used in each message
+generated, and modified as required.  The template body is used only for
+the introduction.
 
 In the template, the headers can be modified, additional headers added,
 and unneeeded headers can be removed.  The template header also contains
diff --git a/quilt.changes b/quilt.changes
index 051c552..96916e4 100644
--- a/quilt.changes
+++ b/quilt.changes
@@ -1,4 +1,9 @@
 -------------------------------------------------------------------
+Sun Apr 22 10:40:36 CEST 2007 - khali@linux-fr.org
+
+- quilt mail: Document the possibility to specifiy a patch range.
+
+-------------------------------------------------------------------
 Sun Apr 22 10:13:18 CEST 2007 - khali@linux-fr.org
 
 - Dependencies of quilt/* on quilt/scripts/* are run-time
diff --git a/quilt/mail.in b/quilt/mail.in
index e14943f..367962c 100644
--- a/quilt/mail.in
+++ b/quilt/mail.in
@@ -21,13 +21,16 @@ fi
 
 usage()
 {
-	printf $"Usage: quilt mail {--mbox file|--send} [-m text] [--prefix prefix] [--sender ...] [--from ...] [--to ...] [--cc ...] [--bcc ...] [--subject ...]\n"
+	printf $"Usage: quilt mail {--mbox file|--send} [-m text] [--prefix prefix] [--sender ...] [--from ...] [--to ...] [--cc ...] [--bcc ...] [--subject ...] [first_patch [last_patch]]\n"
 	if [ x$1 = x-h ]
 	then
 		printf $"
-Create mail messages from all patches in the series file, and either store
-them in a mailbox file, or send them immediately. The editor is opened
-with a template for the introduction. Please see %s for details.
+Create mail messages from a specified range of patches, or all patches in
+the series file, and either store them in a mailbox file, or send them
+immediately. The editor is opened with a template for the introduction.
+Please see %s for details.
+When specifying a range of patches, a first patch name of \`-' is
+equivalent to specifying the first applied patch.
 
 -m text
 	Text to use as the text in the introduction. When this option is