initial_tagging: add a reference to p6-notmuch-filter

[notmuch-wiki] / initial_tagging.mdwn

diff --git a/initial_tagging.mdwn b/initial_tagging.mdwn
index c7bed037a377fa3670fd2f2c67b75ac03c1a9d33..e1c63468f2f3cd9104c95f1aae1dc4bbf7dfed98 100644 (file)
--- a/initial_tagging.mdwn
+++ b/initial_tagging.mdwn
@@ -4,9 +4,17 @@
 This page collects scripts and strategies for organizing mail using
 notmuch and doing automated initial tagging.
 
-Here's a very general and ad-hoc approach to initial message tagging.
 The `[new]` config section allows you to control which tags new messages
-receive.  This sets all new messages to get the *new* tag:
+receive. By default, `notmuch config` will use the tags *inbox* and *unread*.
+
+If `maildir.synchronize_flags` is true (which is the default), Maildir flags 
+have precedence over the initial tags. Thus an already read mail gets its 
+initial *unread* tag correctly removed.
+
+## The *new* tag approach
+
+Here's another very general and ad-hoc approach to initial message tagging, 
+which sets all new messages to get the *new* tag:
 
     [new]
     tags=new;
@@ -28,6 +36,8 @@ following:
     # finally, retag all "new" messages "inbox" and "unread"
     notmuch tag +inbox +unread -new -- tag:new
 
+Note that the command above will mark a new but already-read mail as unread.
+
 Since the post-processing is only acting on a few messages, it is
 generally extremely fast.
 
@@ -64,6 +74,10 @@ to do post-processing. See `man notmuch-hooks` for details on hooks.
   of sent mails) and has some fancy features (e.g. mail classification
   using bayesian filters).
 
+* [p6-notmuch-filter](https://github.com/goneri/p6-notmuch-filter) a initial
+  tagging script that read its configuration from a JSON file. The script is
+  written in Perl6 and depends on the Email::Notmuch binding.
+
 ## Notmuch MDA -- `notmuch-insert`
 
 The [[notmuch insert command|manpages/notmuch-insert-1]] is a tool for