Skip to content
Newer
Older
100644 83 lines (59 sloc) 2.73 KB
f44666c @tpope Underlined Markdown headings are dumb
authored
1 # unimpaired.vim
0af2721 @tpope Add README
authored
2
3 Much of unimpaired.vim was extracted from my vimrc when I noticed a
728535b @tpope Add option togglers
authored
4 pattern: complementary pairs of mappings. They mostly fall into four
0af2721 @tpope Add README
authored
5 categories.
6
7 There are mappings which are simply short normal mode aliases for
8 commonly used ex commands. `]q` is :cnext. `[q` is :cprevious. `]a` is
9 :next. `[b` is :bprevious. See the documentation for the full set of
10 20 mappings and mnemonics. All of them take a count.
11
12 There are linewise mappings. `[<Space>` and `]<Space>` add newlines
13 before and after the cursor line. `[e` and `]e` exchange the current
14 line with the one above or below it.
15
728535b @tpope Add option togglers
authored
16 There are mappings for toggling options. `[os`, `]os`, and `cos` perform
17 `:set spell`, `:set nospell`, and `:set invspell`, respectively. There's also
18 `l` (`list`), `n` (`number`), `w` (`wrap`), `x` (`cursorline cursorcolumn`),
cabf4b7 @tpope Wrap the 'paste' dance
authored
19 and several others, plus mappings to help alleviate the `set paste` dance.
20 Consult the documentation.
728535b @tpope Add option togglers
authored
21
0af2721 @tpope Add README
authored
22 There are mappings for encoding and decoding. `[x` and `]x` encode and
23 decode XML (and HTML). `[u` and `]u` encode and decode URLs. `[y` and
a03f01d @tpope Remove Base64 encoding from documentation
authored
24 `]y` do C String style escaping.
0af2721 @tpope Add README
authored
25
ac65386 @tpope Change [o and ]o to [f and ]f
authored
26 And in the miscellaneous category, there's `[f` and `]f` to go to the
0af2721 @tpope Add README
authored
27 next/previous file in the directory, and `[n` and `]n` to jump between
28 SCM conflict markers.
29
46226c1 @tpope Clarify repeatability
authored
30 The `.` command works with all operator mappings, and will work with the
31 linewise mappings as well if you install
32 [repeat.vim](https://github.com/tpope/vim-repeat).
0af2721 @tpope Add README
authored
33
f44666c @tpope Underlined Markdown headings are dumb
authored
34 ## Installation
0af2721 @tpope Add README
authored
35
36 If you don't have a preferred installation method, I recommend
37 installing [pathogen.vim](https://github.com/tpope/vim-pathogen), and
38 then simply copy and paste:
39
40 cd ~/.vim/bundle
41 git clone git://github.com/tpope/vim-unimpaired.git
42
43 Once help tags have been generated, you can view the manual with
44 `:help unimpaired`.
45
f4a9143 @tpope Add a FAQ entry about non-US keyboards
authored
46 ## FAQ
47
48 > My non-US keyboard makes it hard to type `[` and `]`. Can I configure
49 > different prefix characters?
50
51 Not en masse, but you can just map to `[` and `]` directly:
52
53 nmap < [
54 nmap > ]
55 omap < [
56 omap > ]
57 xmap < [
58 xmap > ]
59
60 Note we're not using the `noremap` family because we *do* want to recursively
61 invoke unimpaired.vim's maps.
62
63 There are also `<Plug>` maps if you want a more granular approach.
64
f44666c @tpope Underlined Markdown headings are dumb
authored
65 ## Contributing
0af2721 @tpope Add README
authored
66
67 See the contribution guidelines for
68 [pathogen.vim](https://github.com/tpope/vim-pathogen#readme).
69
f44666c @tpope Underlined Markdown headings are dumb
authored
70 ## Self-Promotion
0af2721 @tpope Add README
authored
71
72 Like unimpaired.vim? Follow the repository on
73 [GitHub](https://github.com/tpope/vim-unimpaired) and vote for it on
48d1cb6 @wjlroe Correct link to vim.org
wjlroe authored
74 [vim.org](http://www.vim.org/scripts/script.php?script_id=1590). And if
0af2721 @tpope Add README
authored
75 you're feeling especially charitable, follow [tpope](http://tpo.pe/) on
76 [Twitter](http://twitter.com/tpope) and
77 [GitHub](https://github.com/tpope).
78
f44666c @tpope Underlined Markdown headings are dumb
authored
79 ## License
0af2721 @tpope Add README
authored
80
81 Copyright (c) Tim Pope. Distributed under the same terms as Vim itself.
82 See `:help license`.
Something went wrong with that request. Please try again.