[Emacs-diffs] master dfa6766 2/5: doc/misc/gnus.texi (Support for IMAP Extensions): Document Gmail labels

[Katsumi Yamaoka]

branch: master
commit dfa676632dec19cef54afc977d063f0323e33f06
Author: Lars Magne Ingebrigtsen <address@hidden>
Commit: Katsumi Yamaoka <address@hidden>

    doc/misc/gnus.texi (Support for IMAP Extensions): Document Gmail labels
---
 doc/misc/ChangeLog |    4 ++++
 doc/misc/gnus.texi |   24 ++++++++++++++++++++++++
 2 files changed, 28 insertions(+), 0 deletions(-)

diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index 534dd10..bff977d 100644
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -1,3 +1,7 @@
+2015-02-05  Lars Ingebrigtsen  <address@hidden>
+
+       * gnus.texi (Using IMAP): Fix menu node name.
+
 2015-02-04  Paul Eggert  <address@hidden>
 
        * texinfo.tex: Update from gnulib.
diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi
index cb80874..d714656 100644
--- a/doc/misc/gnus.texi
+++ b/doc/misc/gnus.texi
@@ -14182,6 +14182,7 @@ from different locations, or with different user agents.
 * Connecting to an IMAP Server::     Getting started with @acronym{IMAP}.
 * Customizing the IMAP Connection::  Variables for @acronym{IMAP} connection.
 * Client-Side IMAP Splitting::       Put mail in the correct mail box.
+* Support for IMAP Extensions::      Getting extensions and labels from 
servers.
 @end menu
 
 
@@ -14328,6 +14329,29 @@ Here's a complete example @code{nnimap} backend with a 
client-side
 @end example
 
 
address@hidden Support for IMAP Extensions
address@hidden Support for IMAP Extensions
+
address@hidden Gmail
address@hidden X-GM-LABELS
address@hidden IMAP labels
+
+If you're using Google's Gmail, you may want to see your Gmail labels
+when reading your mail.  Gnus can give you this information if you ask
+for @samp{X-GM-LABELS} in the variable @code{gnus-extra-headers}. For
+example:
+
address@hidden
+(setq gnus-extra-headers
+      '(To Newsgroups X-GM-LABELS))
address@hidden example
+
+This will result in Gnus storing your labels in message header
+structures for later use.  The content is always a parenthesized
+(possible empty) list.
+
+
+
 @node Getting Mail
 @section Getting Mail
 @cindex reading mail