changeset 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 c2a16cb1821e
children c784ff21a464
files lispref/minibuf.texi
diffstat 1 files changed, 11 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/lispref/minibuf.texi	Fri Sep 12 01:03:37 2003 +0000
+++ b/lispref/minibuf.texi	Fri Sep 12 01:06:43 2003 +0000
@@ -63,6 +63,11 @@
 just a minibuffer, you can change the minibuffer's size by changing the
 frame's size.
 
+  Use of the minibuffer reads input events, and that alters the values
+of variables such as @code{this-command} and @code{last-command}
+(@pxref{Command Loop Info}).  Your program should bind them around the
+code that uses the minibuffer, if you do not want that to change them.
+
   If a command uses a minibuffer while there is an active minibuffer,
 this is called a @dfn{recursive minibuffer}.  The first minibuffer is
 named @w{@samp{ *Minibuf-0*}}.  Recursive minibuffers are named by
@@ -1660,6 +1665,12 @@
 minibuffer, it scrolls this window.
 @end defvar
 
+@defun minibuffer-selected-window
+This function returns the window which was selected when the
+minibuffer was entered.  If selected window is not a minibuffer
+window, it returns @code{nil}.
+@end defun
+
 Finally, some functions and variables deal with recursive minibuffers
 (@pxref{Recursive Editing}):