bug#39639: closed (26.3; Sending Mail Manual is a mess between Message/Mail mode)

[GNU bug Tracking System]

Your message dated Fri, 21 Feb 2020 11:05:49 +0200
with message-id <address@hidden>
and subject line Re: bug#39639: 26.3; Sending Mail Manual is a mess between 
Message/Mail mode
has caused the debbugs.gnu.org bug report #39639,
regarding 26.3; Sending Mail Manual is a mess between Message/Mail mode
to be marked as done.

(If you believe you have received this mail in error, please contact
address@hidden.)


-- 
39639: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=39639
GNU Bug Tracking System
Contact address@hidden with problems

--- Begin Message --- Subject: 26.3; Sending Mail Manual is a mess between Message/Mail mode Date: Mon, 17 Feb 2020 00:14:02 -0800

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
Description: Text Data

0002-Document-message-send-mail-function.patch
Description: Text Data

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

--- End Message ---

> --- Begin Message ---
>
>
>
> 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 <address@hidden>
> > 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.
>
>
> --- End Message ---