]> diplodocus.org Git - nmh/blobdiff - man/pick.man
Replace getcpy() with mh_xstrdup() where the string isn't NULL.
[nmh] / man / pick.man
index e023db5c8d0bd14eeb2f126cb1e00e752fc7c1d8..106df2fad094177604d389398237c67332d34d0e 100644 (file)
@@ -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
@@ -177,6 +179,20 @@ will
 also honor a specification of the form \*(lq\-dd\*(rq, which means
 \*(lqdd days ago\*(rq.
 .PP
+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
@@ -329,7 +345,7 @@ when it fails.  This lets the outer command fail gracefully as well.
 .SH FILES
 .fc ^ ~
 .nf
-.ta \w'%etcdir%/ExtraBigFileName  'u
+.ta \w'%nmhetcdir%/ExtraBigFileName  'u
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
 .SH "PROFILE COMPONENTS"