-.TH "MYMAIL" "0.9.2" "February 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
\fB-q\fR, \fB--quiet\fR
do not write information during the search
.TP
+\fB-t\fR, \fB--use-leading-time\fR
+use the time stamp from the leading line of each mail and not the
+Date: field
+.TP
\fB-p <db filename pattern>\fR, \fB--db-pattern <db filename pattern>\fR
set the db filename pattern for recursive search
.TP
\fB-l <db filename list>\fR, \fB--db-list <db filename list>\fR
set the semicolon-separated list of db files for search
.TP
+\fB-m <mbox filename pattern>\fR, \fB--mbox-pattern <mbox filename pattern>\fR
+set the mbox filename pattern for recursive search
+.TP
\fB-s <search pattern>\fR, \fB--search <search pattern>\fR search for
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 <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
\fB-o <output filename>\fR, \fB--output <output filename>\fR set the
result mbox filename. If it is not set, the standard output is used
.TP
-\fB-a <search field>\fR, \fB--default-search <search field>\fR
-set the default search field. If a search request is not understood,
-it is interpreted as the regexp with this default search field
+\fB-a <search key>\fR, \fB--default-search <search key>\fR
+set the default search key. If a search request is not understood,
+it is interpreted as the regexp with this default search key
.SH "ENVIRONMENT VARIABLES"
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
+
+.SH "SEARCH CONDITIONS"
-.SH "SEARCH SYNTAX"
+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 search conditions take the form of 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.
+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)
be slow. However, header conditions are checked first to read the
bodies only for mails which fulfill them entirely.
.TP
-\fB8h\fR, \fBtoday\fR, \fB24h\fR, \fBweek\fR, \fBmonth\fR, and
+\fB8h\fR, \fB24h\fR, \fB48h\fR, \fBweek\fR, \fBmonth\fR, and
\fByear\fR
-selects mails received during the last 8, 24, 24, 7 * 24 hours, 31 *
+selects mails received during the last 8, 24, 24, 48, 7 * 24 hours, 31 *
24 hours, and 365 * 24 hours respectively.
.TP
+\fBtoday\fR
+selects mails received since midnight.
+.TP
\fByesterday\fR
-selects mails received between 48h and 24h ago.
+selects mails received yesterday.
.TP
\fBmonday\fR, \fBtuesday\fR, ..., \fBsunday\fR
-selects mails received the most recent such day of the week
+selects mails received the most recent such day of the week.
.SH "EXAMPLES"
.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
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
-" lines are not always quoted properly (at least the ones I have to
-test).
+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. When that happens, the time stamp from the
+leading 'From' line of the mail, which has a canonical form, is be
+used.
.SH "AUTHOR"