+.TH PICK %manext1% "November 6, 2012" "%nmhversion%"
.\"
.\" %nmhwarning%
-.\" $Id$
.\"
-.TH PICK %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
pick \- search for messages by content
.SH SYNOPSIS
.HP 5
+.na
.B pick
.RI [ +folder ]
.RI [ msgs ]
.RB [ \-sequence
.I name
\&...]
+.RB [ \-nosequence ]
.RB [ \-public " | " \-nopublic ]
.RB [ \-zero " | " \-nozero ]
.RB [ \-list " | " \-nolist ]
show\0`pick\0\-before\0friday`
.fi
.RE
-
+.ad
.SH DESCRIPTION
.B Pick
searches within a folder for messages with the specified
operations.
.PP
A modified
-.BR grep (1)
+.IR grep (1)
is used to perform the matching, so the
full regular expression (see
-.BR ed (1))
+.IR ed (1))
facility is available
within
.IR pattern .
.B scan
as well.
.PP
-Regardless of the operation of the
-.B \-list
-switch, the
+The
.B \-sequence
.I name
switch may be given once for each sequence the user wishes to define.
defines a new message sequence for the current folder called
\*(lqfred\*(rq which contains exactly those messages that were selected.
.PP
-Note that whenever
-.B pick
-processes a
-.B \-sequence
-.I name
-switch, it
-sets
-.BR \-nolist .
+The
+.B \-nosequence
+switch will disable all previously named sequences, allowing
+those established by a profile component to be overridden.
.PP
By default,
.B pick
-will zero the sequence before adding it. This
+will zero a sequence before adding it. This
action can be disabled with the
.B \-nozero
switch, which means that the
same way
.B mark
uses them.
-
.SH FILES
.fc ^ ~
.nf
-.ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
+.ta \w'%etcdir%/ExtraBigFileName 'u
^$HOME/\&.mh\(ruprofile~^The user profile
.fi
-
.SH "PROFILE COMPONENTS"
.fc ^ ~
.nf
^Path:~^To determine the user's nmh directory
^Current\-Folder:~^To find the default current folder
.fi
-
.SH "SEE ALSO"
-mark(1)
-
+.IR mark (1)
.SH DEFAULTS
.nf
.RB ` +folder "' defaults to the current folder"
.RB ` \-zero '
.RB ` \-list "' is the default if no `\-sequence', `\-nolist' otherwise"
.fi
-
.SH CONTEXT
If a folder is given, it will become the current folder.
-
.SH HISTORY
In previous versions of
.BR MH ,
.PP
Finally, timezones used to be ignored when comparing dates: they aren't
any more.
-
.SH "HELPFUL HINTS"
Use
.RB \*(lq "pick sequence \-list" \*(rq
to enumerate the messages in a sequence
(such as for use by a shell script).
-
.SH BUGS
-The argument to the
-.B \-after
-and
-.B \-before
-switches must be interpreted
-as a single token by the shell that invokes
-.BR pick .
-Therefore, one
-must usually place the argument to this switch inside double\-quotes.
-Furthermore, any occurrence of
+Any occurrence of
.B \-datefield
must occur prior to the
.B \-after
.PP
If
.B pick
-is used in a back\-quoted operation, such as
+is used in a backquoted operation, such as
.PP
.RS 5
scan\0`pick\0\-from\0jones`