From 2a906bfad60b179a6ebe028c7d58ac44bc3545de Mon Sep 17 00:00:00 2001 From: Kevin Locke Date: Wed, 4 Feb 2026 18:53:08 +0000 Subject: [PATCH] docs: setting g:clipboard after provider init #37705 Problem: Users may be unaware that setting `g:clipboard` after providers are initialized has no effect, and that `has('clipboard')` initializes providers, as in #13062. Solution: Note the restriction and link to workarounds in FAQ for discoverability. --- runtime/doc/provider.txt | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/runtime/doc/provider.txt b/runtime/doc/provider.txt index 9887f17b7cc..9b755030364 100644 --- a/runtime/doc/provider.txt +++ b/runtime/doc/provider.txt @@ -199,7 +199,11 @@ registers. Nvim supports these clipboard tools, in order of priority: *g:clipboard* To configure a custom clipboard tool, set `g:clipboard` to a string name (from the above |clipboard-tool| list), or dict (to explicitly specify the shell -commands or |lambda| functions). +commands or |lambda| functions) before clipboard providers are initialized. + +Note: Clipboard providers are initialized by calling `has('clipboard')`, which +is best avoided before setting `g:clipboard`. See "G:CLIPBOARD SETTINGS ARE NOT +USED" in |faq-runtime| for workarounds. If "cache_enabled" is |TRUE| then when a selection is copied Nvim will cache the selection until the copy command process dies. When pasting, if the copy