Added note that suffixes were removed from filenames of temporary files.

[nmh] / man / pick.man

diff --git a/man/pick.man b/man/pick.man
index e523dd40f94265e3b19ca4d9e95156381761870f..202db0963051f0db942f76a83fe4fc157dd76d1e 100644 (file)
--- a/man/pick.man
+++ b/man/pick.man
@@ -1,8 +1,7 @@
+.TH PICK %manext1% "November 6, 2012" "%nmhversion%"

 .\"
 .\" %nmhwarning%
 .\"
 .\" %nmhwarning%

-.\" $Id$

 .\"
 .\"

-.TH PICK %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]

 .SH NAME
 pick \- search for messages by content
 .SH SYNOPSIS
 .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 [ \-sequence
 .I name
 \&...]

+.RB [ \-nosequence ]

 .RB [ \-public " | " \-nopublic ]
 .RB [ \-zero " | " \-nozero ]
 .RB [ \-list " | " \-nolist ] 
 .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
 operations.
 .PP
 A modified

-.BR grep (1)
+.IR grep (1)

 is used to perform the matching, so the
 full regular expression (see
 is used to perform the matching, so the
 full regular expression (see

-.BR ed (1))
+.IR ed (1))

 facility is available
 within
 .IR pattern .
 facility is available
 within
 .IR pattern .


@@ -151,7 +151,7 @@ Both the
 .B \-after
 and
 .B \-before
 .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
 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
 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),
 .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
 .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.
 .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
 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
 .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
 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.
 same way
 .B mark
 uses them.

-

 .SH FILES
 .fc ^ ~
 .nf
 .SH FILES
 .fc ^ ~
 .nf

-.ta \w'/usr/local/nmh/etc/ExtraBigFileName  'u
+.ta \w'%etcdir%/ExtraBigFileName  'u

 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi

-

 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
 .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
 ^Path:~^To determine the user's nmh directory
 ^Current\-Folder:~^To find the default current folder
 .fi

-

 .SH "SEE ALSO"
 .SH "SEE ALSO"

-mark(1)
-
+.IR mark (1)

 .SH DEFAULTS
 .nf
 .RB ` +folder "' defaults to the current folder"
 .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
 .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 CONTEXT
 If a folder is given, it will become the current folder.

-

 .SH HISTORY
 In previous versions of
 .BR MH ,
 .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.
 .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 "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
 .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
 .B \-datefield
 must occur prior to the
 .B \-after


@@ -396,7 +373,7 @@ switch it applies to.
 .PP
 If
 .B pick
 .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`
 .PP
 .RS 5
 scan\0`pick\0\-from\0jones`