-.TH "MYMAIL" "0.9.8" "April 2013" "Francois Fleuret" "User Commands"
+.TH "MYMAIL" "0.9.9" "June 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-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.
+\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-output <db filename>\fR
set the db filename for indexing
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
-result mbox filename. If it is not set, the standard output is used
+\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-n <max number of mails>\fR, \fB--nb-mails-max <max number of mails>\fR
+set the maximum number of mails to extract (default is 250)
.TP
\fB-a <search key>\fR, \fB--default-search <search key>\fR
set the default search key. If a search request is not understood,
.TP
\fBMYMAIL_DB_FILE\fR
defaut value for the --db-file-output argument
+.TP
+\fBMYMAILRC \fR
+configuration file, default is ${HOME}/.mymailrc
.SH "SEARCH CONDITIONS"
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, \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.
+\fB8h\fR, \fB24h\fR, \fB48h\fR, \fBweek\fR, \fBmonth\fR, \fBtrimester\fR, and \fByear\fR
+
+select mails received during the last 8, 24, 48, 7 * 24 hours, 31 *
+24 hours, 92 * 24 hours, and 365 * 24 hours respectively.
.TP
\fBtoday\fR
+
selects mails received since midnight.
.TP
\fByesterday\fR
selects mails received yesterday.
.TP
\fBmonday\fR, \fBtuesday\fR, ..., \fBsunday\fR
-selects mails received the most recent such day of the week.
+select mails received the most recent such day of the week.
.SH "EXAMPLES"
.SH "FILES"
The configuration file is by default ${HOME}/.mymailrc and can also be
-specificied through the MYMAILRC environment variable.
+specified through the MYMAILRC environment variable.
It allows to define aliases of search keys, such as:
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.
+leading 'From' line of the mail, which has a canonical form, is used.
.SH "AUTHOR"