Mercurial > template

changeset 15:90a1769a651a

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Add GMail note in CONTRIBUTING.md
author David Demelier <markand@malikania.fr>
date Fri, 22 Sep 2017 09:27:33 +0200
parents 55bb3689093f
children 780c138ab41d
files CONTRIBUTE.md
diffstat 1 files changed, 25 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/CONTRIBUTE.md	Fri Sep 08 11:26:27 2017 +0200
+++ b/CONTRIBUTE.md	Fri Sep 22 09:27:33 2017 +0200
@@ -42,8 +42,13 @@
 
     [smtp]
     host = yourdomain.tld
-    port = 25
+    port = 587
     tls = starttls
+    username = your_account
+    password = your_password
+
+Note: the password is optional, if not set it will be asked each time you run
+the `hg email command`.
 
 More options are available, see:
 
@@ -52,6 +57,25 @@
   - `hg help patchbomb`
   - `hg help email`
 
+### Note to GMail users
+
+By default, your GMail account may use 2-step authentication which causes
+troubles with the `hg email` command, you must create a specific application
+password.
+
+  1. Go to https://security.google.com/settings/security/apppasswords
+  2. Create an application password, it will be auto generated,
+  3. Use this password or store it directly in the `smtp.password` option.
+
+Use the following settings:
+
+    [smtp]
+    host = gmail.com
+    port = 587
+    tls = starttls
+    username = your_account@gmail.com
+    password = the_generated_application_password
+
 Create your patch
 -----------------