-/*
- * Implementation of OAuth 2.0 [1] for XOAUTH2 in SMTP [2] and POP3 [3].
+/* oauth.h -- OAuth 2.0 implementation for XOAUTH2 in SMTP and POP3.
*
* Google defined XOAUTH2 for SMTP, and that's what we use here. If other
* providers implement XOAUTH2 or some similar OAuth-based SMTP authentication
* protocol, it should be simple to extend this.
*
- * [1] https://tools.ietf.org/html/rfc6749
- * [2] https://developers.google.com/gmail/xoauth2_protocol
- * [3] http://googleappsdeveloper.blogspot.com/2014/10/updates-on-authentication-for-gmail.html
+ * OAuth https://tools.ietf.org/html/rfc6749
+ * SMTP https://developers.google.com/gmail/xoauth2_protocol
+ * POP3 http://googleappsdeveloper.blogspot.com/2014/10/updates-on-authentication-for-gmail.html
*
* Presumably [2] should document POP3 and that is an over-sight. As it stands,
* that blog post is the closest we have to documentation.
* 1. User runs mhlogin which prints a URL the user must visit, and prompts for
* a code retrieved from that page.
*
- * 2. User vists this URL in browser, signs in with some Google account, and
+ * 2. User visits this URL in browser, signs in with some Google account, and
* copies and pastes the resulting code back to mhlogin.
*
* 3. mhlogin does HTTP POST to Google to exchange the user-provided code for a
/*
* Load OAuth tokens from file.
*
- * Calls m_getfld(), which writes to stderr with advise().
+ * Calls m_getfld2(), which writes to stderr with advise().
*
* On error, return NULL.
*/