X-Git-Url: https://git.cworth.org/git?p=notmuch-wiki;a=blobdiff_plain;f=special-tags.mdwn;h=ecf803fb5719ffe42ef929b32d8ab9040d5150d5;hp=33659b884bf78fbe811635adb39fed47982646ac;hb=HEAD;hpb=20eb8048ebeccaf18e425143d8b46b54ac0d4479

diff --git a/special-tags.mdwn b/special-tags.mdwn
index 33659b8..ecf803f 100644
--- a/special-tags.mdwn
+++ b/special-tags.mdwn
@@ -1,7 +1,8 @@
+[[!img notmuch-logo.png alt="Notmuch logo" class="left"]]
 # 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
 
@@ -14,7 +15,7 @@ None of the tags recognized by the lib are configurable.
  - passed
  - replied
  - unread
- - deleted (*)
+
 
 The above tags are recognized by the lib, and synchronized with the
 corresponding maildir flags through the following lib function calls:
@@ -22,11 +23,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 "deleted" tag is not synced to maildir T flag at the moment, but it may
-be in the future.
+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".
 
 ### Automatic tags
 
@@ -50,15 +49,10 @@ All of the tags recognized by the cli are configurable.
 
  - unread
  - inbox
- - new (*)
 
 These are the tags assigned to new message by default. The tags can be changed
 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.
-
 ### Default excluded tags
 
  - deleted
@@ -69,24 +63,24 @@ 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
 
  - replied
  - 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.