From c5c9531c37c4ea56800adc86b93f75260e588757 Mon Sep 17 00:00:00 2001
From: "Dirk-Jan C. Binnema" <djcb@djcbsoftware.nl>
Date: Thu, 6 Apr 2023 23:48:15 +0300
Subject: [PATCH] mu4e: Add display-buffer-list example

To fine-tune the main-buffer display.
---
 mu4e/mu4e.texi | 23 +++++++++++++++++------
 1 file changed, 17 insertions(+), 6 deletions(-)

diff --git a/mu4e/mu4e.texi b/mu4e/mu4e.texi
index aaefe4dd..b1854d8a 100644
--- a/mu4e/mu4e.texi
+++ b/mu4e/mu4e.texi
@@ -1207,10 +1207,20 @@ However, @t{mu4e}'s display rules are provisional; you can override them
 easily by customizing @code{display-buffer-alist}, which governs how Emacs --
 and thus @t{mu4e} -- must display your buffers.
 
-That means you can instruct @t{mu4e} to place message views in separate tabs or
-frames, if you so desire.
+Let's look at some examples.
 
-@subsection Display Customization Example
+@subsection Fine-tuning the main buffer display
+
+By default @t{mu4e}'s main buffer occupies the complete frame, but this can be
+changed to use the current window:
+
+@lisp
+(add-to-list 'display-buffer-alist
+             `(,(regexp-quote mu4e-main-buffer-name)
+               display-buffer-same-window))
+@end lisp
+
+@subsection Fine-tuning headers buffer display
 
 You do not need to configure @code{mu4e-split-view} for this to work. In the
 absence of explicit rules to the contrary, @t{mu4e} will fall back on the value
@@ -1221,9 +1231,10 @@ right. It occupies half of the width of the frame.
 
 @lisp
 (add-to-list 'display-buffer-alist
-  '(("\\*mu4e-headers\\*" display-buffer-in-side-window
-    (side . right)
-    (window-width . 0.5)))
+             `(,(regexp-quote mu4e-headers-buffer-name)
+               display-buffer-in-side-window
+               (side . right)
+               (window-width . 0.5)))
 @end lisp
 
 You can type @key{C-x w s} to toggle the side windows to hide or show them at