bug#65507: [PATCH] ; Add index entry for OAUTH2 SMTP auth mechanism

bug#65507: [PATCH] ; Add index entry for OAUTH2 SMTP auth mechanism

[Eshel Yaron via Bug reports for GNU Emacs, the Swiss army knife of text editors]

[-- Attachment #1: Type: text/plain, Size: 554 bytes --]

Tags: patch

This is a small tweak to the SMTP library manual.



In GNU Emacs 30.0.50 (build 1, x86_64-apple-darwin22.5.0, NS
 appkit-2299.60 Version 13.4 (Build 22F66)) of 2023-08-24 built on
 Dazzs-MacBook-Pro.local
Repository revision: ad5e17d0638be46f982d1448e8fef1d28d224735
Repository branch: master
Windowing system distributor 'Apple', version 10.3.2299
System Description:  macOS 13.4

Configured using:
 'configure 'CFLAGS=-g0 -O3' --with-native-compilation --with-json
 --with-imagemagick --with-tree-sitter --enable-link-time-optimization'


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-Add-index-entry-for-OAUTH2-SMTP-auth-mechanism.patch --]
[-- Type: text/patch, Size: 1240 bytes --]

From a2bef0f40a732a42f82641f45e2cb92aaa0952b2 Mon Sep 17 00:00:00 2001
From: Eshel Yaron <me@eshelyaron.com>
Date: Thu, 24 Aug 2023 19:17:51 +0200
Subject: [PATCH] ; Add index entry for OAUTH2 SMTP auth mechanism

* doc/misc/smtpmail.texi (Authentication): Fix authentication
mechanism count and add index entries for OAuth 2.0.
---
 doc/misc/smtpmail.texi | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/doc/misc/smtpmail.texi b/doc/misc/smtpmail.texi
index 99363483827..c8fd15aad69 100644
--- a/doc/misc/smtpmail.texi
+++ b/doc/misc/smtpmail.texi
@@ -264,10 +264,12 @@ Authentication
 @cindex CRAM-MD5
 @cindex PLAIN
 @cindex LOGIN
+@cindex OAuth2
+@cindex OAuth 2.0
 The process by which the @acronym{SMTP} library authenticates you to
 the server is known as ``Simple Authentication and Security Layer''
 (@acronym{SASL}).  There are various @acronym{SASL} mechanisms, and
-this library supports three of them: @code{cram-md5}, @code{plain},
+this library supports four of them: @code{cram-md5}, @code{plain},
 @code{login} and @code{xoauth2}, 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.
-- 
2.41.0

bug#65507: [PATCH] ; Add index entry for OAUTH2 SMTP auth mechanism

[Eshel Yaron via Bug reports for GNU Emacs, the Swiss army knife of text editors]

[-- Attachment #1: Type: text/plain, Size: 144 bytes --]


> Tags: patch
>
> This is a small tweak to the SMTP library manual.

My last patch was incomplete, sorry about that.
Here's an updated patch:


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: v2-0001-Add-index-entry-for-OAuth2-SMTP-auth-mechanism.patch --]
[-- Type: text/x-patch, Size: 1453 bytes --]

From 2801f62c7e0d5d89337b5a52cf8f234ca635c474 Mon Sep 17 00:00:00 2001
From: Eshel Yaron <me@eshelyaron.com>
Date: Thu, 24 Aug 2023 19:17:51 +0200
Subject: [PATCH v2] ; Add index entry for OAuth2 SMTP auth mechanism

* doc/misc/smtpmail.texi (Authentication): Fix authentication
mechanism count and add index entries for OAuth 2.0.
---
 doc/misc/smtpmail.texi | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/doc/misc/smtpmail.texi b/doc/misc/smtpmail.texi
index 99363483827..cc2f4f85fb3 100644
--- a/doc/misc/smtpmail.texi
+++ b/doc/misc/smtpmail.texi
@@ -264,12 +264,14 @@ Authentication
 @cindex CRAM-MD5
 @cindex PLAIN
 @cindex LOGIN
+@cindex OAuth2
+@cindex OAuth 2.0
 The process by which the @acronym{SMTP} library authenticates you to
 the server is known as ``Simple Authentication and Security Layer''
 (@acronym{SASL}).  There are various @acronym{SASL} mechanisms, and
-this library supports three of them: @code{cram-md5}, @code{plain},
+this library supports four of them: @code{cram-md5}, @code{plain},
 @code{login} and @code{xoauth2}, where the first uses a form of
-encryption to obscure your password, while the other two do not.  It
+encryption to obscure your password, while the others do not.  It
 tries each of them, in that order, until one succeeds.
 (@code{xoauth2} requires using the @file{oauth2.el} library.  You can
 override this by assigning a specific authentication mechanism to a
-- 
2.41.0

bug#65507: [PATCH] ; Add index entry for OAUTH2 SMTP auth mechanism

[Eli Zaretskii]

> Date: Thu, 24 Aug 2023 19:37:43 +0200
> From:  Eshel Yaron via "Bug reports for GNU Emacs,
>  the Swiss army knife of text editors" <bug-gnu-emacs@gnu.org>
> 
> > Tags: patch
> >
> > This is a small tweak to the SMTP library manual.
> 
> My last patch was incomplete, sorry about that.
> Here's an updated patch:

Thanks, installed on the emacs-29 branch, and closing the bug.