*connecticut.txt*                                          *connecticut*

Synchronise Vim with the tmux and X11 paste buffers.

Author:   Evan Hanson <evhan@foldling.org>
License:  BSD. See |connecticut-license|.

This plugin only works on Vim 8.0 or newer, and only when 'compatible'
is not set.

------------------------------------------------------------------------
INTRODUCTION                                  *connecticut-introduction*

This plugin tries to ensure that, whenever you paste text, the result is
the same whether you're pasting into Vim (via |put| or |:put|), tmux (via
`paste-buffer`), or X11 (via middle-click or <S-Insert>).

It does this by synchronising Vim's unnamed register (|quotequote|) with
the tmux buffer and X11 clipboard.

It does THIS by overriding the |p| and |P| commands and managing the
contents of the respective buffers. So, it is necessarily a bit
invasive, but once configured it should work transparently (if not,
it's a bug).

Note that this plugin can only manage Vim's side of things. You'll need
to use some other software if you want to keep tmux and X11 in sync
independently.

------------------------------------------------------------------------
CONFIGURATION                                *connecticut-configuration*

A program that can manage the X11 clipboard must be available.

This plugin doesn't currently try to determine what programs you have
installed (see |connecticut-issues|) and simply assumes it can use
`xsel`.

You can specify an alternative program by setting:
>
  let g:connecticut_x11_clipboard_command = 'xclip'
<
------------------------------------------------------------------------
ISSUES                                              *connecticut-issues*

There should be some kind of warning issued if `xsel` isn't installed.
Similarly, `xclip` should be used automatically if it's available.

I'm not sure what will happen when 'clipboard' is set.

------------------------------------------------------------------------
LICENSE                                            *connecticut-license*

Copyright © 2019 Evan Hanson <evhan@foldling.org>.

BSD-style license. See LICENSE for details.