News for release 0.38.3

[notmuch-wiki] / special-tags.mdwn

diff --git a/special-tags.mdwn b/special-tags.mdwn
index 33659b884bf78fbe811635adb39fed47982646ac..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
 # 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
 
 
 ## Tags special to lib
 


@@ -14,7 +15,7 @@ None of the tags recognized by the lib are configurable.
  - passed
  - replied
  - unread
  - 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:
 
 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()`
 
  - `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
 
 
 ### Automatic tags
 


@@ -50,15 +49,10 @@ All of the tags recognized by the cli are configurable.
 
  - unread
  - inbox
 
  - unread
  - inbox

- - new (*)

 
 These are the tags assigned to new message by default. The tags can be changed
 using the new.tags configuration option.
 
 
 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
 ### Default excluded tags
 
  - deleted


@@ -69,24 +63,24 @@ tags can be changed using the search.exclude_tags configuration option.
 
 ## Tags special to Emacs UI
 
 
 ## 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
 
 
 ### 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
 
 ### 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.