X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fpick.man;h=fe0ddf41348088cfe4a08b413d29e309480a27d7;hb=5e5e8b753acc7ff1e16c7fca172a2151a6c01353;hp=1ef41561783bff27abb80bb2178b092f410cc148;hpb=278a48ef53b5dde10d7c88f67f51ce15ad11c0c0;p=mmh diff --git a/man/pick.man b/man/pick.man index 1ef4156..fe0ddf4 100644 --- a/man/pick.man +++ b/man/pick.man @@ -1,12 +1,12 @@ +.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 ] @@ -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,24 +351,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 @@ -395,7 +367,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`