X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=special-tags.mdwn;h=5e9cbff8b8ea6afcef8105e700282c2841a07099;hb=ad04c8c6b3d8c29a905d9f5f92256fc2bd64be5e;hp=33659b884bf78fbe811635adb39fed47982646ac;hpb=20eb8048ebeccaf18e425143d8b46b54ac0d4479;p=obsolete%2Fnotmuch-wiki

diff --git a/special-tags.mdwn b/special-tags.mdwn
index 33659b8..5e9cbff 100644
--- a/special-tags.mdwn
+++ b/special-tags.mdwn
@@ -1,7 +1,7 @@
 # Tags special to notmuch
 
 This page describes the tags that the notmuch lib, cli, and emacs ui recognize
-and treat specially.
+and treat specially, and whether these tags can be configured.
 
 ## Tags special to lib
 
@@ -22,8 +22,9 @@ corresponding maildir flags through the following lib function calls:
  - `notmuch_message_maildir_flags_to_tags()`
  - `notmuch_message_tags_to_maildir_flags()`
 
-The cli calls the above functions in "notmuch new" if the
-maildir.synchronize_flags configuration option is enabled.
+The cli calls the above functions if the maildir.synchronize_flags configuration
+option is enabled. Maildir flags are synchronized to tags in "notmuch new", and
+tags are synchronized to maildir flags in "notmuch tag" and "notmuch restore".
 
 (*) The "deleted" tag is not synced to maildir T flag at the moment, but it may
 be in the future.
@@ -57,7 +58,7 @@ using the new.tags configuration option.
 
 (*) The "new" tag is by no means special or default, but it is documented here
 as the typically used intermediate tag to use between "notmuch tag" and a
-post-new tagging script.
+post-new tagging script. See [[Initial_Tagging]].
 
 ### Default excluded tags
 
@@ -69,15 +70,17 @@ tags can be changed using the search.exclude_tags configuration option.
 
 ## Tags special to Emacs UI
 
-Most of the tags recognized by the emacs ui are not (easily) configurable.
+All of the tags recognized by the emacs ui are configurable.
 
 ### Reading mail
 
  - unread
  - inbox
 
-The elementary mail reading commands automatically remove the "unread" tag when
-visiting a message, and remove the "inbox" tag when archiving a message.
+The elementary mail reading commands automatically remove the tag(s) specified
+by `notmuch-show-mark-read-tags` ("unread" by default) when visiting a message,
+and remove the tag(s) specified by `notmuch-archive-tags` ("inbox" by default)
+when archiving a message.
 
 ### Other
 
@@ -85,8 +88,9 @@ visiting a message, and remove the "inbox" tag when archiving a message.
  - flagged
  - deleted (*)
 
-The "replied" tag is added to messages that are replied to, and "flagged"
-messages are highlighted through `notmuch-search-line-faces` by default.
+The tag(s) specified by `notmuch-message-replied-tags` ("replied" by default)
+are added to messages that are replied to, and "flagged" messages are
+highlighted through `notmuch-search-line-faces` by default.
 
 (*) There are patches to tag, untag, and hide "deleted" tagged messages, but
 they have not been merged at the time of writing this.