runtime(doc): improve 'complete' option description
Commit:
https://github.com/vim/vim/commit/f35a2af8ef2c9ab9f5355b32d40df7ffa0a3b830
Author: Girish Palya <
giri...@gmail.com>
Date: Thu Sep 11 15:19:22 2025 -0400
runtime(doc): improve 'complete' option description
Add minimal reference to LSP. It might help new users.
closes: #18276
Signed-off-by: Girish Palya <
giri...@gmail.com>
Signed-off-by: Christian Brabandt <
c...@256bit.org>
diff --git a/runtime/doc/insert.txt b/runtime/doc/insert.txt
index 2f8e30633..0453b6f70 100644
--- a/runtime/doc/insert.txt
+++ b/runtime/doc/insert.txt
@@ -1,4 +1,4 @@
-*insert.txt* For Vim version 9.1. Last change: 2025 Sep 10
+*insert.txt* For Vim version 9.1. Last change: 2025 Sep 11
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -1164,8 +1164,8 @@ This enables automatic completion with suggestions from the current buffer,
other windows, and listed buffers, displayed in a popup menu. Each source is
limited to 5 candidates. <Tab> and <S-Tab> move through the items when the
menu is visible. Optionally, add "preinsert" to 'completeopt' to insert the
-longest common prefix automatically. You can also add other completion
-sources to 'complete' as needed.
+longest common prefix automatically. Additional sources (e.g., LSP clients)
+may be added to 'complete' to improve completion as required.
See also 'autocomplete', 'autocompletedelay' and 'autocompletetimeout'.
diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt
index 7d891a1cf..2be98a419 100644
--- a/runtime/doc/options.txt
+++ b/runtime/doc/options.txt
@@ -2164,8 +2164,9 @@ A jump table for the options with a short description can be found at |Q_op|.
is especially important for |ins-autocompletion|.
F equivalent to using "F{func}", where the function is taken from
the 'completefunc' option.
- o equivalent to using "F{func}", where the function is taken from
- the 'omnifunc' option.
+ o equivalent to "F{func}", where {func} is taken from the 'omnifunc'
+ option. If a plugin (such as an LSP client) defines 'omnifunc', it
+ can be used through this flag.
Unloaded buffers are not loaded, thus their autocmds |:autocmd| are
not executed, this may lead to unexpected completions from some files