summaryrefslogtreecommitdiff
path: root/mu4e
diff options
context:
space:
mode:
authorDirk-Jan C. Binnema <djcb@djcbsoftware.nl>2025-09-15 18:26:18 +0300
committerDirk-Jan C. Binnema <djcb@djcbsoftware.nl>2025-09-15 18:26:18 +0300
commit3ce6fd50f45d67cf339b793f8af4d5bec2b92e58 (patch)
treec92c01194c21c26455fd004d80e8274ef7662e32 /mu4e
parent1a501281443eca6ccf7a7267a1c9c720bc6ccca1 (diff)
mu4e.texi: be explicit about :labels
As noted in #2870, this isn't explicitly mentioned in discussion about labels, so unless you read the mu4e-headers-fields / mu4e-view-fields docstrings, you may guess wrong.
Diffstat (limited to 'mu4e')
-rw-r--r--mu4e/mu4e.texi22
1 files changed, 20 insertions, 2 deletions
diff --git a/mu4e/mu4e.texi b/mu4e/mu4e.texi
index b65e180..8ba0258 100644
--- a/mu4e/mu4e.texi
+++ b/mu4e/mu4e.texi
@@ -2528,8 +2528,26 @@ later what this something should be; see below
The @t{label} mark lets you apply @emph{labels} to messages, which are short
strings to attach to this message which you can query using the @t{label:}
-field. To see them in your headers / message views, you need to add the field to
-the @code{mu4e-headers-fields} and @code{mu4e-view-fields}, respectively.
+field.
+
+To see them in your headers / message views, you need to add @code{:labels} to
+the @code{mu4e-headers-fields} and/or @code{mu4e-view-fields}, respectively.
+
+For instance:
+@lisp
+(setq mu4e-headers-fields
+ '((:human-date . 10)
+ (:flags . 4)
+ (:from-or-to . 20)
+ (:mailing-list . 8)
+ (:maildir . 8)
+ (:labels . 8)
+ (:thread-subject . nil)))
+(setq mu4e-view-fields
+ '(:from :date :to :cc :bcc :subject
+ :flags :maildir
+ :message-id :labels))
+@end lisp
To change the labels for some message, you specify a @emph{label expression},
which consists of a space-separated sequence of labels, each prefixed with