-.TH "MYMAIL" "0.9.6" "March 2013" "Francois Fleuret" "User Commands"
+.TH "MYMAIL" "0.9.8" "April 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
matching mails in the db file. Multiple search requests can be
combined, and only mails fulfilling all of them will be extracted.
.TP
-\fB-d <db filename>\fR, \fB--db-file-generate <db filename>\fR
+\fB-d <db filename>\fR, \fB--db-file-output <db filename>\fR
set the db filename for indexing
.TP
\fB-i\fR, \fB--index\fR
defaut value for the --db-list argument
.TP
\fBMYMAIL_DB_FILE\fR
-defaut value for the --db-file argument
+defaut value for the --db-file-output argument
+.TP
+\fBMYMAILRC \fR
+configuration file, default is ${HOME}/.mymailrc
-.SH "SEARCH SYNTAX"
+.SH "SEARCH CONDITIONS"
-The search conditions take the form of a key which is a single letter,
-followed by a space and a regexp, which can itself contain spaces. If
-the condition is prefaced by the character "!" it is negated, and has
-to be false for a mail to be selected.
+A search condition is either a time-related condition
+('today', 'yesterday', etc.), or a single-character key, followed by a
+space and a regexp, which can itself contain spaces.
-The time-based conditions use as reference the time indicated in the
-heading From line, and not in the Date: field.
+If it is prefaced by the character "!", a condition is negated and has
+to be false for a mail to be selected.
.TP
\fBf <regexp>\fR (from)
-selects mails whose leading line From, or fields From:, Sender:,
+selects mails whose leading line 'From', or fields From:, Sender:,
Reply-To:, or Return-Path: matches the regexp.
.TP
\fBt <regexp>\fR (to)
selects mails whose field Date: matches the regexp.
.TP
\fBb <regexp>\fR (body)
+
selects mails whose body matches the regexp. Evaluating such a
-condition requires to read the original mboxes completely, which can
-be slow. However, header conditions are checked first to read the
-bodies only for mails which fulfill them entirely.
+condition requires to read the full mail from the original mboxes,
+which can be slow. To speed things up, all the header conditions are
+checked first.
.TP
-\fB8h\fR, \fB24h\fR, \fB48h\fR, \fBweek\fR, \fBmonth\fR, and
-\fByear\fR
-selects mails received during the last 8, 24, 24, 48, 7 * 24 hours, 31 *
-24 hours, and 365 * 24 hours respectively.
+\fB8h\fR, \fB24h\fR, \fB48h\fR, \fBweek\fR, \fBmonth\fR, \fBtrimester\fR,
+and \fByear\fR selects mails received during the last 8, 24, 24, 48, 7
+* 24 hours, 31 * 24 hours, 92 * 24 hours, and 365 * 24 hours respectively.
.TP
\fBtoday\fR
selects mails received since midnight.
.P
.nf
-.B mymail --db-file /tmp/mymail/2010-2011/mymail.db \e
+.B mymail --db-file-output /tmp/mymail/2010-2011/mymail.db \e
.B \ \ \ \ \ \ \ --index \e
.B \ \ \ \ \ \ \ ~/archives/mails/2010 ~/archives/mails/2011
recipient, without "spam" in the subject, received over the last 31
days, and create an mbox file /tmp/mymail/mbox.
+.SH "FILES"
+
+The configuration file is by default ${HOME}/.mymailrc and can also be
+specified through the MYMAILRC environment variable.
+
+It allows to define aliases of search keys, such as:
+
+.P
+.nf
+.B alias tod=today
+
.SH "BUGS"
The search in the mail bodies does not decode mimencoding mails, hence
will not catch patterns in encoded text.
-The mbox format is not clear for multipart messages, since the ^"From
-" may not always be quoted properly (at least the ones I use for
-testing).
+The mbox format is not clear for multipart messages, since the 'From'
+may not always be quoted properly, so mymail uses a strict regexp to
+recognize such lines.
-The date format for the ^Date: field is not standardized, and may not
-be parsed properly, in which case the time stamp from the mail leading
-^"From " will be used.
+The date format for the Date: field is not standardized, and may not
+be parsed properly. When that happens, the time stamp from the
+leading 'From' line of the mail, which has a canonical form, is used.
.SH "AUTHOR"