Commit 643e06db authored by Eli Zaretskii's avatar Eli Zaretskii
Browse files

; Fix documentation of 'completion-auto-deselect'

* lisp/minibuffer.el (completion-auto-deselect): Doc fix.

* etc/NEWS: Improve wording of corresponding entry.
parent 3cf7d32b
Pipeline #27417 failed with stages
in 68 minutes and 34 seconds
......@@ -639,13 +639,15 @@ then all these keys have their usual meaning in the minibuffer.
This option is supported for in-buffer completion as well.
*** Selected completion candidates are deselected on typing.
When a user types, point in the *Completions* window will be moved off
any completion candidates. 'minibuffer-choose-completion' ('M-RET')
will still choose a previously-selected completion candidate, but the
new command 'minibuffer-choose-completion-or-exit' (bound by
'minibuffer-visible-completions') will exit with the minibuffer
contents instead. The deselection behavior can be controlled with the
new user option 'completion-auto-deselect'.
When you type at the minibuffer prompt, the current completion
candidate will be un-highlighted,and point in the *Completions* window
will be moved off that candidate. 'minibuffer-choose-completion'
('M-RET') will still choose a previously-selected completion
candidate, but the new command 'minibuffer-choose-completion-or-exit'
(bound to 'RET' by 'minibuffer-visible-completions') will exit with
the minibuffer contents instead. This deselection behavior can be
controlled with the new user option 'completion-auto-deselect', which
is t by default.
*** New value 'historical' for user option 'completions-sort'
When 'completions-sort' is set to 'historical', completion candidates
......
......@@ -961,6 +961,8 @@ is at its default value `grow-only'."
(reverse multi-message-list)
multi-message-separator)))
(defvar touch-screen-current-tool)
(defun clear-minibuffer-message ()
"Clear message temporarily shown in the minibuffer.
Intended to be called via `clear-message-function'."
......@@ -2433,12 +2435,15 @@ These include:
(fit-window-to-buffer win completions-max-height)))
(defcustom completion-auto-deselect t
"If non-nil, deselect the selected completion candidate when you type.
A non-nil value means that after typing, point in *Completions*
will be moved off any completion candidates. This means
`minibuffer-choose-completion-or-exit' will exit with the
minibuffer's current contents, instead of a completion candidate."
"If non-nil, deselect current completion candidate when you type in minibuffer.
A non-nil value means that after typing at the minibuffer prompt,
any completion candidate highlighted in *Completions* window (to
indicate that it is the selected candidate) will be un-highlighted,
and point in the *Completions* window will be moved off such a candidate.
This means that `RET' (`minibuffer-choose-completion-or-exit') will exit
the minubuffer with the minibuffer's current contents, instead of the
selected completion candidate."
:type '(choice (const :tag "Candidates in *Completions* stay selected as you type" nil)
(const :tag "Typing deselects any completion candidate in *Completions*" t))
:version "30.1")
......@@ -3101,7 +3106,6 @@ displaying the *Completions* buffer exists."
"<down>" (minibuffer-visible-completions-bind #'minibuffer-next-line-completion)
"RET" (minibuffer-visible-completions-bind #'minibuffer-choose-completion-or-exit)
"C-g" (minibuffer-visible-completions-bind #'minibuffer-hide-completions))
;;; Completion tables.
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment