From: David Levine Date: Mon, 10 Oct 2016 20:42:57 +0000 (-0400) Subject: Tweaked OAuth documentation in mhlogin and send man pages. X-Git-Url: https://diplodocus.org/git/nmh/commitdiff_plain/ba6b1c064f1c28a4e928a439fff3512d4277c7d8?ds=sidebyside;hp=bc49ece4e36e2e50c330df468b325aa3741dc682 Tweaked OAuth documentation in mhlogin and send man pages. --- diff --git a/man/mhlogin.man b/man/mhlogin.man index eb067ea5..9a6c7a45 100644 --- a/man/mhlogin.man +++ b/man/mhlogin.man @@ -1,7 +1,7 @@ .\" .\" %nmhwarning% .\" -.TH MHLOGIN %manext1% "September 11, 2016" "%nmhversion%" +.TH MHLOGIN %manext1% "October 10, 2016" "%nmhversion%" .SH NAME mhlogin \- login to external (OAuth) services .SH SYNOPSIS @@ -36,6 +36,7 @@ prompt. Be sure to use the same account with the .B -user switch to .BR send . +See the EXAMPLES section below for an example. .PP The .B \-browser @@ -78,6 +79,9 @@ mhlogin -user user@example.com -saslmech xoauth2 -authservice gmail \ .fi .RE .PP +The +.I username +should be a complete email address. Respond to the prompt in the browser window, then copy and paste the authorization code in response to the .B mhlogin diff --git a/man/send.man b/man/send.man index f1da498e..2bce76a2 100644 --- a/man/send.man +++ b/man/send.man @@ -1,7 +1,7 @@ .\" .\" %nmhwarning% .\" -.TH SEND %manext1% "October 9, 2016" "%nmhversion%" +.TH SEND %manext1% "October 10, 2016" "%nmhversion%" .SH NAME send \- send a message .SH SYNOPSIS @@ -435,12 +435,13 @@ and switches will enable OAuth authentication. The .B \-user switch must be used, and the -.I user-name +.I username must be an email address the user has for the service, which must be specified with the .B \-authservice .I service -switch. Before using this, the user must authorize nmh by running +switch. Before using OAuth authentication, the user must authorize nmh by +running .B mhlogin and grant authorization to that account. See the .IR mhlogin (1)