X-Git-Url: https://fleuret.org/cgi-bin/gitweb/gitweb.cgi?p=mymail.git;a=blobdiff_plain;f=mymail.1;h=09fa3248f2d4a42e33e6aec5b6f597a9466cae72;hp=820dddf9518c6efd3b997487931807367b0f6fef;hb=HEAD;hpb=b0293d67a5e22e083128d3b727c573ccebf80464 diff --git a/mymail.1 b/mymail.1 index 820dddf..09fa324 100644 --- a/mymail.1 +++ b/mymail.1 @@ -1,4 +1,4 @@ -.TH "MYMAIL" "0.9.8" "April 2013" "Francois Fleuret" "User Commands" +.TH "MYMAIL" "0.9.10" "July 2014" "Francois Fleuret" "User Commands" \" This man page was written by Francois Fleuret \" and is distributed under a Creative Commons Attribution-Share Alike @@ -35,6 +35,10 @@ do not write information during the search use the time stamp from the leading line of each mail and not the Date: field .TP +\fB-f\fR, \fB--do-not-discard-mails-from-the-future\fR +keep mails with a date (more than 24h) in the future, which are +discarded by default +.TP \fB-p \fR, \fB--db-pattern \fR set the db filename pattern for recursive search .TP @@ -47,9 +51,9 @@ set the semicolon-separated list of db files for search \fB-m \fR, \fB--mbox-pattern \fR set the mbox filename pattern for recursive search .TP -\fB-s \fR, \fB--search \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. +\fB-s \fR, \fB--search \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 \fR, \fB--db-file-output \fR set the db filename for indexing @@ -58,8 +62,12 @@ set the db filename for indexing index mails in the mailboxes located recursively anywhere in the directories following the options on the command lines .TP -\fB-o \fR, \fB--output \fR set the -result mbox filename. If it is not set, the standard output is used +\fB-o \fR, \fB--output \fR +set the result mbox filename. If it is not set, the standard output is +used +.TP +\fB-n \fR, \fB--nb-mails-max \fR +set the maximum number of mails to extract (default is 250) .TP \fB-a \fR, \fB--default-search \fR set the default search key. If a search request is not understood, @@ -79,6 +87,9 @@ defaut value for the --db-list argument .TP \fBMYMAIL_DB_FILE\fR defaut value for the --db-file-output argument +.TP +\fBMYMAILRC \fR +configuration file, default is ${HOME}/.mymailrc .SH "SEARCH CONDITIONS" @@ -107,15 +118,15 @@ selects mails whose field Subject: matches the regexp. selects mails whose field Date: matches the regexp. .TP \fBb \fR (body) - selects mails whose body matches the regexp. Evaluating such a condition requires to read the full mail from the original mboxes, which can be slow. To speed things up, all the header conditions are checked first. .TP -\fB8h\fR, \fB24h\fR, \fB48h\fR, \fBweek\fR, \fBmonth\fR, \fBtrimester\fR, -and \fByear\fR selects mails received during the last 8, 24, 24, 48, 7 -* 24 hours, 31 * 24 hours, 92 * 24 hours, and 365 * 24 hours respectively. +\fB1h\fR, \fB2h\fR, \fB4h\fR, \fB8h\fR, \fB24h\fR, \fB48h\fR, \fBweek\fR, \fB2weeks\fR, \fBmonth\fR, \fBtrimester\fR, \fBsemester\fR, and \fByear\fR +select mails received during the last +1, 2, 4, 8, 24, 48, 7 * 24 hours, 14 * 24 hours, 31 * 24 hours, 92 * +24 hours, 185 * 24 hours, and 365 * 24 hours respectively. .TP \fBtoday\fR selects mails received since midnight. @@ -124,7 +135,7 @@ selects mails received since midnight. selects mails received yesterday. .TP \fBmonday\fR, \fBtuesday\fR, ..., \fBsunday\fR -selects mails received the most recent such day of the week. +select mails received the most recent such day of the week. .SH "EXAMPLES" @@ -160,7 +171,7 @@ days, and create an mbox file /tmp/mymail/mbox. .SH "FILES" The configuration file is by default ${HOME}/.mymailrc and can also be -specificied through the MYMAILRC environment variable. +specified through the MYMAILRC environment variable. It allows to define aliases of search keys, such as: @@ -179,8 +190,7 @@ recognize such lines. 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. +leading 'From' line of the mail, which has a canonical form, is used. .SH "AUTHOR"