summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichal Nazarewicz <mina86@mina86.com>2018-04-07 10:07:23 (GMT)
committerJunio C Hamano <gitster@pobox.com>2018-04-08 02:42:57 (GMT)
commit4855f06fb32e04c7d106765fd15c1f91c1a5fe17 (patch)
treef6ec2564d6c751215f698f3d0fcd3d475fc9bb28
parent66409881238702fa6351e655f6aec8675c4b346f (diff)
downloadgit-4855f06fb32e04c7d106765fd15c1f91c1a5fe17.zip
git-4855f06fb32e04c7d106765fd15c1f91c1a5fe17.tar.gz
git-4855f06fb32e04c7d106765fd15c1f91c1a5fe17.tar.bz2
send-email: simplify Gmail example in the documentation
There is no need for use to manually call ‘git credential’ especially as the interface isn’t super user-friendly and a bit confusing. ‘git send-email’ will do that for them at the first execution and if the password matches, it will be saved in the store. Simplify the documentaion so it dosn’t include the ‘git credential’ invocation (which was incorrect anyway as it should use ‘approve’ instead of ‘fill’) and instead just mentions that credentials helper must be set up. Signed-off-by: Michał Nazarewicz <mina86@mina86.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
-rw-r--r--Documentation/git-send-email.txt16
1 files changed, 6 insertions, 10 deletions
diff --git a/Documentation/git-send-email.txt b/Documentation/git-send-email.txt
index edbba3a..f087d0b 100644
--- a/Documentation/git-send-email.txt
+++ b/Documentation/git-send-email.txt
@@ -452,16 +452,7 @@ edit ~/.gitconfig to specify your account settings:
If you have multifactor authentication setup on your gmail acocunt, you will
need to generate an app-specific password for use with 'git send-email'. Visit
-https://security.google.com/settings/security/apppasswords to setup an
-app-specific password. Once setup, you can store it with the credentials
-helper:
-
- $ git credential fill
- protocol=smtp
- host=smtp.gmail.com
- username=youname@gmail.com
- password=app-password
-
+https://security.google.com/settings/security/apppasswords to create it.
Once your commits are ready to be sent to the mailing list, run the
following commands:
@@ -470,6 +461,11 @@ following commands:
$ edit outgoing/0000-*
$ git send-email outgoing/*
+The first time you run it, you will be prompted for your credentials. Enter the
+app-specific or your regular password as appropriate. If you have credential
+helper configured (see linkgit:git-credential[1]), the password will be saved in
+the credential store so you won't have to type it the next time.
+
Note: the following perl modules are required
Net::SMTP::SSL, MIME::Base64 and Authen::SASL