Updated the CREATING-RULES file.

* Added a short explanation about partial match in headers.
git-archimport-id: frederic@jolliton.com--2004-private/mail-filter--main--0.1.1--patch-6

diff --git a/CREATING-RULES b/CREATING-RULES
index 873bce4..05db1d6 100644 (file)
--- a/CREATING-RULES
+++ b/CREATING-RULES
@@ -100,6 +100,22 @@ where:
  * HEADER-NAME name a header, where all blanks character sequence are
    considered as just one space character.
 
+   HEADER-NAME can optionnaly be followed by one of the following
+   extension to match a subset of the text in the header:
+
+   - '.raw'     do nothing.
+   - '.name'    extract the name part.
+   - '.address' extract the email address part.
+   - '.user'    extract the username before the @ in email address.
+   - '.domain'  extract the domain name of the email address.
+
+   Example with header 'From: Frederic Jolliton <frederic@jolliton.com>, a@b.c (Foo)':
+
+     'From.name'    -> [ 'Frederic Jolliton' , 'Foo' ]
+     'From.address' -> [ 'frederic@jolliton.com' , 'a@b.c' ]
+     'From.user'    -> [ 'frederic' , 'a' ]
+     'From.domain'  -> [ 'jolliton.com' , 'b.c' ]
+
  * MATCH-TYPE give the type of match to perform against the header.
    Each match type take an argument.