GNU bug report logs -
#40561
27.0.90; Mail-related errors in docstrings and manuals
Previous Next
Full log
Message #28 received at 40561 <at> debbugs.gnu.org (full text, mbox):
On Sun, 12 Apr 2020 21:34:13 +0300
Eli Zaretskii wrote:
>> > That section is not about message-mode, it's about sending email.
>> > message-mode is just the default mode we use for editing and sending.
>>
>> I still find the manual a bit misleading. The first sentence of the
>> last paragraph of the parent section says:
>>
>> In this section, we will describe some of the most commonly-used
>> commands available in Message mode.
>>
>> Then the [[info:emacs#Mail Sending]] section says
>>
>> The variable ‘message-send-mail-function’ controls how the message is
>> delivered (‘send-mail-function’ is used for Mail mode).
>>
>> That made me think that people who use Message Mode should set
>> ‘message-send-mail-function’ instead of ‘send-mail-function’.
>>
>> It is possible that this misunderstanding was caused by bad reading
>> comprehension on my part -- and my native (and everyday) language is
>> Portuguese.
>
> I'd be interested to hear opinions by others about this.
I agree with Jorge that the quoted section is confusing, and the recent
change from bug#39639 (which I've now found when trying to make some
sense of it doing 'git blame' on sending.texi) mostly just added to that
confusion, as it only stuck `message-send-mail-function' in the middle
of the 10-year-old text.
https://debbugs.gnu.org/cgi/bugreport.cgi?bug=39639
It would be great if someone who understands how the current default
setup is supposed to fit together had a look at that part of the manual.
--
Štěpán
This bug report was last modified 5 years and 42 days ago.
Previous Next
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997,2003 nCipher Corporation Ltd,
1994-97 Ian Jackson.