+\fBmymail\fP is a command line utility to index mbox files, search for
+mails based on sender, subject, etc. and generate result mbox files.
+
+It is similar in spirit to other tools such as mu or notmuch, but is
+overall simpler.
+
+.SH "OPTIONS"
+.TP
+\fB-h\fR, \fB--help\fR
+display help and exit
+.TP
+\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-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-r <db root path>\fR, \fB--db-root <db root path>\fR
+set the db root path 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-generate <db filename>\fR
+set the db filename for indexing
+.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
+result mbox filename. If it is not set, the standard output is used
+.TP
+\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"
+
+.TP
+\fBMYMAIL_DB_PATTERN\fR
+defaut value for the --db-pattern argument
+.TP
+\fBMYMAIL_DB_ROOT\fR
+defaut value for the --db-root argument
+.TP
+\fBMYMAIL_DB_LIST\fR
+defaut value for the --db-list argument
+.TP
+\fBMYMAIL_DB_FILE\fR
+defaut value for the --db-file argument
+
+.SH "SEARCH SYNTAX"
+
+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.
+
+The time-based conditions use as reference the time indicated in the
+heading From line, and not in the Date: field.
+
+.TP
+\fBf <regexp>\fR (from)
+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 To:, Cc:, or Bcc: matches the regexp.
+.TP
+\fBp <regexp>\fR (participant)
+selects mails that would be selected by \fBf\fR or \fBt\fR.
+.TP
+\fBs <regexp>\fR (subject)
+selects mails whose field Subject: matches the regexp.
+.TP
+\fBd <regexp>\fR (date)
+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.
+.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.
+.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.