* update mu-easy manpage

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 <jm@example.com> 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 <jc@example.com> 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 <soc@example.com> cool stuff
+  2008-07-31T21:57:25 EEST John Milton <jm@example.com> 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 <nb@example.com> 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 <jm@example.com>
+  To: Julius Caesar <jc@example.com>
+  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: