X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fpick.man;h=fd5072c2baf3a44832147769ace9a6c0bfffc31f;hb=e69044f7624abe5cb2cb796d528c0cc5f29515f7;hp=cb40ccbb505c4d3ee2438250c300c08824fe8425;hpb=1b5a1bd2244d3e1c12b7c9e1f48e445de5ad2ea2;p=mmh diff --git a/man/pick.man b/man/pick.man index cb40ccb..fd5072c 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 . @@ -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`