From 75c8262a018b2e1d86cda6bd7ecd0462f656f60c Mon Sep 17 00:00:00 2001 From: "Dirk-Jan C. Binnema" Date: Tue, 5 May 2020 21:45:48 +0300 Subject: [PATCH] mu4e-bookmarks: improve documentation --- NEWS.org | 8 ++++---- mu4e/mu4e-vars.el | 11 ++++++----- 2 files changed, 10 insertions(+), 9 deletions(-) diff --git a/NEWS.org b/NEWS.org index 5afa6b40..2d2eae6f 100644 --- a/NEWS.org +++ b/NEWS.org @@ -100,10 +100,10 @@ replying to all, sender, list-only. - A very visible change, ~mu4e~ now shows unread/all counts for bookmarks in - the main screen. This is on by default, but can be disabled by setting - ~:hide-unread~ in the bookmark ~plist~ to ~t~. For speed-reasons, these counts - do _not_ filter out duplicates or messages that have been removed from the - filesystem behind mu4e's back. + the main screen that are strings. This is on by default, but can be + disabled by setting ~:hide-unread~ in the bookmark ~plist~ to ~t~. For + speed-reasons, these counts do _not_ filter out duplicates nor messages that + have been removed from the filesystem. - ~mu4e-attachment-dir~ now also applies to composing messages; it determines the default directory for inclusion. diff --git a/mu4e/mu4e-vars.el b/mu4e/mu4e-vars.el index 26b92462..06fd4f94 100644 --- a/mu4e/mu4e-vars.el +++ b/mu4e/mu4e-vars.el @@ -250,12 +250,13 @@ Optionally, you can add the following: `:hide-unread' - do not show the counts of unread/total number of matches for the query in the main-view. This can be useful if a bookmark uses a very slow query. :hide-unread -is implied from :hide. Furthermore, it is implied from the query -not being a string. +is implied from :hide. Furthermore, it is implied if +`:query' is a function. -Note that the queries used to determine the unread/all counts do -current not apply `mu4e-query-rewrite-function', so if your -bookmarks depend on that, the results may differ." +Queries used to determine the unread/all counts do _not_ apply +`mu4e-query-rewrite-function'; nor do they discard duplicate or +unreadable messages (for efficiency). Thus, the numbers shown may +differ from the number you get from a 'real' query." :type '(repeat (plist)) :version "1.3.9" :group 'mu4e)