diff --git a/man/mu-easy.1 b/man/mu-easy.1 index 68a3c431..ebeb1d99 100644 --- a/man/mu-easy.1 +++ b/man/mu-easy.1 @@ -45,11 +45,109 @@ with e-mail clients; see the \fBmu-find\fR man page for details, the syntax of the search parameters and so on. Here, we just give some examples for common cases. -First, let's search for all mail from Mickey Mouse about birds: +First, let's search for all messages sent to Julius Caesar regarding fruit: + .nf -\fB$ mu find f:mickey birds\fR +\fB$ mu find t:julius fruit\fR .fi +This should return something like: + +.nf + 2008-07-31T21:57:25 EEST John Milton Fere libenter homines id quod volunt credunt +.fi + +This means there is a message to 'julius' with 'fruit' somewhere in the +message. In this case, it's a message from John Milton. Note that the display +of the date depends on your system locale. + +How do we know that the message was sent to Julius Caesar? Well, it's not +visible from the results above, because the default fields that are shown are +date-sender-subject. However, we can change this using the \fI--fields\fR +parameter (see the \fBmu-find\fR man page for the details): + +.nf +\fB$ mu find --fields="t s" t:julius fruit\fR +.fi + +In other words, display the 'To:'-field (t) and the subject (s). This should +return something like: +.nf + Julius Caesar Fere libenter homines id quod volunt credunt +.fi + +This is the same message found before, only with some different fields displayed. + +By default, \fBmu\fR uses the logical \fBand\fR for the search parameters -- +that is, it displays messages that match all the parameters. However, we can +use logical \fBor\fR as well: + +.nf +\fB$ mu find t:julius OR f:socrates\fR +.fi + +In other words, display messages that are either sent to Julius Caesar +\fBor\fR are from Socrates. This could return something like: + +.nf + 2008-07-31T21:57:25 EEST Socrates cool stuff + 2008-07-31T21:57:25 EEST John Milton Fere libenter homines id quod volunt credunt +.fi + +What if we want to see some of the body of the message? You can list (parts +of) the message contents by using the --summary-len=\fIn\fR option, which +will 'summarize' the first \fIn\fR lines of the message: + +.nf +\fB$ mu find --summary-len=4 napoleon m:/archive\fR +.fi + +.nf + 1970-01-01T02:00:00 EET Napoleon Bonaparte rock on dude + Summary: Le 24 février 1815, la vigie de Notre-Dame de la Garde signala le + trois-mâts le Pharaon, venant de Smyrne, Trieste et Naples. Comme + d'habitude, un pilote côtier partit aussitôt du port, rasa le château +.fi + +The summary consists of the first n lines of the message with all superfluous +whitespace removed. + +Also note the \fBm:/archive\fR parameter in the query. This means that we only +match messages in a maildir called '/archive'. + +.SH DISPLAYING MESSAGES + +We might also want to display complete messages. This can be done using \fBmu +view\fR command. Note that this command does not use the database; you simply +provide the path to a message. + +Therefore, if you want to display some message from a search query, you'll +need its path. To get the path (think \fBl\fRocation) for our first example we +can use: + +.nf +\fB$ mu find --fields="l" t:julius fruit\fR +.fi + +And we'll get someting like: +.nf + /home/someuser/Maildir/archive/cur/1266188485_0.6850.cthulhu:2, +.fi +We can now display this message: + +.nf +\fB$ mu view /home/someuser/Maildir/archive/cur/1266188485_0.6850.cthulhu:2,\fR + + From: John Milton + To: Julius Caesar + Subject: Fere libenter homines id quod volunt credunt + Date: 2008-07-31T21:57:25 EEST + + OF Mans First Disobedience, and the Fruit + Of that Forbidden Tree, whose mortal tast + Brought Death into the World, and all our woe, +[...] +.fi .SH BUGS Please report bugs if you find them: