showbuildenv: Add comment describing exit-status convention.

[nmh] / man / mhlogin.man

diff --git a/man/mhlogin.man b/man/mhlogin.man
index eb067ea5ff69f5d98b3b3115b2a49b2cb6efc7c2..e9a81aec0038ee4bbcce7427a8f4ca872e03e30b 100644 (file)
--- a/man/mhlogin.man
+++ b/man/mhlogin.man
@@ -1,13 +1,15 @@
 .\"
 .\" %nmhwarning%
 .\"
 .\"
 .\" %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
 .HP 5
 .na
 .B mhlogin
 .SH NAME
 mhlogin \- login to external (OAuth) services
 .SH SYNOPSIS
 .HP 5
 .na
 .B mhlogin

+.RB [ \-help ]
+.RB [ \-version ]

 .RB [ \-user
 .IR username ]
 .RB [ \-saslmech
 .RB [ \-user
 .IR username ]
 .RB [ \-saslmech


@@ -17,11 +19,9 @@ mhlogin \- login to external (OAuth) services
 .RB [ \-browser
 .IR command ]
 .RB [ \-snoop ]
 .RB [ \-browser
 .IR command ]
 .RB [ \-snoop ]

-.RB [ \-version ]
-.RB [ \-help ]

 .ad
 .SH DESCRIPTION
 .ad
 .SH DESCRIPTION

-.B Mhlogin
+.B mhlogin

 currently only supports OAuth for Gmail.  Run
 .B mhlogin
 .B \-user
 currently only supports OAuth for Gmail.  Run
 .B mhlogin
 .B \-user


@@ -36,6 +36,7 @@ prompt.  Be sure to use the same account with the
 .B -user
 switch to
 .BR send .
 .B -user
 switch to
 .BR send .

+See the EXAMPLES section below for an example.

 .PP
 The
 .B \-browser
 .PP
 The
 .B \-browser


@@ -78,6 +79,9 @@ mhlogin -user user@example.com -saslmech xoauth2 -authservice gmail \
 .fi
 .RE
 .PP
 .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
 Respond to the prompt in the browser window, then copy and paste the
 authorization code in response to the
 .B mhlogin