-.TH "MYMAIL" "0.9" "February 2013" "Francois Fleuret" "User Commands"
+.TH "MYMAIL" "0.9.1" "February 2013" "Francois Fleuret" "User Commands"
\" This man page was written by Francois Fleuret <francois@fleuret.org>
\" and is distributed under a Creative Commons Attribution-Share Alike
.SH "SYNOPSIS"
-\fBmymail\fP [\fIoptions\fR] [\fI<mbox dir1>\fR [\fI<mbox dir2>\fR ...]]
+\fBmymail\fP [\fIoptions\fR] [\fI<mbox dir1>\fR [\fI<mbox dir2>\fR ... ]|\fI<db file1>\fR [\fI<db file2>\fR ... ]]\n");
.SH "DESCRIPTION"
-\fBmymail\fP is a command line utility for to index mbox files and
-perform quick searches based on sender, subject, etc.
+\fBmymail\fP is a command line utility to index mbox files and perform
+quick searches based on sender, subject, etc.
It is similar in spirit to other existing software such as mu or
notmuch, but does not use a real database backend to store and query
\fB-v\fR, \fB--version\fR
print the version number
.TP
+\fB-q\fR, \fB--quiet\fR
+do not write information during the search
+.TP
\fB-p <db filename pattern>\fR, \fB--db-pattern <db filename pattern>\fR
set the db filename pattern for recursive search
.TP
\fB-i\fR, \fB--index\fR
index mails in the mailboxes located recursively anywhere in the
directories following the options on the command lines
+.TP
+\fB-o <output filename>\fR, \fB--output <output filename>\fR
+set the db filename pattern for recursive search
.SH "ENVIRONMENT VARIABLES"
for a mail to be selected.
.TP
-\fBf <regexp>\fR selects mails whose field From, From:, or Reply-To: matches the regexp.
+\fBf <regexp>\fR (from) selects mails whose leading line From, or
+fields From:, or Reply-To: matches the regexp.
+.TP
+\fBt <regexp>\fR (to) selects mails whose field To:, Cc:, or Bcc: matches the regexp.
.TP
-\fBt <regexp>\fR selects mails whose field To:, Cc:, or Bcc: matches the regexp.
+\fBp <regexp>\fR (participant) selects mails whose leading line From,
+or fields From:, Reply-To:, To:, Cc:, or Bcc: matches the regexp.
.TP
-\fBp <regexp>\fR selects mails whose field From, From:, Reply-To:, To:, Cc:, or Bcc: matches the regexp.
+\fBs <regexp>\fR (subject) selects mails whose field Subject: matches the regexp.
.TP
-\fBs <regexp>\fR selects mails whose field Subject: matches the regexp.
+\fBd <regexp>\fR (date) selects mails whose field Date: matches the regexp.
.TP
-\fBd <regexp>\fR selects mails whose field Date: matches the regexp.
+\fBb <regexp>\fR (body) selects mails whose body matches the
+regexp. This requires reading the original mboxes completely, which
+can be slow. Header conditions have to be fulfilled before checking
+the body ones, which may speed things up.
.SH "EXAMPLES"
To search in all the database files *.db located (recursively) in
/tmp/mymail, for all the mails having bob.something as sender or
-recipient, without "spam" in the subject, and creating a result mbox
+recipient, without "spam" in the subject, and create a result mbox
file /tmp/mymail/mbox
.RS
.SH "BUGS"
-None known, probably many.
+The search in the mail bodies does not decode mimencoding mails, hence
+will not catch patterns in encoded text.
.SH "AUTHOR"