diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 34 |
1 files changed, 31 insertions, 3 deletions
@@ -1,8 +1,36 @@ System Copy =========== +System copy provides vim mappings for copying text to the clipboard on OS X +using `pbcopy`. 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 selction. +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. + +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 `BundleInstall` from +within Vim: -`cpiw` => copy word into system clipboard -`cpi'` => copy inside single quotes to system clipboard +``` vim +Bundle 'christoomey/vim-system-copy' +``` |