{pattern}, this must be the last entry.
*'clipmethod'* *'cpm'*
-'clipmethod' 'cpm' string (default for Unix: "wayland,x11",
- for VMS: "x11",
- otherwise: "")
+'clipmethod' 'cpm' string (default for Unix: "wayland,x11,gui,other",
+ for VMS: "x11,gui,other",
+ otherwise: "gui,other")
global
- {only when the |+xterm_clipboard| or
- |+wayland_clipboard| features are included}
+ {only when the |+clipboard| feature is included}
Specifies which method of accessing the system clipboard is used,
depending on which method works first or is available. Supported
methods are:
wayland Wayland selections
x11 X11 selections
+ gui GUI specific method
+ other Some other method
- Note: This option is ignored when either the GUI is running or if Vim
- is run on a system without Wayland or X11 support, such as Windows or
- macOS. The GUI or system way of accessing the clipboard is always
- used instead.
+ Note: "other" is used on systems without X11/Wayland, such as
+ MS-Windows or MacOS, when running Vim without the GUI.
The option value is a list of comma separated items. The list is
parsed left to right in order, and the first method that Vim
determines is available or is working is used as the actual method for
- accessing the clipboard.
+ accessing the clipboard. Setting this option to an empty value
+ disables the clipboard functionality on all systems.
- The current method that is being used can be found in the |v:clipmethod|
- variable.
+ The current method that is being used can be found in the
+ |v:clipmethod| variable.
*'cmdheight'* *'ch'*
'cmdheight' 'ch' number (default 1)
}
static int
-clip_gen_own_selection(Clipboard_T *cbd)
+clip_gen_own_selection(Clipboard_T *cbd UNUSED)
{
-#if defined(FEAT_XCLIPBOARD) || defined(FEAT_WAYLAND_CLIPBOARD)
-# ifdef FEAT_GUI
- if (gui.in_use)
- return clip_mch_own_selection(cbd);
- else
-# endif
+ if (clipmethod == CLIPMETHOD_GUI)
+ {
+#ifdef FEAT_GUI
+ if (gui.in_use)
+ return clip_mch_own_selection(cbd);
+#endif
+ }
+ else if (clipmethod == CLIPMETHOD_WAYLAND)
{
- if (clipmethod == CLIPMETHOD_WAYLAND)
- {
#ifdef FEAT_WAYLAND_CLIPBOARD
- return clip_wl_own_selection(cbd);
+ return clip_wl_own_selection(cbd);
#endif
- }
- else if (clipmethod == CLIPMETHOD_X11)
- {
+ }
+ else if (clipmethod == CLIPMETHOD_X11)
+ {
#ifdef FEAT_XCLIPBOARD
- return clip_xterm_own_selection(cbd);
+ return clip_xterm_own_selection(cbd);
#endif
- }
}
- return FAIL;
-#else
- return clip_mch_own_selection(cbd);
+ else if (clipmethod == CLIPMETHOD_OTHER)
+ {
+#if !defined(FEAT_XCLIPBOARD) && !defined(FEAT_WAYLAND_CLIPBOARD)
+ return clip_mch_own_selection(cbd);
#endif
+ }
+ return FAIL;
}
void
}
static void
-clip_gen_lose_selection(Clipboard_T *cbd)
+clip_gen_lose_selection(Clipboard_T *cbd UNUSED)
{
-#if defined(FEAT_XCLIPBOARD) || defined(FEAT_WAYLAND_CLIPBOARD)
-# ifdef FEAT_GUI
- if (gui.in_use)
- clip_mch_lose_selection(cbd);
- else
-# endif
+ if (clipmethod == CLIPMETHOD_GUI)
+ {
+#ifdef FEAT_GUI
+ if (gui.in_use)
+ clip_mch_lose_selection(cbd);
+#endif
+ }
+ else if (clipmethod == CLIPMETHOD_WAYLAND)
{
- if (clipmethod == CLIPMETHOD_WAYLAND)
- {
#ifdef FEAT_WAYLAND_CLIPBOARD
- clip_wl_lose_selection(cbd);
+ clip_wl_lose_selection(cbd);
#endif
- }
- else if (clipmethod == CLIPMETHOD_X11)
- {
+ }
+ else if (clipmethod == CLIPMETHOD_X11)
+ {
#ifdef FEAT_XCLIPBOARD
- clip_xterm_lose_selection(cbd);
+ clip_xterm_lose_selection(cbd);
#endif
- }
}
-#else
- clip_mch_lose_selection(cbd);
+ else if (clipmethod == CLIPMETHOD_OTHER)
+ {
+#if !defined(FEAT_XCLIPBOARD) && !defined(FEAT_WAYLAND_CLIPBOARD)
+ return clip_mch_lose_selection(cbd);
#endif
+ }
}
void
return;
}
}
-#if defined(FEAT_XCLIPBOARD) || defined(FEAT_WAYLAND_CLIPBOARD)
-# ifdef FEAT_GUI
- if (gui.in_use)
+ if (clipmethod == CLIPMETHOD_GUI)
+ {
+#ifdef FEAT_GUI
+ if (gui.in_use)
clip_mch_set_selection(cbd);
- else
-# endif
+#endif
+ }
+ else if (clipmethod == CLIPMETHOD_WAYLAND)
{
- if (clipmethod == CLIPMETHOD_WAYLAND)
- {
#ifdef FEAT_WAYLAND_CLIPBOARD
- clip_wl_set_selection(cbd);
+ clip_wl_set_selection(cbd);
#endif
- }
- else if (clipmethod == CLIPMETHOD_X11)
- {
+ }
+ else if (clipmethod == CLIPMETHOD_X11)
+ {
#ifdef FEAT_XCLIPBOARD
- clip_xterm_set_selection(cbd);
+ clip_xterm_set_selection(cbd);
#endif
- }
}
-#else
- clip_mch_set_selection(cbd);
+ else if (clipmethod == CLIPMETHOD_OTHER)
+ {
+#if !defined(FEAT_XCLIPBOARD) && !defined(FEAT_WAYLAND_CLIPBOARD)
+ return clip_mch_set_selection(cbd);
#endif
+ }
}
static void
-clip_gen_request_selection(Clipboard_T *cbd)
+clip_gen_request_selection(Clipboard_T *cbd UNUSED)
{
-#if defined(FEAT_XCLIPBOARD) || defined(FEAT_WAYLAND_CLIPBOARD)
+ if (clipmethod == CLIPMETHOD_GUI)
+ {
# ifdef FEAT_GUI
- if (gui.in_use)
- clip_mch_request_selection(cbd);
- else
+ if (gui.in_use)
+ clip_mch_request_selection(cbd);
# endif
+ }
+ else if (clipmethod == CLIPMETHOD_WAYLAND)
{
- if (clipmethod == CLIPMETHOD_WAYLAND)
- {
#ifdef FEAT_WAYLAND_CLIPBOARD
- clip_wl_request_selection(cbd);
+ clip_wl_request_selection(cbd);
#endif
- }
- else if (clipmethod == CLIPMETHOD_X11)
- {
+ }
+ else if (clipmethod == CLIPMETHOD_X11)
+ {
#ifdef FEAT_XCLIPBOARD
- clip_xterm_request_selection(cbd);
+ clip_xterm_request_selection(cbd);
#endif
- }
}
-#else
- clip_mch_request_selection(cbd);
+ else if (clipmethod == CLIPMETHOD_OTHER)
+ {
+#if !defined(FEAT_XCLIPBOARD) && !defined(FEAT_WAYLAND_CLIPBOARD)
+ return clip_mch_request_selection(cbd);
#endif
+ }
}
#if (defined(FEAT_X11) && defined(FEAT_XCLIPBOARD) && defined(USE_SYSTEM)) \
int
clip_gen_owner_exists(Clipboard_T *cbd UNUSED)
{
-#ifdef FEAT_XCLIPBOARD
+ if (clipmethod == CLIPMETHOD_OTHER)
+ {
# ifdef FEAT_GUI_GTK
- if (gui.in_use)
- return clip_gtk_owner_exists(cbd);
- else
+ if (gui.in_use)
+ return clip_gtk_owner_exists(cbd);
# endif
+ }
+ else if (clipmethod == CLIPMETHOD_WAYLAND)
{
- if (clipmethod == CLIPMETHOD_WAYLAND)
- {
-#ifdef FEAT_WAYLAND_CLIPBOARD
- return clip_wl_owner_exists(cbd);
-#endif
- }
- else if (clipmethod == CLIPMETHOD_X11)
- {
-#ifdef FEAT_XCLIPBOARD
- return clip_x11_owner_exists(cbd);
-#endif
- }
- else
- return FALSE;
+# ifdef FEAT_WAYLAND_CLIPBOARD
+ return clip_wl_owner_exists(cbd);
+# endif
}
-#else
- return TRUE;
-#endif
+ else if (clipmethod == CLIPMETHOD_X11)
+ {
+# ifdef FEAT_XCLIPBOARD
+ return clip_x11_owner_exists(cbd);
+# endif
+ }
+ else
+ return FALSE;
+ return FALSE;
}
#endif
{
if (ga_grow(&buf, 8192) == FAIL)
break;
- start = (char_u *)buf.ga_data + buf.ga_len;
+ start = buf.ga_data + buf.ga_len;
}
}
if (STRCMP(buf, "wayland") == 0)
{
+#ifdef FEAT_GUI
+ if (!gui.in_use)
+#endif
+ {
#ifdef FEAT_WAYLAND_CLIPBOARD
- if (wayland_cb_is_ready())
- method = CLIPMETHOD_WAYLAND;
+ if (wayland_cb_is_ready())
+ method = CLIPMETHOD_WAYLAND;
#endif
+ }
}
else if (STRCMP(buf, "x11") == 0)
{
-#ifdef FEAT_XCLIPBOARD
- // x_IOerror_handler() in os_unix.c should set xterm_dpy to NULL if
- // we lost connection to the X server.
- if (xterm_dpy != NULL)
+#ifdef FEAT_GUI
+ if (!gui.in_use)
+#endif
{
- // If the X connection is lost then that handler will longjmp
- // somewhere else, in that case we will call choose_clipmethod()
- // again from there, and this if block won't be executed since
- // xterm_dpy will be set to NULL.
- xterm_update();
- method = CLIPMETHOD_X11;
+#ifdef FEAT_XCLIPBOARD
+ // x_IOerror_handler() in os_unix.c should set xterm_dpy to NULL
+ // if we lost connection to the X server.
+ if (xterm_dpy != NULL)
+ {
+ // If the X connection is lost then that handler will
+ // longjmp somewhere else, in that case we will call
+ // choose_clipmethod() again from there, and this if block
+ // won't be executed since xterm_dpy will be set to NULL.
+ xterm_update();
+ method = CLIPMETHOD_X11;
+ }
+#endif
}
+ }
+ else if (STRCMP(buf, "gui") == 0)
+ {
+#ifdef FEAT_GUI
+ if (gui.in_use)
+ method = CLIPMETHOD_GUI;
+#endif
+ }
+ else if (STRCMP(buf, "other") == 0)
+ {
+#if !defined(FEAT_XCLIPBOARD) && !defined(FEAT_WAYLAND_CLIPBOARD)
+ method = CLIPMETHOD_OTHER;
#endif
}
else
/*
* Returns name of clipmethod in a statically allocated string.
*/
- static char *
+ static char_u *
clipmethod_to_str(clipmethod_T method)
{
switch(method)
{
case CLIPMETHOD_WAYLAND:
- return "wayland";
+ return (char_u *)"wayland";
case CLIPMETHOD_X11:
- return "x11";
+ return (char_u *)"x11";
+ case CLIPMETHOD_GUI:
+ return (char_u *)"gui";
+ case CLIPMETHOD_OTHER:
+ return (char_u *)"other";
default:
- return "none";
+ return (char_u *)"none";
}
}
if (method == CLIPMETHOD_FAIL)
return e_invalid_argument;
-// If GUI is running or we are not on a system with Wayland or X11, then always
-// return CLIPMETHOD_NONE. System or GUI clipboard handling always overrides.
-#if defined(FEAT_XCLIPBOARD) || defined(FEAT_WAYLAND_CLIPBOARD)
-#if defined(FEAT_GUI)
- if (gui.in_use)
- {
-#ifdef FEAT_WAYLAND
+#if defined(FEAT_GUI) && defined(FEAT_WAYLAND)
+ if (method == CLIPMETHOD_GUI)
// We only interact with Wayland for the clipboard, we can just deinit
// everything.
wayland_uninit_client();
#endif
- method = CLIPMETHOD_NONE;
- goto lose_sel_exit;
- }
-#endif
-#else
- // If on a system like windows or macos, then clipmethod is irrelevant, we
- // use their way of accessing the clipboard.
- method = CLIPMETHOD_NONE;
- goto exit;
-#endif
-
// Deinitialize clipboard if there is no way to access clipboard
if (method == CLIPMETHOD_NONE)
clip_init(FALSE);
// Disown clipboard if we are switching to a new method
if (clipmethod != CLIPMETHOD_NONE && method != clipmethod)
{
-#if (defined(FEAT_XCLIPBOARD) || defined(FEAT_WAYLAND_CLIPBOARD)) \
- && defined(FEAT_GUI)
-lose_sel_exit:
-#endif
if (clip_star.owned)
clip_lose_selection(&clip_star);
if (clip_plus.owned)
clip_lose_selection(&clip_plus);
}
-#if !defined(FEAT_XCLIPBOARD) && !defined(FEAT_WAYLAND_CLIPBOARD)
-exit:
-#endif
-
clipmethod = method;
#ifdef FEAT_EVAL
- set_vim_var_string(VV_CLIPMETHOD, (char_u*)clipmethod_to_str(method), -1);
+ set_vim_var_string(VV_CLIPMETHOD, clipmethod_to_str(method), -1);
#endif
return NULL;
" Tests for clipmethod
-source util/window_manager.vim
-
-CheckFeature clipboard_working
-CheckFeature xterm_clipboard
-CheckFeature wayland_clipboard
-CheckUnix
+if has('unix')
+ source util/window_manager.vim
+endif
" Test if no available clipmethod sets v:clipmethod to none and deinits clipboard
func Test_no_clipmethod_sets_v_clipmethod_none()
+ CheckFeature clipboard_working
CheckNotGui
set clipmethod=
" Test if method chosen is in line with clipmethod order
func Test_clipmethod_order()
CheckNotGui
+ CheckFeature clipboard_working
+ CheckFeature xterm_clipboard
+ CheckFeature wayland_clipboard
set cpm=wayland,x11
call EndWaylandCompositor(l:wayland_display)
endfunc
-" Test if clipmethod is set to 'none' when gui is started
-func Test_clipmethod_is_none_when_gui()
+" Test if clipmethod is set to 'gui' when gui is started
+func Test_clipmethod_is_gui_when_gui_started()
CheckCanRunGui
+ CheckFeature clipboard_working
let lines =<< trim END
- set cpm=wayland,x11
call writefile([v:clipmethod != ""], 'Cbdscript')
gui -f
call writefile([v:clipmethod], 'Cbdscript', 'a')
call writefile(lines, 'Cbdscript', 'D')
call system($'{GetVimCommand()} -S Cbdscript')
- call assert_equal(['1', 'none', 'none'], readfile('Cbdscript'))
+ call assert_equal(['1', 'gui', 'gui'], readfile('Cbdscript'))
endfunc
" Test if :clipreset switches methods when current one doesn't work
func Test_clipreset_switches()
CheckNotGui
+ CheckFeature clipboard_working
+ CheckFeature xterm_clipboard
+ CheckFeature wayland_clipboard
CheckFeature clientserver
CheckXServer
CheckWaylandCompositor
endif
endfunc
+" Test if v:clipmethod is "other" on non-gui versions of MacOS and Windows
+" builds
+func Test_clipmethod_is_other_on_non_x11_wayland()
+ CheckFeature clipboard_working
+ CheckNotGui
+ CheckNotFeature wayland
+ CheckNotFeature x11
+
+ call assert_equal("other", v:clipmethod)
+endfunc
+
" vim: shiftwidth=2 sts=2 expandtab