Subject: bug#55569: closed (Re: bug#55569: Improve documentation of mail-user-agent)

From: [email-masked] (GNU bug Tracking System)
Date: Sun, 22 May 2022 08:19:02 +0000

Your bug report

#55569: Improve documentation of mail-user-agent

which was filed against the emacs package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to [email-masked].

-- 
55569: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=55569
GNU Bug Tracking System
Contact [email-masked] with problems

Subject: Re: bug#55569: Improve documentation of mail-user-agent
From: Eli Zaretskii <[email-masked]>
To: Damien Cassou <[email-masked]>
Cc: [email-masked]
Date: Sun, 22 May 2022 11:18:32 +0300
List-Id: <debbugs-submit.debbugs.gnu.org>

> From: Damien Cassou <[email-masked]>
> Cc: [email-masked]
> Date: Sun, 22 May 2022 09:48:46 +0200
> 
> Eli Zaretskii <[email-masked]> writes:
> > If those additional options are supposed to be documented in the MUA
> > manual, let's suggest that users look in those manuals.  That is IMO
> > better than to send them to some unnamed "authors".
> 
> Here is a new version of the patch that references the "manual" instead
> of the "authors".

Thanks, installed on the release branch (with some minor fixups).

Subject: Improve documentation of mail-user-agent
From: Damien Cassou <[email-masked]>
To: [email-masked]
Date: Sun, 22 May 2022 08:16:25 +0200
List-Id: <debbugs-submit.debbugs.gnu.org>

Tags: patch

* doc/emacs/sending.texi (Mail Methods): Add sentences.
* lisp/simple.el (mail-user-agent): Add sentences to the documentation
string.

-- 
Damien Cassou

"Success is the ability to go from one failure to another without
losing enthusiasm." --Winston Churchill
>From be4bcf3ade2b64b211074ba92688922f4f43978e Mon Sep 17 00:00:00 2001
From: Damien Cassou <[email-masked]>
Date: Sun, 22 May 2022 08:09:38 +0200
Subject: [PATCH] Improve documentation of mail-user-agent.

* doc/emacs/sending.texi (Mail Methods): Add sentences.
* lisp/simple.el (mail-user-agent): Add sentences to the documentation
string.
---
 doc/emacs/sending.texi | 4 +++-
 lisp/simple.el         | 7 ++++---
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/doc/emacs/sending.texi b/doc/emacs/sending.texi
index ea87e0a77b..221d2aa3dd 100644
--- a/doc/emacs/sending.texi
+++ b/doc/emacs/sending.texi
@@ -667,7 +667,9 @@ Mail Methods
 customize the variable @code{mail-user-agent}.  Currently, legitimate
 values include @code{message-user-agent} (Message mode)
 @code{sendmail-user-agent} (Mail mode), @code{gnus-user-agent}, and
-@code{mh-e-user-agent}.
+@code{mh-e-user-agent}.  Additional options may be available; check
+with the author of your mail user agent package for details.  You may
+also define another mail user agent using `define-mail-user-agent'.
 
   If you select a different mail-composition method, the information
 in this chapter about the mail buffer and Message mode does not apply;
diff --git a/lisp/simple.el b/lisp/simple.el
index 6906675f68..f901da9bc6 100644
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -9210,9 +9210,10 @@ mail-user-agent
                            paraphernalia if Gnus is running, particularly
                            the Gcc: header for archiving.
 
-Additional valid symbols may be available; check with the author of
-your package for details.  The function should return non-nil if it
-succeeds.
+Additional valid symbols may be available; check with the author
+of your mail user agent package for details.  You may also define
+your own symbol to be used as value for this variable using
+`define-mail-user-agent'.
 
 See also `read-mail-command' concerning reading mail."
   :type '(radio (function-item :tag "Message package"
-- 
2.36.0