summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authormartin rudalics <rudalics@gmx.at>2021-08-04 08:48:18 +0200
committerLars Ingebrigtsen <larsi@gnus.org>2021-08-04 08:48:18 +0200
commit51583a0f9f75950933a342a09ea3d317a528581e (patch)
treefb25d433334158f884c7ec545829f85763a06286 /doc
parentbee3e51550174047c73a1e942c16c8d45e2db1b8 (diff)
downloademacs-51583a0f9f75950933a342a09ea3d317a528581e.tar.gz
Add new user option 'read-minibuffer-restore-windows'
* doc/lispref/minibuf.texi (Text from Minibuffer): Document it (bug#45072). * lisp/cus-start.el (standard): Add. * src/minibuf.c (syms_of_minibuf): New variable 'read-minibuffer-restore-windows'.
Diffstat (limited to 'doc')
-rw-r--r--doc/lispref/minibuf.texi12
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/lispref/minibuf.texi b/doc/lispref/minibuf.texi
index 196dd990767..d54c654562f 100644
--- a/doc/lispref/minibuf.texi
+++ b/doc/lispref/minibuf.texi
@@ -469,6 +469,18 @@ If @var{default} is a non-@code{nil} list, the first element of the
list is used in the prompt.
@end defun
+@defvar read-minibuffer-restore-windows
+If this option is non-@code{nil} (the default), getting input from the
+minibuffer will restore, on exit, the window configurations of the frame
+where the minibuffer was entered from and, if it is different, the frame
+that owns the minibuffer window. This means that if, for example, a
+user splits a window while getting input from the minibuffer on the same
+frame, that split will be undone when exiting the minibuffer.
+
+If this option is @code{nil}, no such restorations are done. Hence, the
+window split mentioned above will persist after exiting the minibuffer.
+@end defvar
+
@node Object from Minibuffer
@section Reading Lisp Objects with the Minibuffer
@cindex minibuffer input, reading lisp objects