aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorAlan Mackenzie2021-04-20 10:14:40 +0000
committerAlan Mackenzie2021-04-20 10:14:40 +0000
commit55db25b2579e5d84dfcf3a15957fc7a827abf25f (patch)
treefb6e10d4f8cc64ded0af807b8c6384a99b4392fc /doc
parent296ef2e99b7cd83ad236230ddc941c7dbc8766e6 (diff)
downloademacs-55db25b2579e5d84dfcf3a15957fc7a827abf25f.tar.gz
emacs-55db25b2579e5d84dfcf3a15957fc7a827abf25f.zip
Introduce and use minibuffer-mode. This fixes bug #47150
* lisp/minibuffer.el (minibuffer-mode): New derived mode. * src/minibuf.c (syms_of_minibuf): New DEFSYMs Qminibuffer_mode, Qminibuffer_inactive_mode, Qminibuffer_completing_file_name, Qselect_frame_set_input_focus, Qadd_to_history. (read_minibuf, set_minibuffer_mode, read_minibuf_unwind): Use the new DEFSYMs in place of continual interning. (set_minibuffer_mode): Put an active minibuffer into minibuffer-mode rather than fundamental-mode. * doc/emacs/mini.texi (Minibuffer Edit): Mention minibuffer-mode. * doc/lispref/minibuf.texi (Intro to Minibuffers): Add a paragraph about minibuffer-mode. * etc/NEWS (Incompatible Lisp Changes in Emacs 28.1): Add an entry.
Diffstat (limited to 'doc')
-rw-r--r--doc/emacs/mini.texi3
-rw-r--r--doc/lispref/minibuf.texi8
2 files changed, 11 insertions, 0 deletions
diff --git a/doc/emacs/mini.texi b/doc/emacs/mini.texi
index 1eba7074f76..03db6698fe5 100644
--- a/doc/emacs/mini.texi
+++ b/doc/emacs/mini.texi
@@ -247,6 +247,9 @@ You might need also to enable @code{minibuffer-depth-indicate-mode}
247to show the current recursion depth in the minibuffer prompt 247to show the current recursion depth in the minibuffer prompt
248on recursive use of the minibuffer. 248on recursive use of the minibuffer.
249 249
250 When active, the minibuffer is usually in @code{minibuffer-mode}.
251This is an internal Emacs mode without any special features.
252
250@findex minibuffer-inactive-mode 253@findex minibuffer-inactive-mode
251 When not active, the minibuffer is in @code{minibuffer-inactive-mode}, 254 When not active, the minibuffer is in @code{minibuffer-inactive-mode},
252and clicking @kbd{mouse-1} there shows the @file{*Messages*} buffer. 255and clicking @kbd{mouse-1} there shows the @file{*Messages*} buffer.
diff --git a/doc/lispref/minibuf.texi b/doc/lispref/minibuf.texi
index e922f1836b3..b8618199852 100644
--- a/doc/lispref/minibuf.texi
+++ b/doc/lispref/minibuf.texi
@@ -97,6 +97,14 @@ to be done. @xref{Text from Minibuffer}, for the non-completion
97minibuffer local maps. @xref{Completion Commands}, for the minibuffer 97minibuffer local maps. @xref{Completion Commands}, for the minibuffer
98local maps for completion. 98local maps for completion.
99 99
100@cindex active minibuffer
101 An active minibuffer usually has major mode @code{minibuffer-mode}.
102This is an Emacs internal mode without any special features. To
103customize the setup of minibuffers, we suggest you use
104@code{minibuffer-setup-hook} (@pxref{Minibuffer Misc}) rather than
105@code{minibuffer-mode-hook}, since the former is run later, after the
106minibuffer has been fully initialized.
107
100@cindex inactive minibuffer 108@cindex inactive minibuffer
101 When a minibuffer is inactive, its major mode is 109 When a minibuffer is inactive, its major mode is
102@code{minibuffer-inactive-mode}, with keymap 110@code{minibuffer-inactive-mode}, with keymap