X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fpick.man;h=aca091828da027b9d01322c6021f0593549e9fea;hb=90986dddba4b24b0449238f86f836581cfb93938;hp=1ef41561783bff27abb80bb2178b092f410cc148;hpb=278a48ef53b5dde10d7c88f67f51ce15ad11c0c0;p=mmh diff --git a/man/pick.man b/man/pick.man index 1ef4156..aca0918 100644 --- a/man/pick.man +++ b/man/pick.man @@ -1,12 +1,12 @@ +.TH PICK %manext1% "March 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 ] @@ -57,7 +57,7 @@ pick\0\-to\0holloway\0\-sequence\0select show\0`pick\0\-before\0friday` .fi .RE - +.ad .SH DESCRIPTION .B Pick searches within a folder for messages with the specified @@ -66,10 +66,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 . @@ -243,9 +243,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. @@ -261,15 +259,6 @@ 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 . -.PP By default, .B pick will zero the sequence before adding it. This @@ -292,14 +281,12 @@ in 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 @@ -308,10 +295,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" @@ -320,10 +305,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 , @@ -368,13 +351,11 @@ 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 @@ -384,7 +365,7 @@ 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. +must usually place the argument to this switch inside quotes. Furthermore, any occurrence of .B \-datefield must occur prior to the