mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-12-03 08:30:09 +00:00
Code Issues Releases Activity

Improve documentation of 'completion-auto-select'

Browse Source 
* lisp/simple.el (completion-auto-select):
* doc/emacs/mini.texi (Completion Options): Improve documentation
and description of customization options of 'completion-auto-select'.
This commit is contained in:
Eli Zaretskii 2022-03-25 15:39:44 +03:00
parent 3fac06dfb8
commit ab414c5661
2 changed files with 19 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
doc/emacs/mini.texi
View File

@ -643,11 +643,14 @@ completion list buffer, and like @code{always} when it decides whether
to pop it down.
@vindex completion-auto-select
The completions window can be automatically selected. To enable
this behavior, customize the user option @code{completion-auto-select}
to @code{t} and pressing @key{TAB} will switch to the completion list
buffer when it pops up that buffer. If the value is
@code{second-tab}, then the first @key{TAB} will pop up the
Emacs can optionally select the window showing the completions when
it shows that window. To enable this behavior, customize the user
option @code{completion-auto-select} to @code{t}, which changes the
behavior of @key{TAB} when Emacs pops up the completions: pressing
@kbd{@key{TAB}} will switch to the completion list buffer, and you can
then move to a candidate by cursor motion commands and select it with
@kbd{@key{RET}}. If the value of @code{completion-auto-select} is
@code{second-tab}, then the first @kbd{@key{TAB}} will pop up the
completions list buffer, and the second one will switch to it.
@vindex completion-cycle-threshold

18
lisp/simple.el
View File

@ -9146,13 +9146,17 @@ This affects the commands `next-completion' and
(defcustom completion-auto-select nil
"Non-nil means to automatically select the *Completions* buffer.
When the value is t, then pressing TAB will switch to the completion list
buffer when it pops up that buffer. If the value is `second-tab', then the
first TAB will pop up the completions list buffer, and the second one will
switch to it."
:type '(choice (const :tag "Disabled" nil)
(const :tag "Select window on first tab" t)
(const :tag "Select window on second-tab" second-tab))
When the value is t, pressing TAB will switch to the completion list
buffer when Emacs pops up a window showing that buffer.
If the value is `second-tab', then the first TAB will pop up the
window shwoing the completions list buffer, and the next TAB will
switch to that window.
See `completion-auto-help' for controlling when the window showing
the completions is popped up and down."
:type '(choice (const :tag "Don't auto-select completions window" nil)
(const :tag "Select completions window on first TAB" t)
(const :tag
"Select completions window on second TAB" second-tab))
:version "29.1"
:group 'completion)