initial_tagging: document tagging of read mails

Document the default initial tags, and the behavior when sync already
read mails with synchronize_flags=true.

In the meantime, add a title for the *new* tag approach.

# Please enter the commit message for your changes. Lines starting
# with '#' will be kept; you may remove them yourself if you want to.
# An empty message aborts the commit.
# On branch master
# Your branch is up-to-date with 'origin/master'.
#
# Changes to be committed:
#	modified:   initial_tagging.mdwn
#

diff --git a/initial_tagging.mdwn b/initial_tagging.mdwn
index c7bed037a377fa3670fd2f2c67b75ac03c1a9d33..327fdadb96b4c012ac0ed3955fe8fcc7a52b7f0f 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.
 
 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
 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;
 
     [new]
     tags=new;


@@ -28,6 +36,8 @@ following:
     # finally, retag all "new" messages "inbox" and "unread"
     notmuch tag +inbox +unread -new -- tag:new
 
     # 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.
 
 Since the post-processing is only acting on a few messages, it is
 generally extremely fast.