comparison lispref/minibuf.texi @ 52485:7fc901c75a7d

(Intro to Minibuffers): Explain that the minibuffer changes variables that record input events. (Minibuffer Misc): Add minibuffer-selected-window.
author Richard M. Stallman <rms@gnu.org>
date Fri, 12 Sep 2003 01:06:43 +0000
parents 695cf19ef79e
children fe75563f4d13
comparison
equal deleted inserted replaced
52484:c2a16cb1821e 52485:7fc901c75a7d
61 resize it permanently by using the window sizing commands in the frame's 61 resize it permanently by using the window sizing commands in the frame's
62 other window, when the minibuffer is not active. If the frame contains 62 other window, when the minibuffer is not active. If the frame contains
63 just a minibuffer, you can change the minibuffer's size by changing the 63 just a minibuffer, you can change the minibuffer's size by changing the
64 frame's size. 64 frame's size.
65 65
66 Use of the minibuffer reads input events, and that alters the values
67 of variables such as @code{this-command} and @code{last-command}
68 (@pxref{Command Loop Info}). Your program should bind them around the
69 code that uses the minibuffer, if you do not want that to change them.
70
66 If a command uses a minibuffer while there is an active minibuffer, 71 If a command uses a minibuffer while there is an active minibuffer,
67 this is called a @dfn{recursive minibuffer}. The first minibuffer is 72 this is called a @dfn{recursive minibuffer}. The first minibuffer is
68 named @w{@samp{ *Minibuf-0*}}. Recursive minibuffers are named by 73 named @w{@samp{ *Minibuf-0*}}. Recursive minibuffers are named by
69 incrementing the number at the end of the name. (The names begin with a 74 incrementing the number at the end of the name. (The names begin with a
70 space so that they won't show up in normal buffer lists.) Of several 75 space so that they won't show up in normal buffer lists.) Of several
1658 If the value of this variable is non-@code{nil}, it should be a window 1663 If the value of this variable is non-@code{nil}, it should be a window
1659 object. When the function @code{scroll-other-window} is called in the 1664 object. When the function @code{scroll-other-window} is called in the
1660 minibuffer, it scrolls this window. 1665 minibuffer, it scrolls this window.
1661 @end defvar 1666 @end defvar
1662 1667
1668 @defun minibuffer-selected-window
1669 This function returns the window which was selected when the
1670 minibuffer was entered. If selected window is not a minibuffer
1671 window, it returns @code{nil}.
1672 @end defun
1673
1663 Finally, some functions and variables deal with recursive minibuffers 1674 Finally, some functions and variables deal with recursive minibuffers
1664 (@pxref{Recursive Editing}): 1675 (@pxref{Recursive Editing}):
1665 1676
1666 @defun minibuffer-depth 1677 @defun minibuffer-depth
1667 This function returns the current depth of activations of the 1678 This function returns the current depth of activations of the