Browse files


  • Loading branch information...
tpope committed Mar 7, 2012
1 parent 928467e commit 0af27215c628bbc772dd4d7c2fe318071c3f6366
Showing with 61 additions and 0 deletions.
  1. +61 −0 README.markdown
@@ -0,0 +1,61 @@
+Much of unimpaired.vim was extracted from my vimrc when I noticed a
+pattern: complementary pairs of mappings. They mostly fall into three
+There are mappings which are simply short normal mode aliases for
+commonly used ex commands. `]q` is :cnext. `[q` is :cprevious. `]a` is
+:next. `[b` is :bprevious. See the documentation for the full set of
+20 mappings and mnemonics. All of them take a count.
+There are linewise mappings. `[<Space>` and `]<Space>` add newlines
+before and after the cursor line. `[e` and `]e` exchange the current
+line with the one above or below it.
+There are mappings for encoding and decoding. `[x` and `]x` encode and
+decode XML (and HTML). `[u` and `]u` encode and decode URLs. `[y` and
+`]y` do C String style escaping.
+And in the miscellaneous category, there's `[o` and `]o` to go to the
+next/previous file in the directory, and `[n` and `]n` to jump between
+SCM conflict markers.
+The `.` command will work with the linewise encoding mappings if you
+install [repeat.vim](
+If you don't have a preferred installation method, I recommend
+installing [pathogen.vim](, and
+then simply copy and paste:
+ cd ~/.vim/bundle
+ git clone git://
+Once help tags have been generated, you can view the manual with
+`:help unimpaired`.
+See the contribution guidelines for
+Like unimpaired.vim? Follow the repository on
+[GitHub]( and vote for it on
+[]( And if
+you're feeling especially charitable, follow [tpope]( on
+[Twitter]( and
+Copyright (c) Tim Pope. Distributed under the same terms as Vim itself.
+See `:help license`.

0 comments on commit 0af2721

Please sign in to comment.