summaryrefslogtreecommitdiff
path: root/devdocs/elisp/recursive-mini.html
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2024-04-07 13:41:34 -0500
committerCraig Jennings <c@cjennings.net>2024-04-07 13:41:34 -0500
commit754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 (patch)
treef1190704f78f04a2b0b4c977d20fe96a828377f1 /devdocs/elisp/recursive-mini.html
new repository
Diffstat (limited to 'devdocs/elisp/recursive-mini.html')
-rw-r--r--devdocs/elisp/recursive-mini.html12
1 files changed, 12 insertions, 0 deletions
diff --git a/devdocs/elisp/recursive-mini.html b/devdocs/elisp/recursive-mini.html
new file mode 100644
index 00000000..bc3206f3
--- /dev/null
+++ b/devdocs/elisp/recursive-mini.html
@@ -0,0 +1,12 @@
+ <h3 class="section">Recursive Minibuffers</h3> <p>These functions and variables deal with recursive minibuffers (see <a href="recursive-editing">Recursive Editing</a>): </p> <dl> <dt id="minibuffer-depth">Function: <strong>minibuffer-depth</strong>
+</dt> <dd><p>This function returns the current depth of activations of the minibuffer, a nonnegative integer. If no minibuffers are active, it returns zero. </p></dd>
+</dl> <dl> <dt id="enable-recursive-minibuffers">User Option: <strong>enable-recursive-minibuffers</strong>
+</dt> <dd>
+<p>If this variable is non-<code>nil</code>, you can invoke commands (such as <code>find-file</code>) that use minibuffers even while the minibuffer is active. Such invocation produces a recursive editing level for a new minibuffer. By default, the outer-level minibuffer is invisible while you are editing the inner one. If you have <code>minibuffer-follows-selected-frame</code> set to <code>nil</code>, you can have minibuffers visible on several frames at the same time. See <a href="https://www.gnu.org/software/emacs/manual/html_node/emacs/Basic-Minibuffer.html#Basic-Minibuffer">(emacs)Basic Minibuffer</a>. </p> <p>If this variable is <code>nil</code>, you cannot invoke minibuffer commands when the minibuffer is active, not even if you switch to another window to do it. </p>
+</dd>
+</dl> <p>If a command name has a property <code>enable-recursive-minibuffers</code> that is non-<code>nil</code>, then the command can use the minibuffer to read arguments even if it is invoked from the minibuffer. A command can also achieve this by binding <code>enable-recursive-minibuffers</code> to <code>t</code> in the interactive declaration (see <a href="using-interactive">Using Interactive</a>). The minibuffer command <code>next-matching-history-element</code> (normally <kbd>M-s</kbd> in the minibuffer) does the latter. </p><div class="_attribution">
+ <p class="_attribution-p">
+ Copyright &copy; 1990-1996, 1998-2022 Free Software Foundation, Inc. <br>Licensed under the GNU GPL license.<br>
+ <a href="https://www.gnu.org/software/emacs/manual/html_node/elisp/Recursive-Mini.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Recursive-Mini.html</a>
+ </p>
+</div>