* document the recent changes

NEWS

@@ -4,10 +4,14 @@
    
    - FreeBSD build fix 
    - fix matching for mu cfind to be as expected
+   - fix mu-contacts for broken names/emails
+   - clear the contacts-cache too when doing a --rebuild
    - wildcard searches ('*') for fields (except for path/maildir) 
    - search for attachment file names (with 'a:'/'attach:') -- also works with
      wildcards
    - remove --xquery completely; use --output=xquery instead
+   - fix progress info in 'mu index'
+   - update documentation, add more examples
  
 ** Release 0.9.5 <2011-04-25 Mon>
 

man/mu-cfind.1

@@ -1,4 +1,4 @@
-.TH MU CFIND 1 "April 2011" "User Manuals"
+.TH MU CFIND 1 "May 2011" "User Manuals"
 
 .SH NAME 
 

man/mu-easy.1

@@ -229,7 +229,7 @@ expression, \fBmu cfind\fR lists all of your contacts.
 .fi
 
 will find all contacts with 'julius' in either name or e-mail address. Note
-that \fBmu cfind\fR accepts a regular expression.
+that \fBmu cfind\fR accepts a \fIregular expression\fR.
 
 \fBmu cfind\fR also supports a \fI--format=\fR-parameter, which sets the
 output to some specific format, so the results can be imported into another

man/mu-extract.1

@@ -19,9 +19,10 @@ For attachments, the file name used for saving is the name of the attachment
 in the message. If there is no such name, or when saving other MIME-parts, a
 name is derived from the message-id of the message.
 
-If you specify a pattern (a case-insensitive regular expression)as the second
+If you specify a pattern (a case-insensitive regular expression) as the second
 argument, all attachments with filenames matching that pattern will be
-extracted.
+extracted. The regular expressions are Perl-compatible (as per the
+PCRE-library).
 
 Without any options, \fBmu extract\fR simply outputs the list of MIME-parts in
 the message.

man/mu-find.1

@@ -73,8 +73,9 @@ mails with a subject containing a word starting with \fBcom\fR, you can use:
 
 and get mails about computers, comments, compilation and so on. Note, when
 running from the command-line it's import to put the query in quotes,
-otherwise the shell would interpret the '*'.
-
+otherwise the shell would interpret the '*'. It is important to remember that
+the '*' invokes the wildcard search only when used as the rightmost character
+of a search term. Furthermore, it is \fBnot\fR a regular expression. 
 
 In older versions of mu, queries were logged in \fI<mu-home>/mu.log\fR;
 however, since version 0.9, mu no longer does this.

www/cheatsheet.org

@@ -51,10 +51,34 @@ Here are some tips for using =mu=. If you want to know more, please refer to the
 #+begin_src sh
    $ mu find 'subject:soc*' flag:unread
 #+end_src
+    
+** Find contacts
+   
+   Contacts (names + email addresses) are cached separately, and can be
+   searched with =mu cfind= (after your messages have been indexed):
+
+*** all contacts with 'john' in either name or e-mail address   
+#+begin_src sh
+   $ mu cfind john
+#+end_src
+    
+ =mu cfind= takes a regular expression for matching.
+   
+    You can export the contact information to a number of formats for use in
+    e-mail clients. For examples:
+
+*** export /all/ your contacts to the =mutt= addressbook format
+
+#+begin_src sh
+   $ mu cfind --format=mutt-alias
+#+end_src
+
+    Other formats are: =plain=, =mutt-ab=, =wl= (Wanderlust), =org-contact=,
+ =bbdb= and =csv= (comma-separated values).
+ 
 
 ** Retrieving attachments from messages
    
-
    You can retrieve attachments from messages using =mu extract=, which takes a
    message file as an argument. Without any other arguments, it displays the
    MIME-parts of the message. You can then get specific attachments:
@@ -69,9 +93,12 @@ Here are some tips for using =mu=. If you want to know more, please refer to the
    $ mu extract my-msg-file '.*\.jpg'
 #+end_src
 
-   The second argument is a case-insensitive regular expression, and the command
-   will extract any files matching the pattern -- in the example, all
- =.jpg=-files.
+   The second argument is a case-insensitive regular expression, and the
+   command will extract any files matching the pattern -- in the example, all
+ =.jpg=-files. 
+
+   Do not confuse the '.*' regular expression in =mu extract= (and =mu cfind=
+   with the '*' wildcard in =mu find=.