mirror of https://github.com/djcb/mu.git
75 lines
1.6 KiB
Groff
75 lines
1.6 KiB
Groff
.TH MU CFIND 1 "March 2011" "User Manuals"
|
|
|
|
.SH NAME
|
|
|
|
mu cfind \- find contacts in the
|
|
.B mu
|
|
database and/or export
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.B mu cfind [options] [<pattern>]
|
|
|
|
.SH DESCRIPTION
|
|
|
|
\fBmu cfind\fR is the \fBmu\fR command for finding contacts (i.e., people who
|
|
were either the sender or receiver of mail).
|
|
|
|
.SH SEARCHING CONTACTS
|
|
|
|
When you index your messages (see \fBmu index\fR), \fBmu\fR creates a list of
|
|
all unique e-mail addresses found, and the accompanying name. In case the same
|
|
e-mail address is used with different names, the most recent one is used.
|
|
|
|
\fBmu cfind\fR starts a search for contacts that match a \fIregular
|
|
expression\fR. For example:
|
|
|
|
.nf
|
|
$ mu cfind '@gmail\.com'
|
|
.fi
|
|
|
|
would find all contacts with a gmail-address, while
|
|
|
|
.nf
|
|
$ mu cfind Mary
|
|
.fi
|
|
|
|
would find all contact with Mary in either name or e-mail address.
|
|
|
|
.SH OPTIONS
|
|
|
|
.TP
|
|
\fB\-\-format\fR=
|
|
set the file access mode for the new maildir(s) as in \fBchmod(1)\fR.
|
|
|
|
|
|
.SH RETURN VALUE
|
|
|
|
\fBmu find\fR return 0 upon successful completion; if it the a search was
|
|
performed, there needs to be a least one match. Anything else leads to a
|
|
non-zero return value, for example:
|
|
|
|
.sh
|
|
| code | meaning |
|
|
|------+--------------------------------|
|
|
| 0 | ok |
|
|
| 1 | general error |
|
|
| 2 | no matches (for 'mu cfind') |
|
|
.si
|
|
|
|
.SH BUGS
|
|
|
|
Please report bugs if you find them:
|
|
.BR http://code.google.com/p/mu0/issues/list
|
|
If you have specific messages which are not matched correctly, please attach
|
|
them (appropriately censored of course).
|
|
|
|
.SH AUTHOR
|
|
|
|
Dirk-Jan C. Binnema <djcb@djcbsoftware.nl>
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
.BR mu(1)
|
|
.BR mu-index(1)
|