X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/1b5a1bd2244d3e1c12b7c9e1f48e445de5ad2ea2..07661005b9a36338ab158bcbe7762788a1df4030:/man/pick.man

diff --git a/man/pick.man b/man/pick.man
index cb40ccbb..202db096 100644
--- a/man/pick.man
+++ b/man/pick.man
@@ -1,8 +1,7 @@
+.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
@@ -43,6 +42,7 @@ pick \- search for messages by content
 .RB [ \-sequence
 .I name
 \&...]
+.RB [ \-nosequence ]
 .RB [ \-public " | " \-nopublic ]
 .RB [ \-zero " | " \-nozero ]
 .RB [ \-list " | " \-nolist ] 
@@ -67,10 +67,10 @@ primitives are available: pattern matching and date constraint
 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 .
@@ -151,7 +151,7 @@ Both the
 .B \-after
 and
 .B \-before
-switches take legal 822\-style date
+switches take legal RFC 822\-style date
 specifications as arguments.
 .B Pick
 will default certain missing
@@ -160,7 +160,7 @@ are (in order of defaulting): timezone, time and timezone, date, date
 and timezone.  All defaults are taken from the current date, time,
 and timezone.
 .PP
-In addition to 822\-style dates,
+In addition to RFC 822\-style dates,
 .B pick
 will also recognize any of
 the days of the week (\*(lqsunday\*(rq, \*(lqmonday\*(rq, and so on),
@@ -244,9 +244,7 @@ the folder argument to
 .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.
@@ -262,18 +260,14 @@ pick\0\-from\0frated\0\-seq\0fred
 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
@@ -293,14 +287,12 @@ in the
 same way
 .B mark
 uses them.
-
 .SH FILES
 .fc ^ ~
 .nf
 .ta \w'%etcdir%/ExtraBigFileName  'u
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
-
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
@@ -309,10 +301,8 @@ uses them.
 ^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"
@@ -321,10 +311,8 @@ mark(1)
 .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 ,
@@ -369,24 +357,13 @@ show\0fear
 .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
@@ -396,7 +373,7 @@ switch it applies to.
 .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`