X-Git-Url: https://fleuret.org/cgi-bin/gitweb/gitweb.cgi?a=blobdiff_plain;f=mymail.1;h=24a5ea53995761cfd1d0cb2ce1411cae39343418;hb=9385a49c7a296bdaf163a280d68173a896f11f78;hp=a4d7a38f56dbf73d428505b5d2a04eaa124c53b7;hpb=e148acdc121e42c9db6ac6b2b494407ab2a0bd06;p=mymail.git diff --git a/mymail.1 b/mymail.1 index a4d7a38..24a5ea5 100644 --- a/mymail.1 +++ b/mymail.1 @@ -1,4 +1,4 @@ -.TH "MYMAIL" "0.9.5" "February 2013" "Francois Fleuret" "User Commands" +.TH "MYMAIL" "0.9.8" "March 2013" "Francois Fleuret" "User Commands" \" This man page was written by Francois Fleuret \" 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 \fR, \fB--db-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 \fR, \fB--output \fR set the result mbox filename. If it is not set, the standard output is used .TP -\fB-a \fR, \fB--default-search \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 \fR, \fB--default-search \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,17 +82,14 @@ 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 time-based condition use as reference the time indicated in the -heading From line, and not in the Date: field. +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. .TP \fBf \fR (from) -selects mails whose leading line From, or fields From:, Sender:, +selects mails whose leading line 'From', or fields From:, Sender:, Reply-To:, or Return-Path: matches the regexp. .TP \fBt \fR (to) @@ -109,13 +110,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, \fB48h\fR, \fBweek\fR, \fBmonth\fR, and +\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 between 48h and 24h ago. +selects mails received yesterday. .TP \fBmonday\fR, \fBtuesday\fR, ..., \fBsunday\fR selects mails received the most recent such day of the week. @@ -156,10 +160,15 @@ days, and create an mbox file /tmp/mymail/mbox. 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 use for +The mbox format is not clear for multipart messages, since the 'From' +may not always be quoted properly (at least the ones I use for testing). +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. + .SH "AUTHOR" Written by Francois Fleuret and distributed