doc/misc/auth.texi (Multiple GMail accounts with Gnus): Add FAQ

2 files changed, 26 insertions, 0 deletions

diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index 82a74cb2847..1264400041c 100644
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -1,3 +1,7 @@
+2015-02-05  Teodor Zlatanov  <tzz@lifelogs.com>
+
+        * auth.texi (Multiple GMail accounts with Gnus): Add FAQ.
+
 2015-02-05  Lars Ingebrigtsen  <larsi@gnus.org>
 
         * gnus.texi (Using IMAP): Fix menu node name.
diff --git a/doc/misc/auth.texi b/doc/misc/auth.texi
index 44fcad8d493..d9145bcc2c4 100644
--- a/doc/misc/auth.texi
+++ b/doc/misc/auth.texi
@@ -59,6 +59,7 @@ It is a way for multiple applications to share a single configuration
 @menu
 * Overview::                    Overview of the auth-source library.
 * Help for users::
+* Multiple GMail accounts with Gnus::
 * Secret Service API::
 * Help for developers::
 * GnuPG and EasyPG Assistant Configuration::
@@ -229,6 +230,27 @@ don't use a port entry, you match any Tramp method, as explained
 earlier.  Since Tramp has about 88 connection methods, this may be
 necessary if you have an unusual (see earlier comment on those) setup.
 
+@node Multiple GMail accounts with Gnus
+@chapter Multiple GMail accounts with Gnus
+
+For multiple GMail accounts with Gnus, you have to make two nnimap
+entries in your @code{gnus-secondary-select-methods} with distinct
+names:
+
+@example
+(setq gnus-secondary-select-methods '((nnimap "gmail"
+                                         (nnimap-address "imap.gmail.com"))
+                                      (nnimap "gmail2"
+                                         (nnimap-address "imap.gmail.com"))))
+@end example
+
+Your netrc entries will then be:
+
+@example
+machine gmail login account@gmail.com password "accountpassword" port imap
+machine gmail2 login account2@gmail.com password "account2password" port imap
+@end example
+
 @node Secret Service API
 @chapter Secret Service API