From 4ea450c29f4312e1e6f0ef7c2c3ed9c3b4e3d7eb Mon Sep 17 00:00:00 2001
From: "Dirk-Jan C. Binnema" <djcb@djcbsoftware.nl>
Date: Fri, 1 Dec 2023 19:11:13 +0200
Subject: [PATCH] mu4e: update documentation

---
 mu4e/mu4e-compose.el | 14 ++++++++++----
 mu4e/mu4e.texi       |  9 +++++----
 2 files changed, 15 insertions(+), 8 deletions(-)

diff --git a/mu4e/mu4e-compose.el b/mu4e/mu4e-compose.el
index d2fe4d03..27e41834 100644
--- a/mu4e/mu4e-compose.el
+++ b/mu4e/mu4e-compose.el
@@ -789,7 +789,8 @@ of message."
 ;;;###autoload
 (defun mu4e-compose-reply (&optional wide)
   "Reply to the message at point.
-If WIDE is non-nil, make it a \"wide\" reply (\"reply-to-all\")."
+If WIDE is non-nil, make it a \"wide\" reply (a.k.a.
+\"reply-to-all\")."
   (interactive)
   (mu4e--compose-setup
    'reply
@@ -801,13 +802,17 @@ If WIDE is non-nil, make it a \"wide\" reply (\"reply-to-all\")."
 
 ;;;###autoload
 (defun mu4e-compose-wide-reply ()
-  "Reply to the message at point to all recipients."
+  "Wide-reply to the message at point.
+A.k.a., \"reply-to-all\"."
   (interactive) (mu4e-compose-reply 'wide))
 
 ;;;###autoload
 (defun mu4e-compose-supersede ()
   "Supersede message at point.
-Message must be from current user, as determined through
+
+That is, send the message again, with all the same recipients;
+this can be useful to follow-up on a sent message. The message
+must be from current user, as determined through
 `mu4e-personal-or-alternative-address-p'."
   (interactive)
   (mu4e--compose-setup
@@ -858,7 +863,8 @@ Message must be from current user, as determined through
 
 ;;;###autoload
 (defun mu4e-compose-resend (address)
-  "Re-send the message at point."
+  "Re-send the message at point.
+The message is resent as-is, without any editing. "
   (interactive
    (list (completing-read
           "Resend message to address: " mu4e--contacts-set)))
diff --git a/mu4e/mu4e.texi b/mu4e/mu4e.texi
index de809de5..040d6847 100644
--- a/mu4e/mu4e.texi
+++ b/mu4e/mu4e.texi
@@ -1683,11 +1683,12 @@ To influence the way a message is forwarded, you can use the variables
 
 @subsection Supersede
 
-Occasionally, it can be useful to ``supersede'' a message you sent; this is
-somewhat like a wide-reply, but with the all the same recipients as the original
-message, as determined by @code{mu4e-personal-or-alternative-address-p}.
+Occasionally, it can be useful to ``supersede'' a message you sent; this drops
+you into a new message that is just like the old message (and a @t{Supersedes:}
+message header). You can then edit this message and send it.
 
-For this, there @t{mu4e-compose-supersede} (no default keybinding).
+This is only possible for messages @emph{you} sent, as determined by
+@code{mu4e-personal-or-alternative-address-p}.
 
 This wraps @code{message-supersede}.