commit 9f33b69cfdf330a6c89cd107074e6f28070bdda0
parent 3f422cb5eb0a24a87ac345b7e36ed719b426f28b
Author: zeertzjq <zeertzjq@outlook.com>
Date: Thu, 2 Oct 2025 11:13:03 +0800
vim-patch:cfcf1a5: runtime(doc): Clarify use of "noselect" in 'completeopt'
closes: vim/vim#18452
https://github.com/vim/vim/commit/cfcf1a57cbef90831c26626aee6ba9491fb85cb3
Co-authored-by: Girish Palya <girishji@gmail.com>
Co-authored-by: Tomasz N <przepompownia@users.noreply.github.com>
Diffstat:
3 files changed, 9 insertions(+), 3 deletions(-)
diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt
@@ -1674,7 +1674,9 @@ A jump table for the options with a short description can be found at |Q_op|.
noselect Same as "noinsert", except that no menu item is
pre-selected. If both "noinsert" and "noselect" are
- present, "noselect" has precedence.
+ present, "noselect" takes precedence. This options is
+ enabled automatically when 'autocomplete' is on, unless
+ "preinsert" is also enabled.
nosort Disable sorting of completion candidates based on fuzzy
scores when "fuzzy" is enabled. Candidates will appear
diff --git a/runtime/lua/vim/_meta/options.lua b/runtime/lua/vim/_meta/options.lua
@@ -1219,7 +1219,9 @@ vim.go.cia = vim.go.completeitemalign
---
--- noselect Same as "noinsert", except that no menu item is
--- pre-selected. If both "noinsert" and "noselect" are
---- present, "noselect" has precedence.
+--- present, "noselect" takes precedence. This options is
+--- enabled automatically when 'autocomplete' is on, unless
+--- "preinsert" is also enabled.
---
--- nosort Disable sorting of completion candidates based on fuzzy
--- scores when "fuzzy" is enabled. Candidates will appear
diff --git a/src/nvim/options.lua b/src/nvim/options.lua
@@ -1699,7 +1699,9 @@ local options = {
noselect Same as "noinsert", except that no menu item is
pre-selected. If both "noinsert" and "noselect" are
- present, "noselect" has precedence.
+ present, "noselect" takes precedence. This options is
+ enabled automatically when 'autocomplete' is on, unless
+ "preinsert" is also enabled.
nosort Disable sorting of completion candidates based on fuzzy
scores when "fuzzy" is enabled. Candidates will appear