use $HOME where ~ (usually) does not expand

[notmuch-wiki] / initial_tagging.mdwn

diff --git a/initial_tagging.mdwn b/initial_tagging.mdwn
index 81bfd06e8ad98782205676d472890bc40d539afa..327fdadb96b4c012ac0ed3955fe8fcc7a52b7f0f 100644 (file)
--- a/initial_tagging.mdwn
+++ b/initial_tagging.mdwn
@@ -1,11 +1,20 @@
+[[!img notmuch-logo.png alt="Notmuch logo" class="left"]]
 # Approaches to initial tagging of messages
 
 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;
@@ -27,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.
 
@@ -34,7 +45,7 @@ You can use the `post-new` hook, which is automatically run after `notmuch new`,
 to do post-processing. See `man notmuch-hooks` for details on hooks.
 
 
-# Other solutions
+## Other solutions
 
 * [Carl Worth's approach to tagging](http://notmuchmail.org/pipermail/notmuch/2010/001691.html). It
   is email id:87r5o8stbj.fsf@yoom.home.cworth.org in the notmuch
@@ -63,9 +74,8 @@ 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).
 
-# Notmuch Delivery Agent -- `notmuch-deliver`
+## Notmuch MDA -- `notmuch-insert`
 
-The [Notmuch Delivery Agent](http://github.com/alip/notmuch-deliver/)
-([announcement](http://notmuchmail.org/pipermail/notmuch/2010/002871.html)) is
-a tool for delivering emails to maildir, add them to the Notmuch database, and
-tag them as desired.
+The [[notmuch insert command|manpages/notmuch-insert-1]] is a tool for
+delivering emails to maildir, indexing them to the Notmuch database, and tagging
+them as desired.