GNU bug report logs - #39639
26.3; Sending Mail Manual is a mess between Message/Mail mode

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 39639 in the body.
You can then email your comments to 39639 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Allen Li <darkfeline <at> felesatra.moe>
To: bug-gnu-emacs <at> gnu.org
Subject: 26.3; Sending Mail Manual is a mess between Message/Mail mode
Date: Mon, 17 Feb 2020 00:14:02 -0800

[Message part 1 (text/plain, inline)]

This bug applies to 26.3 and master as of right now.

The way sending mail works and is documented is a mess due to the
Message mode and Mail mode split.

I'll try to point out a few of the problems here:

1. The distinction between message and mail mode is not clearly
explained in the manual.

That's partly incorrectly, the manual does cover it AT THE END of the
Sending Mail section, which is not very useful.  The entire preceding
section flips back and forth between talking about message and mail
mode.

2. The way send-mail-function and message-send-mail-function work is
Lovecraftian.

The docstrings for both of them claim to control sending mail.  The
docstrings for both of them point to the other one.

As best as I can tell, send-mail-function is used by mail mode, and
message-send-mail-function is used by message mode.

Message mode is the default now, and the manual mostly documents message
mode, but it also only documents send-mail-function.

The default value of message-send-mail-function is inferred from
send-mail-function when it is first defined.  Unfortunately, it doesn't
work properly when send-mail-function is customized, I think due to the
order in which the respective libraries are loaded (I haven'te debugged
yet).

The default value of message-send-mail-function is set to
sendmail-query-once if send-mail-function is also set to
sendmail-query-once.  Unfortunately, sendmail-query-once only sets
send-mail-function and not message-send-mail-function, so if you use
message mode (the default), then the default is to query every single
time.  So much for "query once".

message-send-mail-function should then be inferred from
send-mail-function on the next startup, but due to the load order issue
mentioned above, this also doesn't work.

I have attached two patches improving the situation ever so slightly,
but more work is needed here.

[0001-Fix-reference-to-message-send-and-exit.patch (text/x-patch, attachment)]

[0002-Document-message-send-mail-function.patch (text/x-patch, attachment)]

[Message part 4 (text/plain, inline)]

In GNU Emacs 26.3 (build 1, x86_64-pc-linux-gnu, GTK+ Version 3.24.10)
 of 2019-08-29 built on juergen
Windowing system distributor 'The X.Org Foundation', version 11.0.12007000
System Description:	Arch Linux

Message #10 received at 39639-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Allen Li <darkfeline <at> felesatra.moe>
Cc: 39639-done <at> debbugs.gnu.org
Subject: Re: bug#39639: 26.3;
 Sending Mail Manual is a mess between Message/Mail mode
Date: Fri, 21 Feb 2020 11:05:49 +0200

> From: Allen Li <darkfeline <at> felesatra.moe>
> Date: Mon, 17 Feb 2020 00:14:02 -0800
> 
> I have attached two patches improving the situation ever so slightly,
> but more work is needed here.

Thanks, I installed this on the release branch.  (Please in the future
make sure to end each sentence in the commit log message with a
period.)

Patches are welcome to clean up this area of the manual and of the
related code.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.