Fixed a bug for the last mail of each db (it was ignored ...) + redefined "today"

[mymail.git] / mymail.1

diff --git a/mymail.1 b/mymail.1
index 95b83f0..596a6e0 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
@@ -31,6 +31,10 @@ print the version number
 \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
@@ -57,9 +61,9 @@ directories following the options on the command lines
 \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"
 
@@ -78,10 +82,13 @@ defaut value for the --db-file argument
 
 .SH "SEARCH SYNTAX"
 
-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.
+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)
@@ -106,16 +113,16 @@ 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"
 
@@ -154,8 +161,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"