From 31ec3954b6e2eeabeeddc4def82cf20d8cb32728 Mon Sep 17 00:00:00 2001
From: gryf <gryf73@gmail.com>
Date: Thu, 1 Jun 2017 06:04:23 +0200
Subject: [PATCH] Added readme file

---
 README.rst | 70 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)
 create mode 100644 README.rst

diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..d212506
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,70 @@
+dragvisuals
+===========
+
+This is **exact** copy of `Damian Conway`_ script for moving visually selected
+blocks around. The purpose of this repository is to make it more convenient for
+package managers like Pathogen_.
+
+Installation
+------------
+
+To install it, any kind of Vim package manager can be used, like NeoBundle_,
+Pathogen_, Vundle_ or vim-plug_.
+
+For manual installation, copy subdirectories from this repository to your
+``~/.vim`` directory.
+
+Usage
+-----
+
+To use it, add the following  to your ``.vimrc``:
+
+.. code:: vim
+
+   vmap  <expr>  <LEFT>   DVB_Drag('left')
+   vmap  <expr>  <RIGHT>  DVB_Drag('right')
+   vmap  <expr>  <DOWN>   DVB_Drag('down')
+   vmap  <expr>  <UP>     DVB_Drag('up')
+   vmap  <expr>  D        DVB_Duplicate()
+
+   " Remove any introduced trailing whitespace after moving...
+   let g:DVB_TrimWS = 1
+
+Or, if you use the arrow keys for normal motions, choose four other keys for
+block dragging. For example:
+
+.. code:: vim
+
+   vmap  <expr>  h        DVB_Drag('left')
+   vmap  <expr>  l        DVB_Drag('right')
+   vmap  <expr>  j        DVB_Drag('down')
+   vmap  <expr>  k        DVB_Drag('up')
+
+Or:
+
+.. code:: vim
+
+   vmap  <expr>  <S-LEFT>   DVB_Drag('left')
+   vmap  <expr>  <S-RIGHT>  DVB_Drag('right')
+   vmap  <expr>  <S-DOWN>   DVB_Drag('down')
+   vmap  <expr>  <S-UP>     DVB_Drag('up')
+
+Or even:
+
+.. code:: vim
+
+   vmap  <expr>   <LEFT><LEFT>   DVB_Drag('left')
+   vmap  <expr>  <RIGHT><RIGHT>  DVB_Drag('right')
+   vmap  <expr>   <DOWN><DOWN>   DVB_Drag('down')
+   vmap  <expr>     <UP><UP>     DVB_Drag('up')
+
+License
+-------
+
+This work is placed under public domain.
+
+.. _Pathogen: https://github.com/tpope/vim-pathogen
+.. _Vundle: https://github.com/gmarik/Vundle.vim
+.. _NeoBundle: https://github.com/Shougo/neobundle.vim
+.. _vim-plug: https://github.com/junegunn/vim-plug
+.. _Damian Conway: https://github.com/thoughtstream/Damian-Conway-s-Vim-Setup