projects
/
mmh
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
Fix blind list alias expansion
[mmh]
/
man
/
pick.man1
diff --git
a/man/pick.man1
b/man/pick.man1
index
2f06a22
..
2390984
100644
(file)
--- a/
man/pick.man1
+++ b/
man/pick.man1
@@
-3,7
+3,7
@@
.\"
.TH PICK %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
.\"
.TH PICK %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
-pick \- search for messages by content
+pick \- select messages by content
.SH SYNOPSIS
.HP 5
.na
.SH SYNOPSIS
.HP 5
.na
@@
-169,12
+169,22
@@
ago), and `tomorrow' (24 hours from now). All days of the
week are judged to refer to a day in the past (e.g., telling \fIpick\fR
`saturday' on a `tuesday' means `last\ saturday'
not `this\ saturday').
week are judged to refer to a day in the past (e.g., telling \fIpick\fR
`saturday' on a `tuesday' means `last\ saturday'
not `this\ saturday').
-.PP
+Further more, dates in a simplified ISO 8601/RFC 3339 style (e.g.
+`YYYY-MM-DD' or `YYYY-MM-DD hh:mm:ss') are accepted.
Finally, in addition to these special specifications,
.B pick
will
Finally, in addition to these special specifications,
.B pick
will
-also honor a specification of the form `\-dd', which means
-`dd days ago'.
+also honor a date specification of the form `\-\fIddd\fR', which means
+`\fIddd\fR days ago'.
+For example,
+.PP
+.RS 5
+.nf
+pick\0\-after\0\-30
+.fi
+.RE
+.PP
+identifies the messages of the last thirty days.
.PP
.B Pick
supports complex boolean operations on the searching primitives
.PP
.B Pick
supports complex boolean operations on the searching primitives
@@
-213,7
+223,7
@@
switches are provided, which act just like opening and closing
parentheses in logical expressions.
.PP
If no search criteria are given, all the messages specified on the
parentheses in logical expressions.
.PP
If no search criteria are given, all the messages specified on the
-command line are selected (this defaults to `all').
+command line are selected (this defaults to `a').
.PP
Once the search has been performed, if the
.B \-list
.PP
Once the search has been performed, if the
.B \-list
@@
-223,7
+233,7
@@
output separated by newlines. This is
.B extremely
useful for
quickly generating arguments for other
.B extremely
useful for
quickly generating arguments for other
-.B nmh
+.B mmh
programs by using the
`backquoting' syntax of the shell. For example, the command
.PP
programs by using the
`backquoting' syntax of the shell. For example, the command
.PP
@@
-305,7
+315,7
@@
mark(1)
.SH DEFAULTS
.nf
.RB ` +folder "' defaults to the current folder"
.SH DEFAULTS
.nf
.RB ` +folder "' defaults to the current folder"
-.RB ` msgs "' defaults to all"
+.RB ` msgs "' defaults to all messages"
.RB ` "\-datefield date" '
.RB ` \-zero '
.RB ` \-list "' is the default if no `\-sequence', `\-nolist' otherwise"
.RB ` "\-datefield date" '
.RB ` \-zero '
.RB ` \-list "' is the default if no `\-sequence', `\-nolist' otherwise"
@@
-344,14
+354,14
@@
not, and merely matches the messages you specify. This lets you type
something like:
.PP
.RS 5
something like:
.PP
.RS 5
-show\0`pick\0last:20\0\-seq\0fear`
+show\0`pick\0l:20\0\-seq\0fear`
.RE
.PP
instead of typing
.PP
.RS 5
.nf
.RE
.PP
instead of typing
.PP
.RS 5
.nf
-mark\0\-add\0\-nozero\0\-seq\0fear\0last:20
+mark\0\-add\0\-nozero\0\-seq\0fear\0l:20
show\0fear
.fi
.RE
show\0fear
.fi
.RE
@@
-394,7
+404,7
@@
no output, and the argument given to the outer command as a result of
backquoting
.B pick
is empty. In the case of
backquoting
.B pick
is empty. In the case of
-.B nmh
+.B mmh
programs,
the outer command now acts as if the default `msg' or `msgs' should be
used (e.g., `all' in the case of
programs,
the outer command now acts as if the default `msg' or `msgs' should be
used (e.g., `all' in the case of
@@
-407,5
+417,16
@@
was given, and if its standard output is not a tty, then
outputs the illegal message number `0'
when it fails. This lets the outer command fail gracefully as well.
.PP
outputs the illegal message number `0'
when it fails. This lets the outer command fail gracefully as well.
.PP
+To account for this case when combining
+.B pick
+with regular shell tools, filter out the message number `0'.
+For example, do
+.PP
+.RS 5
+pick\0...\0|\0fgrep\0-vx\0\&0\0|\0wc\0-l
+.RE
+.PP
+to count the number of messages picked.
+.PP
The pattern syntax `[l-r]' is not supported; each letter to be
matched must be included within the square brackets.
The pattern syntax `[l-r]' is not supported; each letter to be
matched must be included within the square brackets.