From: Lars Ingebrigtsen Date: Thu, 12 Aug 2021 15:14:36 +0000 (+0200) Subject: Improve minibuffer-inactive-mode documentation X-Git-Tag: emacs-28.0.90~1536 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=afc945d0c96c37796df840a5529e54886e56c0b9;p=emacs.git Improve minibuffer-inactive-mode documentation * lisp/minibuffer.el (minibuffer-inactive-mode): Clarify when it's used (bug#13641). --- diff --git a/lisp/minibuffer.el b/lisp/minibuffer.el index 9f327df28f5..f193c420376 100644 --- a/lisp/minibuffer.el +++ b/lisp/minibuffer.el @@ -2706,7 +2706,14 @@ not active.") :abbrev-table nil ;abbrev.el is not loaded yet during dump. ;; Note: this major mode is called from minibuf.c. "Major mode to use in the minibuffer when it is not active. -This is only used when the minibuffer area has no active minibuffer.") +This is only used when the minibuffer area has no active minibuffer. + +Note that the minibuffer may change to this mode more often than +you might expect. For instance, typing `M-x' may change the +buffer to this mode, then to a different mode, and then back +again to this mode upon exit. Code running from +`minibuffer-inactive-mode-hook' has to be prepared to run +multiple times per minibuffer invocation.") (defvaralias 'minibuffer-mode-map 'minibuffer-local-map)