; Document choice of smtp authentication method

* doc/misc/smtpmail.texi (Authentication): Document smtp-auth.
* etc/NEWS: Advertise the feature.
This commit is contained in:
Andrew G Cohen 2020-09-01 19:38:36 +08:00
parent 2ea34662c2
commit bdb6d3a943
2 changed files with 13 additions and 4 deletions

View file

@ -267,10 +267,11 @@ file, @pxref{Top,,auth-source, auth, Emacs auth-source Library}.
The process by which the SMTP library authenticates you to the server
is known as ``Simple Authentication and Security Layer'' (SASL).
There are various SASL mechanisms, and this library supports three of
them: CRAM-MD5, PLAIN, and LOGIN@. It tries each of them, in that order,
until one succeeds. The first uses a form of encryption to obscure
your password, while the other two do not.
them: CRAM-MD5, PLAIN, and LOGIN@, where the first uses a form of
encryption to obscure your password, while the other two do not. It
tries each of them, in that order, until one succeeds. You can assign
a specific authentication mechanism to a server by including a key
smtp-auth with a value of the preferred mechanism.
@node Encryption
@chapter Encryption

View file

@ -379,6 +379,14 @@ In Message mode buffers, the 'C-c C-p' ('message-insert-screenshot')
command has been added. It depends on using an external program to
take the actual screenshot, and defaults to "ImageMagick import".
** Smtpmail
+++
*** Allow direct selection of smtp authentication mechanism.
A server entry retrieved by auth-source can request a desired smtp
authentication mechanism by setting a value for the key 'smtp-auth'.
** Help
+++