diff options
author | Martin Rudalics <rudalics@gmx.at> | 2014-03-07 16:11:12 +0100 |
---|---|---|
committer | Martin Rudalics <rudalics@gmx.at> | 2014-03-07 16:11:12 +0100 |
commit | 2c6053e8387ca3d60dcc82e702f5a113ce5fb59f (patch) | |
tree | 611bdf5c7479e306dbbf46ce7740d64bdcf022ff /doc/lispref/buffers.texi | |
parent | 84254bbdf069f0386f188d0e2bc5be795a9272bb (diff) |
Update docs for select-window and buffer-list-update-hook.
* buffer.c (Vbuffer_list_update_hook): Doc-string fix.
* window.c (Fselect_window): Explain NORECORD and
`buffer-list-update-hook' in doc-string.
* buffers.texi (The Buffer List): Rename node to Buffer List.
Describe `buffer-list-update-hook'.
* elisp.texi (Top): "The Buffer List" renamed to "Buffer List".
Add node for Window Dividers.
* hooks.texi (Standard Hooks): Add reference to
`buffer-list-update-hook'.
* windows.texi (Selecting Windows): Update description of
`select-window'.
Diffstat (limited to 'doc/lispref/buffers.texi')
-rw-r--r-- | doc/lispref/buffers.texi | 11 |
1 files changed, 9 insertions, 2 deletions
diff --git a/doc/lispref/buffers.texi b/doc/lispref/buffers.texi index fbb6c4009a..1293a03082 100644 --- a/doc/lispref/buffers.texi +++ b/doc/lispref/buffers.texi @@ -25,7 +25,7 @@ not be displayed in any windows. * Modification Time:: Determining whether the visited file was changed "behind Emacs's back". * Read Only Buffers:: Modifying text is not allowed in a read-only buffer. -* The Buffer List:: How to look at all the existing buffers. +* Buffer List:: How to look at all the existing buffers. * Creating Buffers:: Functions that create buffers. * Killing Buffers:: Buffers exist until explicitly killed. * Indirect Buffers:: An indirect buffer shares text with some other buffer. @@ -759,7 +759,7 @@ buffer is read-only. @xref{Using Interactive}, for another way to signal an error if the current buffer is read-only. @end defun -@node The Buffer List +@node Buffer List @section The Buffer List @cindex buffer list @@ -910,6 +910,13 @@ buffer returned by @code{last-buffer} (see above), in the selected window. @end deffn +@defvar buffer-list-update-hook +This is a normal hook run whenever the buffer list changes. Functions +(implicitly) running this hook are @code{get-buffer-create} +(@pxref{Creating Buffers}), @code{rename-buffer} (@pxref{Buffer Names}), +@code{kill-buffer} (@pxref{Killing Buffers}), @code{bury-buffer} (see +above) and @code{select-window} (@pxref{Selecting Windows}). +@end defvar @node Creating Buffers @section Creating Buffers |