diff options
| author | Joakim Verona | 2015-02-08 21:55:28 +0100 |
|---|---|---|
| committer | Joakim Verona | 2015-02-08 21:55:28 +0100 |
| commit | 5e1d5ef39ca0d2fbff26d659f2ec6ce863b14529 (patch) | |
| tree | 860e0d53399626aee6249ebb5f972879f403b228 /doc | |
| parent | 148262ce3db990ed16989341345e232570b3a338 (diff) | |
| parent | 7d631aa0ffab875e4979727f632703ad5b4100a2 (diff) | |
| download | emacs-xwidget.tar.gz emacs-xwidget.zip | |
merge masterxwidget
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 @@ | |||
| 1 | 2015-02-06 Nicolas Petton <nicolas@petton.fr> | ||
| 2 | |||
| 3 | * sequences.texi (Sequence Functions): Add documentation for | ||
| 4 | seq-mapcat, seq-partition and seq-group-by. | ||
| 5 | |||
| 6 | 2015-02-05 Martin Rudalics <rudalics@gmx.at> | ||
| 7 | |||
| 8 | * display.texi (Size of Displayed Text): Remove description of | ||
| 9 | optional argument BUFFER of `window-text-pixel-size'. | ||
| 10 | |||
| 1 | 2015-02-01 Martin Rudalics <rudalics@gmx.at> | 11 | 2015-02-01 Martin Rudalics <rudalics@gmx.at> |
| 2 | 12 | ||
| 3 | * display.texi (Size of Displayed Text): Describe optional | 13 | * 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 | |||
| 1880 | @code{fit-frame-to-buffer} (@pxref{Size and Position}) to make a window | 1880 | @code{fit-frame-to-buffer} (@pxref{Size and Position}) to make a window |
| 1881 | exactly as large as the text it contains. | 1881 | exactly as large as the text it contains. |
| 1882 | 1882 | ||
| 1883 | @defun window-text-pixel-size &optional window from to x-limit y-limit mode-and-header-line buffer | 1883 | @defun window-text-pixel-size &optional window from to x-limit y-limit mode-and-header-line |
| 1884 | This function returns the size of the text of @var{window}'s buffer in | 1884 | This function returns the size of the text of @var{window}'s buffer in |
| 1885 | pixels. @var{window} must be a live window and defaults to the selected | 1885 | pixels. @var{window} must be a live window and defaults to the selected |
| 1886 | one. The return value is a cons of the maximum pixel-width of any text | 1886 | 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 | |||
| 1919 | @code{mode-line} or @code{header-line}, include only the height of that | 1919 | @code{mode-line} or @code{header-line}, include only the height of that |
| 1920 | line, if present, in the return value. If it is @code{t}, include the | 1920 | line, if present, in the return value. If it is @code{t}, include the |
| 1921 | height of both, if present, in the return value. | 1921 | height of both, if present, in the return value. |
| 1922 | |||
| 1923 | The optional argument @var{buffer} allows to specify an alternate buffer | ||
| 1924 | whose text size will be calculated. If @var{buffer} is @code{nil} or | ||
| 1925 | omitted, then operate on the buffer of @var{window}. If it is @code{t}, | ||
| 1926 | then operate on the current buffer as if it were displayed in | ||
| 1927 | @var{window}. If it specifies a live buffer, then operate on that | ||
| 1928 | buffer as if it were displayed in @var{window}. | ||
| 1929 | @end defun | 1922 | @end defun |
| 1930 | 1923 | ||
| 1931 | 1924 | ||
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}, | |||
| 695 | @end example | 695 | @end example |
| 696 | @end defun | 696 | @end defun |
| 697 | 697 | ||
| 698 | @defun seq-mapcat function sequence &optional type | ||
| 699 | This function returns the result of applying @code{seq-concatenate} | ||
| 700 | to the result of applying @var{function} to each element of | ||
| 701 | @var{sequence}. The result is a sequence of type @var{type}, or a | ||
| 702 | list if @var{type} is @code{nil}. | ||
| 703 | |||
| 704 | @example | ||
| 705 | @group | ||
| 706 | (seq-mapcat #'seq-reverse '((3 2 1) (6 5 4))) | ||
| 707 | @result{} (1 2 3 4 5 6) | ||
| 708 | @end group | ||
| 709 | @end example | ||
| 710 | @end defun | ||
| 711 | |||
| 712 | @defun seq-partition sequence n | ||
| 713 | This function returns a list of the elements of @var{sequence} | ||
| 714 | grouped into sub-sequences of length @var{n}. The last sequence may | ||
| 715 | contain less elements than @var{n}. @var{n} must be an integer. If | ||
| 716 | @var{n} is a negative integer or 0, nil is returned. | ||
| 717 | |||
| 718 | @example | ||
| 719 | @group | ||
| 720 | (seq-partition '(0 1 2 3 4 5 6 7) 3) | ||
| 721 | @result{} ((0 1 2) (3 4 5) (6 7)) | ||
| 722 | @end group | ||
| 723 | @end example | ||
| 724 | @end defun | ||
| 725 | |||
| 726 | @defun seq-group-by function sequence | ||
| 727 | This function separates the elements of @var{sequence} into an alist | ||
| 728 | whose keys are the result of applying @var{function} to each element | ||
| 729 | of @var{sequence}. Keys are compared using @code{equal}. | ||
| 730 | |||
| 731 | @example | ||
| 732 | @group | ||
| 733 | (seq-group-by #'integerp '(1 2.1 3 2 3.2)) | ||
| 734 | @result{} ((t 2 3 1) (nil 3.2 2.1)) | ||
| 735 | @end group | ||
| 736 | @group | ||
| 737 | (seq-group-by #'car '((a 1) (b 2) (a 3) (c 4))) | ||
| 738 | @result{} ((a (a 3) (a 1)) (b (b 2)) (c (c 4))) | ||
| 739 | @end group | ||
| 740 | @end example | ||
| 741 | @end defun | ||
| 742 | |||
| 698 | @defmac seq-doseq (var sequence [result]) body@dots{} | 743 | @defmac seq-doseq (var sequence [result]) body@dots{} |
| 699 | @cindex sequence iteration | 744 | @cindex sequence iteration |
| 700 | This macro is like @code{dolist}, except that @var{sequence} can be a list, | 745 | This macro is like @code{dolist}, except that @var{sequence} can be a list, |
| 701 | vector or string (@pxref{Iteration} for more information about the | 746 | vector or string (@pxref{Iteration} for more information about the |
| 702 | @code{dolist} macro). This is primarily useful for side-effects. | 747 | @code{dolist} macro). This is primarily useful for side-effects. |
| 703 | @end defmac | 748 | @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 @@ | |||
| 1 | 2015-02-05 Glenn Morris <rgm@gnu.org> | ||
| 2 | |||
| 3 | * auth.texi (Multiple GMail accounts with Gnus): Markup fix. | ||
| 4 | |||
| 5 | 2015-02-05 Teodor Zlatanov <tzz@lifelogs.com> | ||
| 6 | |||
| 7 | * auth.texi (Multiple GMail accounts with Gnus): Add FAQ. | ||
| 8 | |||
| 9 | 2015-02-05 Lars Ingebrigtsen <larsi@gnus.org> | ||
| 10 | |||
| 11 | * gnus.texi (Using IMAP): Fix menu node name. | ||
| 12 | |||
| 13 | 2015-02-05 Trevor Murphy <trevor.m.murphy@gmail.com> | ||
| 14 | |||
| 15 | * gnus.texi (Support for IMAP Extensions): Document the Gmail label | ||
| 16 | extension. | ||
| 17 | |||
| 1 | 2015-02-04 Paul Eggert <eggert@cs.ucla.edu> | 18 | 2015-02-04 Paul Eggert <eggert@cs.ucla.edu> |
| 2 | 19 | ||
| 3 | * texinfo.tex: Update from gnulib. | 20 | * 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 | |||
| 59 | @menu | 59 | @menu |
| 60 | * Overview:: Overview of the auth-source library. | 60 | * Overview:: Overview of the auth-source library. |
| 61 | * Help for users:: | 61 | * Help for users:: |
| 62 | * Multiple GMail accounts with Gnus:: | ||
| 62 | * Secret Service API:: | 63 | * Secret Service API:: |
| 63 | * Help for developers:: | 64 | * Help for developers:: |
| 64 | * GnuPG and EasyPG Assistant Configuration:: | 65 | * GnuPG and EasyPG Assistant Configuration:: |
| @@ -229,6 +230,27 @@ don't use a port entry, you match any Tramp method, as explained | |||
| 229 | earlier. Since Tramp has about 88 connection methods, this may be | 230 | earlier. Since Tramp has about 88 connection methods, this may be |
| 230 | necessary if you have an unusual (see earlier comment on those) setup. | 231 | necessary if you have an unusual (see earlier comment on those) setup. |
| 231 | 232 | ||
| 233 | @node Multiple GMail accounts with Gnus | ||
| 234 | @chapter Multiple GMail accounts with Gnus | ||
| 235 | |||
| 236 | For multiple GMail accounts with Gnus, you have to make two nnimap | ||
| 237 | entries in your @code{gnus-secondary-select-methods} with distinct | ||
| 238 | names: | ||
| 239 | |||
| 240 | @example | ||
| 241 | (setq gnus-secondary-select-methods '((nnimap "gmail" | ||
| 242 | (nnimap-address "imap.gmail.com")) | ||
| 243 | (nnimap "gmail2" | ||
| 244 | (nnimap-address "imap.gmail.com")))) | ||
| 245 | @end example | ||
| 246 | |||
| 247 | Your netrc entries will then be: | ||
| 248 | |||
| 249 | @example | ||
| 250 | machine gmail login account@@gmail.com password "accountpassword" port imap | ||
| 251 | machine gmail2 login account2@@gmail.com password "account2password" port imap | ||
| 252 | @end example | ||
| 253 | |||
| 232 | @node Secret Service API | 254 | @node Secret Service API |
| 233 | @chapter Secret Service API | 255 | @chapter Secret Service API |
| 234 | 256 | ||
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. | |||
| 14182 | * Connecting to an IMAP Server:: Getting started with @acronym{IMAP}. | 14182 | * Connecting to an IMAP Server:: Getting started with @acronym{IMAP}. |
| 14183 | * Customizing the IMAP Connection:: Variables for @acronym{IMAP} connection. | 14183 | * Customizing the IMAP Connection:: Variables for @acronym{IMAP} connection. |
| 14184 | * Client-Side IMAP Splitting:: Put mail in the correct mail box. | 14184 | * Client-Side IMAP Splitting:: Put mail in the correct mail box. |
| 14185 | * Support for IMAP Extensions:: Getting extensions and labels from servers. | ||
| 14185 | @end menu | 14186 | @end menu |
| 14186 | 14187 | ||
| 14187 | 14188 | ||
| @@ -14328,6 +14329,29 @@ Here's a complete example @code{nnimap} backend with a client-side | |||
| 14328 | @end example | 14329 | @end example |
| 14329 | 14330 | ||
| 14330 | 14331 | ||
| 14332 | @node Support for IMAP Extensions | ||
| 14333 | @subsection Support for IMAP Extensions | ||
| 14334 | |||
| 14335 | @cindex Gmail | ||
| 14336 | @cindex X-GM-LABELS | ||
| 14337 | @cindex IMAP labels | ||
| 14338 | |||
| 14339 | If you're using Google's Gmail, you may want to see your Gmail labels | ||
| 14340 | when reading your mail. Gnus can give you this information if you ask | ||
| 14341 | for @samp{X-GM-LABELS} in the variable @code{gnus-extra-headers}. For | ||
| 14342 | example: | ||
| 14343 | |||
| 14344 | @example | ||
| 14345 | (setq gnus-extra-headers | ||
| 14346 | '(To Newsgroups X-GM-LABELS)) | ||
| 14347 | @end example | ||
| 14348 | |||
| 14349 | This will result in Gnus storing your labels in message header | ||
| 14350 | structures for later use. The content is always a parenthesized | ||
| 14351 | (possible empty) list. | ||
| 14352 | |||
| 14353 | |||
| 14354 | |||
| 14331 | @node Getting Mail | 14355 | @node Getting Mail |
| 14332 | @section Getting Mail | 14356 | @section Getting Mail |
| 14333 | @cindex reading mail | 14357 | @cindex reading mail |