From 913190f53249fd9a6d7c304e71a02320163c2c39 Mon Sep 17 00:00:00 2001 From: "Dirk-Jan C. Binnema" Date: Mon, 15 Sep 2025 18:26:18 +0300 Subject: [PATCH] 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. --- mu4e/mu4e.texi | 22 ++++++++++++++++++++-- 1 file changed, 20 insertions(+), 2 deletions(-) diff --git a/mu4e/mu4e.texi b/mu4e/mu4e.texi index b65e1802..8ba02589 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