From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Sat, 16 Apr 2022 15:14:08 +0000 (+0200)
Subject: Document minibuffer-completion-auto-choose/M-up/M-down
X-Git-Tag: archive/raspbian/1%29.2+1-2+rpi1^2~5^2~16^2~2370^2~518
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=429f2c4b81d44702e4d4513a7eb2dbada867279a;p=emacs.git

Document minibuffer-completion-auto-choose/M-up/M-down

* doc/emacs/mini.texi (Completion Commands): Document
minibuffer-completion-auto-choose/M-up/M-down.
---

diff --git a/doc/emacs/mini.texi b/doc/emacs/mini.texi
index eeb87972cc3..eebe284b09a 100644
--- a/doc/emacs/mini.texi
+++ b/doc/emacs/mini.texi
@@ -378,6 +378,20 @@ window.  You can display the same list with @kbd{?}
 used with the completion list:
 
 @table @kbd
+@vindex minibuffer-completion-auto-choose
+@item M-<down>
+@itemx @key{M-<up>}
+These keys will navigate through the completions displayed in the
+completions buffer.  When @code{minibuffer-completion-auto-choose} is
+non-@code{nil} (which is the default), using these commands will
+automatically insert the current completion candidate in the
+minibuffer.  If this user option is @code{nil}, the keys will navigate
+the same way as before, but won't automatically insert the candidate
+in the minibuffer.  Instead you have to use the @key{M-RET} command to
+do that.  With a prefix argument, @key{C-u M-RET} inserts the
+currently active candidate to the minibuffer, but doesn't exit the
+minibuffer.
+
 @findex switch-to-completions
 @item M-v
 @itemx @key{PageUp}
diff --git a/etc/NEWS b/etc/NEWS
index e9a420e92db..35bb3987e68 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -632,6 +632,7 @@ value.
 
 ** Minibuffer and Completions
 
++++
 *** New commands for navigating completions from the minibuffer.
 When the minibuffer is the current buffer, typing 'M-<up>' or
 'M-<down>' selects a previous/next completion candidate from the