X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/46f35e659f3bc3e808a70263bea0ec72624c8a08..b0aa8cdb1c264e42d4931ca24968689c73381278:/man/pick.man

diff --git a/man/pick.man b/man/pick.man
index 000da224..dbed194a 100644
--- a/man/pick.man
+++ b/man/pick.man
@@ -8,8 +8,12 @@ pick \- search for messages by content
 .HP 5
 .na
 .B pick
+.RB [ \-help ]
+.RB [ \-version ]
 .RI [ +folder ]
 .RI [ msgs ]
+.RB [ \-reverse
+\&...]
 .RB [ \-and
 \&...]
 .RB [ \-or
@@ -47,8 +51,6 @@ pick \- search for messages by content
 .RB [ \-zero " | " \-nozero ]
 .RB [ \-list " | " \-nolist ] 
 .RB [ \-debug ]
-.RB [ \-version ]
-.RB [ \-help ]
 .PP
 typical usage:
 .PP
@@ -61,7 +63,7 @@ show\0`pick\0\-before\0friday`
 .RE
 .ad
 .SH DESCRIPTION
-.B Pick
+.B pick
 searches within a folder for messages with the specified
 contents, and then identifies those messages.  Two types of search
 primitives are available: pattern matching and date constraint
@@ -154,7 +156,7 @@ and
 .B \-before
 switches take legal RFC 822\-style date
 specifications as arguments.
-.B Pick
+.B pick
 will default certain missing
 fields so that the entire date need not be specified.  These fields
 are (in order of defaulting): timezone, time and timezone, date, date
@@ -177,7 +179,21 @@ will
 also honor a specification of the form \*(lq\-dd\*(rq, which means
 \*(lqdd days ago\*(rq.
 .PP
-.B Pick
+Use the
+.BR \-reverse
+switch to make
+.B pick
+find matching messages in reverse order, working from the highest message
+number down to the lowest.  This can be useful in for searching recent
+messages in large folders, for example,
+.PP
+.RS 5
+.nf
+pick\0\-reverse\0\-from\0frated\0|\0xargs\0\-n1\0scan
+.fi
+.RE
+.PP
+.B pick
 supports complex boolean operations on the searching primitives
 with the
 .BR \-and ,