Improve these comments a bit.

[nmh] / man / mhlogin.man

diff --git a/man/mhlogin.man b/man/mhlogin.man
index 22475b3bc7eb25aaf1d46f8baa7e1aa3dc6ca737..eb067ea5ff69f5d98b3b3115b2a49b2cb6efc7c2 100644 (file)
--- a/man/mhlogin.man
+++ b/man/mhlogin.man
@@ -1,7 +1,7 @@
 .\"
 .\" %nmhwarning%
 .\"
 .\"
 .\" %nmhwarning%
 .\"

-.TH MHLOGIN %manext1% "April 10, 2016" "%nmhversion%"
+.TH MHLOGIN %manext1% "September 11, 2016" "%nmhversion%"

 .SH NAME
 mhlogin \- login to external (OAuth) services
 .SH SYNOPSIS
 .SH NAME
 mhlogin \- login to external (OAuth) services
 .SH SYNOPSIS


@@ -62,6 +62,26 @@ which specifies where
 should write credentials and where
 .B send
 should read them.
 should write credentials and where
 .B send
 should read them.

+.SH "EXAMPLES"
+.PP
+.SS Gmail
+First, login to the Gmail account that you want to use, e.g, user@example.com,
+using a web browser.
+Then, enter a
+.B mhlogin
+command such as:
+.PP
+.RS
+.nf
+mhlogin -user user@example.com -saslmech xoauth2 -authservice gmail \
+-browser 'google-chrome --new-window'
+.fi
+.RE
+.PP
+Respond to the prompt in the browser window, then copy and paste the
+authorization code in response to the
+.B mhlogin
+prompt.

 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf