* cfind: add support for the --after and --personal parameters, and document them

This commit is contained in:
djcb
2012-06-20 09:20:15 +03:00
parent b150f45090
commit 2c99e598a1
4 changed files with 50 additions and 9 deletions

View File

@ -1,4 +1,4 @@
.TH MU CFIND 1 "May 2011" "User Manuals"
.TH MU CFIND 1 "June 2012" "User Manuals"
.SH NAME
@ -61,6 +61,24 @@ sets the output format to the given value. The following are available:
| csv | comma-separated values |
.fi
.TP
\fB\-\-personal\fR only show addresses seen in messages where one of 'my'
e-mail addresses was seen in one of the address fields; this is to exclude
addresses only seen in mailing-list messages. See the \fB\-\-my-address\fR
parameter in \fBmu index\fR.
.TP
\fB\-\-after=\fR\fI<timestamp>\fR only show addresses last seen after
\fI<timestamp>\fR. \fI<timestamp>\fR is a UNIX \fBtime_t\fR value, the number
of seconds since 1970-01-01 (in UTC).
From the command line, you can use the \fBdate\fR command to get this
value. For example, only consider addresses last seen after 2009-06-01, you
could specify
.nf
--after=`date +%s --date='2009-06-01'`
.fi
.SH RETURN VALUE
\fBmu cfind\fR returns 0 upon successful completion -- that is, at least one