Cosmetics.

[mymail.git] / mymail.1

diff --git a/mymail.1 b/mymail.1
index b79b4b9..a4d7a38 100644 (file)
--- a/mymail.1
+++ b/mymail.1
@@ -1,4 +1,4 @@
-.TH "MYMAIL" "0.9.2" "February 2013" "Francois Fleuret" "User Commands"
+.TH "MYMAIL" "0.9.5" "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
@@ -40,11 +40,14 @@ set the db root path for recursive search
 \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-generate <db filename>\fR
 set the db filename for indexing
 .TP
 \fB-i\fR, \fB--index\fR
@@ -80,6 +83,9 @@ 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 condition 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:,
@@ -103,39 +109,43 @@ 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, \fBtoday\fR, \fB24h\fR, \fBweek\fR, \fBmonth\fR, and
+\fB8h\fR, \fBtoday\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
 \fByesterday\fR
 selects mails received between 48h and 24h ago.
 .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"
 
 The command
 
+.P
 .nf
 .B mymail --db-file /tmp/mymail/2010-2011/mymail.db \e
-.B        --index \e
-.B        ~/archives/mails/2010 ~/archives/mails/2011
+.B \ \ \ \ \ \ \ --index \e
+.B \ \ \ \ \ \ \ ~/archives/mails/2010 ~/archives/mails/2011
 
+.fi
 will index all the mbox files present in the directories
 ~/archives/mails/2010 and ~/archives/mails/2011 (recursively) and
 create an index file /tmp/mymail/2010-2011/mymail.db
 
 And
 
+.P
 .nf
 .B mymail --db-pattern '\.db$' --db-root /tmp/mymail \e
-.B        --output /tmp/mymail.mbox \e
-.B        --search 'p bob.something' \e
-.B        --search '!s spam' \e
-.B        --search 'month'
+.B \ \ \ \ \ \ \ --output /tmp/mymail.mbox \e
+.B \ \ \ \ \ \ \ --search 'p bob.something' \e
+.B \ \ \ \ \ \ \ --search '!s spam' \e
+.B \ \ \ \ \ \ \ --search 'month'
 
+.fi
 will 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, received over the last 31
@@ -147,8 +157,8 @@ 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).
+" lines are not always quoted properly (at least the ones I use for
+testing).
 
 .SH "AUTHOR"