Skip to content

Commit 88b139a

Browse files
AdityaGarg8gitster
authored andcommitted
docs: make the purpose of using app password for Gmail more clear in send-email
The current example for Gmail suggests using app passwords for send-email if user has multi-factor authentication set up for their account. However, it does not clarify that the user cannot use their normal password in case they do not have multi-factor authentication enabled. Most likely the example was written in the days when Google allowed using normal passwords without multi-factor authentication. This commit clarifies that app passwords are required and suggests using OAuth2 if the user does not want to enable multi-factor authentication. Signed-off-by: Junio C Hamano <[email protected]>
1 parent e705615 commit 88b139a

File tree

1 file changed

+3
-0
lines changed

1 file changed

+3
-0
lines changed

Documentation/git-send-email.adoc

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -524,9 +524,12 @@ edit `~/.gitconfig` to specify your account settings:
524524
smtpServerPort = 587
525525
----
526526

527+
Gmail does not allow using your account password for `git send-email`.
527528
If you have multi-factor authentication set up on your Gmail account, you can
528529
generate an app-specific password for use with `git send-email`. Visit
529530
https://security.google.com/settings/security/apppasswords to create it.
531+
If you do not want to enable multi-factor authentication, you can use OAuth2.0
532+
authentication as described below.
530533

531534
You can also use OAuth2.0 authentication with Gmail. `OAUTHBEARER` and
532535
`XOAUTH2` are common methods used for this type of authentication. Gmail

0 commit comments

Comments
 (0)