aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: e7f6b5e11799e7958686b62dec743dd2c04793ce (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
System Copy
===========

System copy provides vim mappings for copying text to the os specific
clipboard.  Most people will be happy just setting their Vim clipboard to the
system clipboard, but I find that doing so pollutes my clipboard history.
Instead, this plugin creates a unique mapping that explicitly pulls content
from Vim into the system clipboard.

Usage
-----

System copy provides a mapping to copy to the system clipboard. It accepts a
motion or can be used with a visual selection.

The default mapping is `cp`, and can be followed by any motion or text
object. For instance:

- `cpiw` => copy word into system clipboard
- `cpi'` => copy inside single quotes to system clipboard

In addition, `cP` is mapped to copy the current line directly.

Clipboard Utilities
-------------------

 - OSX     - pbcopy
 - Windows - clip
 - Linux   - xsel

Installation
------------

If you don't have a preferred installation method, I recommend using [Vundle][].
Assuming you have Vundle installed and configured, the following steps will
install the plugin:

Add the following line to your `~/.vimrc` and then run `PluginInstall` from
within Vim:

``` vim
Plugin 'christoomey/vim-system-copy'
```