diff options
| author | Eli Zaretskii <eliz@gnu.org> | 2022-03-22 19:56:06 +0200 |
|---|---|---|
| committer | Eli Zaretskii <eliz@gnu.org> | 2022-03-22 19:56:06 +0200 |
| commit | f2047fdca4f42cf0af568e1d62f286a91cce6d35 (patch) | |
| tree | 63747a05afbcd34a913badef451ad2b25ec1d961 /lisp/minibuffer.el | |
| parent | da3af500ad490db5cded8dfca7f2ec713b52629c (diff) | |
| download | emacs-f2047fdca4f42cf0af568e1d62f286a91cce6d35.tar.gz | |
Fix documentation of the new completion-related features
* etc/NEWS:
* lisp/minibuffer.el (completion-auto-help):
* doc/lispref/text.texi (Special Properties):
* doc/emacs/mini.texi (Completion Options): Fix wording of
recently added documentation and customization options.
Diffstat (limited to 'lisp/minibuffer.el')
| -rw-r--r-- | lisp/minibuffer.el | 25 |
1 files changed, 14 insertions, 11 deletions
diff --git a/lisp/minibuffer.el b/lisp/minibuffer.el index 00d4560865c..c4fb1c00391 100644 --- a/lisp/minibuffer.el +++ b/lisp/minibuffer.el @@ -894,20 +894,23 @@ If the current buffer is not a minibuffer, erase its entire contents." (defcustom completion-auto-help t "Non-nil means automatically provide help for invalid completion input. -If the value is t the *Completions* buffer is displayed whenever completion +If the value is t, the *Completions* buffer is displayed whenever completion is requested but cannot be done. If the value is `lazy', the *Completions* buffer is only displayed after the second failed attempt to complete. -If the value is 'always', the completion commands are always shown -after a completion attempt, or updated if they are already visible. -If the value is 'visible', then completions are not hidden, but updated -if they are already visible while the current behavior stays the same -as default if they are not." - :type '(choice (const :tag "Disabled" nil) - (const :tag "Enabled legacy" t) - (const :tag "After a second attempt" lazy) - (const :tag "Visible update" visible) - (const :tag "Always update" always))) +If the value is 'always', the *Completions* buffer is always shown +after a completion attempt, and the list of completions is updated if +already visible. +If the value is 'visible', the *Completions* buffer is displayed +whenever completion is requested but cannot be done for the first time, +but remains visible thereafter, and the list of completions in it is +updated for subsequent attempts to complete.." + :type '(choice (const :tag "Don't show" nil) + (const :tag "Show only when cannot complete" t) + (const :tag "Show after second failed completion attempt" lazy) + (const :tag + "Leave visible after first failed completion" visible) + (const :tag "Always visible" always))) (defvar completion-styles-alist '((emacs21 |