X-Git-Url: https://fleuret.org/cgi-bin/gitweb/gitweb.cgi?p=mymail.git;a=blobdiff_plain;f=mymail.1;h=62d6def24b9eda9e35b5608aa724c53e6b669a46;hp=f02cb7161a1054b166c32521ead0c86d85e2ba48;hb=0ea4d09380ffcc4063d2fed55078f91ff59e72fa;hpb=23dfd346be9c44b7e2a92e9159ec41fd85c08814

diff --git a/mymail.1 b/mymail.1
index f02cb71..62d6def 100644
--- a/mymail.1
+++ b/mymail.1
@@ -1,4 +1,4 @@
-.TH "MYMAIL" "0.9" "February 2013" "Francois Fleuret" "User Commands"
+.TH "MYMAIL" "0.9.1" "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
@@ -10,7 +10,7 @@ mymail \- A simple command line utility for indexing and searching mbox files
 
 .SH "SYNOPSIS"
 
-\fBmymail\fP [\fIoptions\fR] [\fI<mbox dir1>\fR [\fI<mbox dir2>\fR ...]]
+\fBmymail\fP [\fIoptions\fR] [\fI<mbox dir1>\fR [\fI<mbox dir2>\fR ... ]|\fI<db file1>\fR [\fI<db file2>\fR ... ]]\n");
 
 .SH "DESCRIPTION"
 
@@ -29,6 +29,9 @@ display help and exit
 \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-p <db filename pattern>\fR, \fB--db-pattern <db filename pattern>\fR
 set the db filename pattern for recursive search
 .TP
@@ -47,6 +50,9 @@ set the db filename for indexing
 \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 db filename pattern for recursive search
 
 .SH "ENVIRONMENT VARIABLES"
 
@@ -71,15 +77,34 @@ is prefaced by the character "!" it is negated, and has to be false
 for a mail to be selected.
 
 .TP
-\fBf <regexp>\fR selects mails whose field From, From:, or Reply-To: matches the regexp.
+\fBf <regexp>\fR (from) selects mails whose leading line From, or
+fields From:, or Reply-To: 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 whose leading line From,
+or fields From:, Reply-To:, To:, Cc:, or Bcc: matches the regexp.
+.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. Evaluatin 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 selects mails received during the last 8 hours.
 .TP
-\fBt <regexp>\fR selects mails whose field To:, Cc:, or Bcc: matches the regexp.
+\fBtoday\fR, \fB24h\fR selects mails received during the last 24 hours.
 .TP
-\fBp <regexp>\fR selects mails whose field From, From:, Reply-To:, To:, Cc:, or Bcc: matches the regexp.
+\fBweek\fR selects mails received during the last 7*24 hours.
 .TP
-\fBs <regexp>\fR selects mails whose field Subject: matches the regexp.
+\fByesterday\fR selects mails received between 48h and 24h ago.
 .TP
-\fBd <regexp>\fR selects mails whose field Date: matches the regexp.
+\fBmonday\fR, \fBtuesday\fR, ..., \fBsunday\fR selects mails received
+the most recent such day
 
 .SH "EXAMPLES"
 
@@ -95,7 +120,7 @@ mymail --db-file /tmp/mymail/2010-2011/mymail.db --index ~/archives/mails/2010 ~
 
 To 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, and creating a result mbox
+recipient, without "spam" in the subject, and create a result mbox
 file /tmp/mymail/mbox
 
 .RS
@@ -106,7 +131,8 @@ mymail --db-pattern '\\.db$' --db-root /tmp/mymail --search 'p bob.something' --
 
 .SH "BUGS"
 
-None known, probably many.
+The search in the mail bodies does not decode mimencoding mails, hence
+will not catch patterns in encoded text.
 
 .SH "AUTHOR"