git: 02140316e8 - main - Handbook - mail: Add note about gmail needing app passwords

From: Sergio Carlavilla Delgado <carlavilla_at_FreeBSD.org>
Date: Thu, 16 Jan 2025 18:51:51 UTC
The branch main has been updated by carlavilla:

URL: https://cgit.FreeBSD.org/doc/commit/?id=02140316e883a481f5a563419a39c82e2af08822

commit 02140316e883a481f5a563419a39c82e2af08822
Author:     Dave Cottlehuber <dch@FreeBSD.org>
AuthorDate: 2025-01-16 18:49:27 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2025-01-16 18:49:27 +0000

    Handbook - mail: Add note about gmail needing app passwords
    
    Reviewed by:    carlavilla@, Graham Perrin
    Pull Request:   https://github.com/freebsd/freebsd-doc/pull/457
---
 documentation/content/en/books/handbook/mail/_index.adoc | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/documentation/content/en/books/handbook/mail/_index.adoc b/documentation/content/en/books/handbook/mail/_index.adoc
index 48f58ef4c1..fa8df9ac8d 100644
--- a/documentation/content/en/books/handbook/mail/_index.adoc
+++ b/documentation/content/en/books/handbook/mail/_index.adoc
@@ -138,6 +138,14 @@ Authentication can be set with one line in [.filename]#/etc/dma/auth.conf#:
 username@gmail.com|smtp.gmail.com:password
 ....
 
+[NOTE]
+====
+If you have 2-factor authentication enabled, you will need to generate an
+application-specific password as your normal login password will be
+rejected. See Google documentation for more information on
+https://myaccount.google.com/apppasswords[app-specific passwords].
+====
+
 Execute the following command to test the configuration:
 
 [source,shell]