mu4e-bookmarks: improve documentation

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.

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)