mirrors/neovim
1
0
Fork 0
mirror of https://github.com/neovim/neovim.git synced 2026-08-28 18:11:47 +00:00
Code Issues Packages Projects Releases Wiki Activity

feat(clipboard)!: use OSC 52 as fallback clipboard provider (#31730)

Browse Source 
We currently enable the OSC 52 clipboard provider by setting g:clipboard
when a list of conditions are met, one of which is that $SSH_TTY must be
set. We include this condition because often OSC 52 is not the best
clipboard provider, so if there are "local" providers available Nvim
should prefer those over OSC 52.

However, if no other providers are available, Nvim should use OSC 52
even when $SSH_TTY is not set. When a user is in an SSH session then the
checks for the other clipboard providers will still (typically) fail, so
OSC 52 continues to be enabled by default in SSH sessions.

This is marked as a breaking change because there are some cases where
OSC 52 wasn't enabled before and is now (or vice versa).
This commit is contained in:
Gregory Anders
2024-12-31 09:59:03 -06:00
committed by GitHub
parent 0bef3b911c
commit a389dc2f95
5 changed files with 37 additions and 41 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
runtime/doc/news.txt
View File

@@ -174,7 +174,9 @@ TREESITTER
TUI
• TODO
• OSC 52 is used as a fallback clipboard provider when no other
|clipboard-tool| is found, even when not using SSH |clipboard-osc52|. To
disable OSC 52 queries, set the "osc52" key of |g:termfeatures| to false.
VIMSCRIPT

28
runtime/doc/provider.txt
View File

@@ -259,23 +259,21 @@ For Windows WSL, try this g:clipboard definition:
*clipboard-osc52*
Nvim bundles a clipboard provider that allows copying to the system clipboard
using OSC 52. OSC 52 is an Operating System Command control sequence that
writes the copied text to the terminal emulator. If the terminal emulator
supports OSC 52 then it will write the copied text into the system clipboard.
causes the terminal emulator to write to or read from the system clipboard.
Nvim will attempt to automatically determine if the host terminal emulator
supports the OSC 52 sequence and enable the OSC 52 clipboard provider if it
does as long as all of the following are true:
When Nvim is running in the |TUI|, it will automatically attempt to determine if
the host terminal emulator supports OSC 52. If it does, then Nvim will use OSC
52 for copying and pasting if no other |clipboard-tool| is found and when
'clipboard' is unset.
• Nvim is running in the |TUI|
• |g:clipboard| is unset
• 'clipboard' is not set to "unnamed" or "unnamedplus"
• $SSH_TTY is set
If any of the above conditions are not met then the OSC 52 clipboard provider
will not be used by default and Nvim will fall back to discovering a
|clipboard-tool| through the usual process.
To force Nvim to use the OSC 52 provider you can use the following
*g:termfeatures*
To disable the automatic detection, set the "osc52" key of |g:termfeatures| to
|v:false| in the |config| file. Example: >lua
local termfeatures = vim.g.termfeatures or {}
termfeatures.osc52 = false
vim.g.termfeatures = termfeatures
<
To force Nvim to always use the OSC 52 provider you can use the following
|g:clipboard| definition: >lua
vim.g.clipboard = {