* [PATCH v4 0/1] notmuch-show-header-line: allow format strings and functions
@ 2022-06-01 9:53 jao
2022-06-01 9:53 ` [PATCH v4 1/1] emacs: " jao
0 siblings, 1 reply; 2+ messages in thread
From: jao @ 2022-06-01 9:53 UTC (permalink / raw)
To: notmuch; +Cc: jao
This one overrides id:20220518192956.1440103-1-jao@gnu.org, by
improving the docstring.
jao (1):
emacs: notmuch-show-header-line: allow format strings and functions
emacs/notmuch-show.el | 46 ++++++++++++++++++++++++++++++++++---------
1 file changed, 37 insertions(+), 9 deletions(-)
--
2.36.1
^ permalink raw reply [flat|nested] 2+ messages in thread
* [PATCH v4 1/1] emacs: notmuch-show-header-line: allow format strings and functions
2022-06-01 9:53 [PATCH v4 0/1] notmuch-show-header-line: allow format strings and functions jao
@ 2022-06-01 9:53 ` jao
0 siblings, 0 replies; 2+ messages in thread
From: jao @ 2022-06-01 9:53 UTC (permalink / raw)
To: notmuch; +Cc: jao
If a string value is assigned to notmuch-show-header-line, it's used
as a format string to be passed passed to format-spec with `%s`
substituted by the message's subject. If a function is given, it's
called with the subject as argument, and its return value used as
header line.
As before, t means displaying the subject and nil not using any header
line.
Signed-off-by: jao <jao@gnu.org>
---
emacs/notmuch-show.el | 46 ++++++++++++++++++++++++++++++++++---------
1 file changed, 37 insertions(+), 9 deletions(-)
diff --git a/emacs/notmuch-show.el b/emacs/notmuch-show.el
index 69f6c845..51b916ea 100644
--- a/emacs/notmuch-show.el
+++ b/emacs/notmuch-show.el
@@ -85,8 +85,30 @@ visible for any given message."
:group 'notmuch-show)
(defcustom notmuch-show-header-line t
- "Show a header line with the current message's subject."
- :type 'boolean
+ "Show a header line in notmuch show buffers.
+
+If t (the default), the header line will contain the current
+message's subject.
+
+If a string, this value is interpreted as a format string to be
+passed to `format-spec` with `%s` as the substitution variable
+for the message's subject. E.g., to display the subject trimmed
+to a maximum of 80 columns, you could use \"%>-80s\" as format.
+
+If you assign to this variable a function, it will be called with
+the subject as argument, and the return value will be used as the
+header line format. Since the function is called with the
+message buffer as the current buffer, it is also possible to
+access any other properties of the message, using for instance
+notmuch-show functions such as
+`notmuch-show-get-message-properties'.
+
+Finally, if this variabale is set to nil, no header is
+displayed."
+ :type '(choice (const :tag "No header" ni)
+ (const :tag "Subject" t)
+ (string :tag "Format")
+ (function :tag "Function"))
:group 'notmuch-show)
(defcustom notmuch-show-relative-dates t
@@ -1313,6 +1335,18 @@ fallback if the prior matches no messages."
(push (list thread "and (" context ")") queries))
queries))
+(defun notmuch-show--header-line-format ()
+ "Compute the header line format of a notmuch-show buffer."
+ (when notmuch-show-header-line
+ (let* ((s (notmuch-sanitize
+ (notmuch-show-strip-re (notmuch-show-get-subject))))
+ (subject (replace-regexp-in-string "%" "%%" s)))
+ (cond ((stringp notmuch-show-header-line)
+ (format-spec notmuch-show-header-line `((?s . ,subject))))
+ ((functionp notmuch-show-header-line)
+ (funcall notmuch-show-header-line subject))
+ (notmuch-show-header-line subject)))))
+
(defun notmuch-show--build-buffer (&optional state)
"Display messages matching the current buffer context.
@@ -1343,13 +1377,7 @@ If no messages match the query return NIL."
;; display changes.
(notmuch-show-mapc
(lambda () (notmuch-show-set-prop :orig-tags (notmuch-show-get-tags))))
- ;; Set the header line to the subject of the first message.
- (when notmuch-show-header-line
- (setq header-line-format
- (replace-regexp-in-string "%" "%%"
- (notmuch-sanitize
- (notmuch-show-strip-re
- (notmuch-show-get-subject))))))
+ (setq header-line-format (notmuch-show--header-line-format))
(run-hooks 'notmuch-show-hook)
(if state
(notmuch-show-apply-state state)
--
2.36.1
^ permalink raw reply related [flat|nested] 2+ messages in thread
end of thread, other threads:[~2022-06-01 10:01 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-06-01 9:53 [PATCH v4 0/1] notmuch-show-header-line: allow format strings and functions jao
2022-06-01 9:53 ` [PATCH v4 1/1] emacs: " jao
Code repositories for project(s) associated with this public inbox
https://yhetil.org/notmuch.git/
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).