aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorKutsan Kaplan <me@kutsankaplan.com>2017-10-24 16:59:52 +0300
committerKutsan Kaplan <me@kutsankaplan.com>2017-10-24 16:59:52 +0300
commit09ffe85e47d55d7aa67da1853b775eaae7660a0f (patch)
tree77bb70c75e16ac5bb02113bdd7b2a3490b15fda5 /README.md
downloadzsh-system-clipboard.zsh-09ffe85e47d55d7aa67da1853b775eaae7660a0f.tar.xz
zsh-system-clipboard.zsh-09ffe85e47d55d7aa67da1853b775eaae7660a0f.zip
Initial commitv0.1.0
Diffstat (limited to 'README.md')
-rw-r--r--README.md23
1 files changed, 23 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..206e059
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# zsh-system-clipboard
+
+Zsh plugin that adds key bindings support for ZLE (Zsh Line Editor) clipboard operations for vi emulation keymaps.
+
+> The plugin in its early stage. It needs many improvements and for now it's not intended to use. Come back later or use this experimental version and provide feedbacks. Also, it's only tested on the latest version of Zsh.
+
+By default, ZLE has its own clipboard buffer. So, using keys like <kbd>y</kbd> when ZLE's normal mode for yanking operations will not send that yanked text to system clipboard. It will live inside ZLE and using <kbd>C-v</kbd> won't paste that text in another program. This plugin synchronize your system clipboard with ZLE buffers while it's not overriding anything. You can still use ZLE's <kbd>"</kbd> buffers if you want to.
+
+## Installation
+
+Clone the project and source the `zsh-system-clipboard.zsh` file somewhere in your `.zshrc`.
+
+```
+source /path/to/project/zsh-system-clipboard.zsh
+```
+
+## Usage
+
+> TODO but basically using key like `y, Y, p, P` will do the trick. More keys will be added.
+
+## License
+
+GPLv3