News for release 0.38.3

[notmuch-wiki] / special-tags.mdwn

diff --git a/special-tags.mdwn b/special-tags.mdwn
index ade06d3033f4e544389b055680246077d356ccb9..ecf803fb5719ffe42ef929b32d8ab9040d5150d5 100644 (file)
--- 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:
@@ -26,9 +27,6 @@ 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.
-
 ### Automatic tags
 
  - attachment
@@ -51,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. See [[Initial_Tagging]].
-
 ### Default excluded tags
 
  - deleted
@@ -70,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.