mutt stable branch with some hacks
Add some brief documentation on OAUTH support.
These are just pulled from Brandon's commit message.
+42
-3
+39
doc/manual.xml.head
+39
doc/manual.xml.head
···
8298
8298
8299
8299
</sect1>
8300
8300
8301
+
<sect1 id="oauth">
8302
+
<title>OAUTHBEARER Support</title>
8303
+
8304
+
<para>
8305
+
Preliminary OAUTH support for IMAP, POP, and SMTP is provided via
8306
+
external scripts.
8307
+
</para>
8308
+
8309
+
<para>
8310
+
At least for Gmail, you can use the <literal>oauth2.py</literal>
8311
+
script from Google's gmail-oauth2-tools: <ulink
8312
+
url="https://github.com/google/gmail-oauth2-tools/blob/master/python/oauth2.py"
8313
+
>https://github.com/google/gmail-oauth2-tools/blob/master/python/oauth2.py</ulink>
8314
+
</para>
8315
+
8316
+
<para>
8317
+
You'll need to get your own oauth client credentials for Gmail here:
8318
+
<ulink url="https://console.developers.google.com/apis/credentials"
8319
+
>https://console.developers.google.com/apis/credentials</ulink>
8320
+
</para>
8321
+
8322
+
<para>
8323
+
Then, you'd use <literal>oauth2.py</literal> with
8324
+
<literal>--generate_oauth2_token</literal> to get a refresh token, and
8325
+
configure mutt with:
8326
+
</para>
8327
+
8328
+
<screen>
8329
+
set imap_authenticators="oauthbearer"
8330
+
set imap_oauth_refresh_command="/path/to/oauth2.py --quiet --user=[email_address]\
8331
+
--client_id=[client_id] --client_secret=[client_secret]\
8332
+
--refresh_token=[refresh_token]"
8333
+
</screen>
8334
+
8335
+
<para>
8336
+
Substitute pop or smtp for imap in the above example to configure for those.
8337
+
</para>
8338
+
</sect1>
8339
+
8301
8340
<sect1 id="account-hook">
8302
8341
<title>Managing Multiple Accounts</title>
8303
8342
+3
-3
init.h
+3
-3
init.h
···
1338
1338
** The command to run to generate an OAUTH refresh token for
1339
1339
** authorizing your connection to your IMAP server. This command will be
1340
1340
** run on every connection attempt that uses the OAUTHBEARER authentication
1341
-
** mechanism.
1341
+
** mechanism. See ``$oauth'' for details.
1342
1342
*/
1343
1343
{ "imap_pass", DT_STR, R_NONE, UL &ImapPass, UL 0 },
1344
1344
/*
···
2424
2424
** The command to run to generate an OAUTH refresh token for
2425
2425
** authorizing your connection to your POP server. This command will be
2426
2426
** run on every connection attempt that uses the OAUTHBEARER authentication
2427
-
** mechanism.
2427
+
** mechanism. See ``$oauth'' for details.
2428
2428
*/
2429
2429
{ "pop_pass", DT_STR, R_NONE, UL &PopPass, UL "" },
2430
2430
/*
···
3402
3402
** The command to run to generate an OAUTH refresh token for
3403
3403
** authorizing your connection to your SMTP server. This command will be
3404
3404
** run on every connection attempt that uses the OAUTHBEARER authentication
3405
-
** mechanism.
3405
+
** mechanism. See ``$oauth'' for details.
3406
3406
*/
3407
3407
{ "smtp_pass", DT_STR, R_NONE, UL &SmtpPass, UL 0 },
3408
3408
/*