X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=special-tags.mdwn;h=06f77707d627b75ded65933cd7a7aa4bfe3f8f9c;hb=90037cff8296a89bedcc4c2fb93001d245b7ff92;hp=4f46554099f9eb594a48e425781563a4876e551e;hpb=4c13103179b2bed6a9d02e03e6c48ee8654569c3;p=notmuch-wiki

diff --git a/special-tags.mdwn b/special-tags.mdwn
index 4f46554..06f7770 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
 
@@ -22,8 +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 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.
@@ -69,15 +71,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 +89,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.