master afc945d 2/3: Improve minibuffer-inactive-mode documentation

[Lars Ingebrigtsen]

branch: master
commit afc945d0c96c37796df840a5529e54886e56c0b9
Author: Lars Ingebrigtsen <larsi@gnus.org>
Commit: Lars Ingebrigtsen <larsi@gnus.org>

    Improve minibuffer-inactive-mode documentation
    
    * lisp/minibuffer.el (minibuffer-inactive-mode): Clarify when it's
    used (bug#13641).
---
 lisp/minibuffer.el | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/lisp/minibuffer.el b/lisp/minibuffer.el
index 9f327df..f193c420 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)