diff options
Diffstat (limited to 'doc')
-rw-r--r-- | doc/lispref/ChangeLog | 10 | ||||
-rw-r--r-- | doc/lispref/display.texi | 9 | ||||
-rw-r--r-- | doc/lispref/sequences.texi | 47 | ||||
-rw-r--r-- | doc/misc/ChangeLog | 17 | ||||
-rw-r--r-- | doc/misc/auth.texi | 22 | ||||
-rw-r--r-- | doc/misc/gnus.texi | 24 |
6 files changed, 120 insertions, 9 deletions
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog index aa4d3200830..3fe3d6fd6a0 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog @@ -1,3 +1,13 @@ +2015-02-06 Nicolas Petton <nicolas@petton.fr> + + * sequences.texi (Sequence Functions): Add documentation for + seq-mapcat, seq-partition and seq-group-by. + +2015-02-05 Martin Rudalics <rudalics@gmx.at> + + * display.texi (Size of Displayed Text): Remove description of + optional argument BUFFER of `window-text-pixel-size'. + 2015-02-01 Martin Rudalics <rudalics@gmx.at> * display.texi (Size of Displayed Text): Describe optional diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi index 10b17a3f389..b09b82a6724 100644 --- a/doc/lispref/display.texi +++ b/doc/lispref/display.texi @@ -1880,7 +1880,7 @@ displayed in a given window. This function is used by @code{fit-frame-to-buffer} (@pxref{Size and Position}) to make a window exactly as large as the text it contains. -@defun window-text-pixel-size &optional window from to x-limit y-limit mode-and-header-line buffer +@defun window-text-pixel-size &optional window from to x-limit y-limit mode-and-header-line This function returns the size of the text of @var{window}'s buffer in pixels. @var{window} must be a live window and defaults to the selected one. The return value is a cons of the maximum pixel-width of any text @@ -1919,13 +1919,6 @@ means to not include the height of the mode- or header-line of @code{mode-line} or @code{header-line}, include only the height of that line, if present, in the return value. If it is @code{t}, include the height of both, if present, in the return value. - -The optional argument @var{buffer} allows to specify an alternate buffer -whose text size will be calculated. If @var{buffer} is @code{nil} or -omitted, then operate on the buffer of @var{window}. If it is @code{t}, -then operate on the current buffer as if it were displayed in -@var{window}. If it specifies a live buffer, then operate on that -buffer as if it were displayed in @var{window}. @end defun diff --git a/doc/lispref/sequences.texi b/doc/lispref/sequences.texi index f82c4962759..f268c0d11e2 100644 --- a/doc/lispref/sequences.texi +++ b/doc/lispref/sequences.texi @@ -695,9 +695,54 @@ concatenation of @var{sequences}. @var{type} may be: @code{vector}, @end example @end defun +@defun seq-mapcat function sequence &optional type + This function returns the result of applying @code{seq-concatenate} +to the result of applying @var{function} to each element of +@var{sequence}. The result is a sequence of type @var{type}, or a +list if @var{type} is @code{nil}. + +@example +@group +(seq-mapcat #'seq-reverse '((3 2 1) (6 5 4))) +@result{} (1 2 3 4 5 6) +@end group +@end example +@end defun + +@defun seq-partition sequence n + This function returns a list of the elements of @var{sequence} +grouped into sub-sequences of length @var{n}. The last sequence may +contain less elements than @var{n}. @var{n} must be an integer. If +@var{n} is a negative integer or 0, nil is returned. + +@example +@group +(seq-partition '(0 1 2 3 4 5 6 7) 3) +@result{} ((0 1 2) (3 4 5) (6 7)) +@end group +@end example +@end defun + +@defun seq-group-by function sequence + This function separates the elements of @var{sequence} into an alist +whose keys are the result of applying @var{function} to each element +of @var{sequence}. Keys are compared using @code{equal}. + +@example +@group +(seq-group-by #'integerp '(1 2.1 3 2 3.2)) +@result{} ((t 2 3 1) (nil 3.2 2.1)) +@end group +@group +(seq-group-by #'car '((a 1) (b 2) (a 3) (c 4))) +@result{} ((a (a 3) (a 1)) (b (b 2)) (c (c 4))) +@end group +@end example +@end defun + @defmac seq-doseq (var sequence [result]) body@dots{} @cindex sequence iteration -This macro is like @code{dolist}, except that @var{sequence} can be a list, + This macro is like @code{dolist}, except that @var{sequence} can be a list, vector or string (@pxref{Iteration} for more information about the @code{dolist} macro). This is primarily useful for side-effects. @end defmac diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog index 534dd108a66..bc22b677288 100644 --- a/doc/misc/ChangeLog +++ b/doc/misc/ChangeLog @@ -1,3 +1,20 @@ +2015-02-05 Glenn Morris <rgm@gnu.org> + + * auth.texi (Multiple GMail accounts with Gnus): Markup fix. + +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. + +2015-02-05 Trevor Murphy <trevor.m.murphy@gmail.com> + + * gnus.texi (Support for IMAP Extensions): Document the Gmail label + extension. + 2015-02-04 Paul Eggert <eggert@cs.ucla.edu> * texinfo.tex: Update from gnulib. diff --git a/doc/misc/auth.texi b/doc/misc/auth.texi index 44fcad8d493..7c0254a9a3a 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 diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index cb808743ec2..d714656457f 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 +@node Support for IMAP Extensions +@subsection Support for IMAP Extensions + +@cindex Gmail +@cindex X-GM-LABELS +@cindex 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: + +@example +(setq gnus-extra-headers + '(To Newsgroups X-GM-LABELS)) +@end 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 |