]> git.r.bdr.sh - rbdr/dotfiles/blob - vim/doc/unimpaired.txt
82d61a9126014aa95e36f30568263156d5581dac
[rbdr/dotfiles] / vim / doc / unimpaired.txt
1 *unimpaired.txt* Pairs of handy bracket mappings
2
3 Author: Tim Pope <http://tpo.pe/>
4 License: Same terms as Vim itself (see |license|)
5
6 This plugin is only available if 'compatible' is not set.
7
8 INTRODUCTION *unimpaired*
9
10 This plugin provides several pairs of bracket maps.
11
12 NEXT AND PREVIOUS *unimpaired-next*
13
14 The following maps all correspond to normal mode commands. If a count is
15 given, it becomes an argument to the command. A mnemonic for the "a" commands
16 is "args" and for the "q" commands is "quickfix".
17
18 *[a* |:previous|
19 *]a* |:next|
20 *[A* |:first|
21 *]A* |:last|
22 *[b* |:bprevious|
23 *]b* |:bnext|
24 *[B* |:bfirst|
25 *]B* |:blast|
26 *[l* |:lprevious|
27 *]l* |:lnext|
28 *[L* |:lfirst|
29 *]L* |:llast|
30 *[q* |:cprevious|
31 *]q* |:cnext|
32 *[Q* |:cfirst|
33 *]Q* |:clast|
34 *[t* |:tprevious|
35 *]t* |:tnext|
36 *[T* |:tfirst|
37 *]T* |:tlast|
38
39 *[o*
40 [o Go to the file preceding the current one
41 alphabetically in the current file's directory.
42
43 *]o*
44 ]o Go to the file succeeding the current one
45 alphabetically in the current file's directory.
46
47 LINE OPERATIONS *unimpaired-lines*
48
49 *[<Space>*
50 [<Space> Add [count] blank lines above the cursor.
51
52 *]<Space>*
53 ]<Space> Add [count] blank lines below the cursor.
54
55 *[e* *v_[e*
56 [e Exchange the current line with [count] lines above it.
57
58 *]e* *v_]e*
59 ]e Exchange the current line with [count] lines below it.
60
61 ENCODING AND DECODING *unimpaired-encoding*
62
63 Each of these operations has a map that takes a motion, a map that
64 targets [count] lines, and a visual mode map. The linewise variant integrates
65 with repeat.vim.
66
67 Mnenomic: encoding always comes before decoding; "[" always comes before "]".
68
69 *[x* *[xx* *v_[x*
70 [x{motion} XML encode.
71 [xx <foo bar="baz"> => &lt;foo bar=&quot;baz&quot&gt;
72 {Visual}[x
73
74 *]x* *]xx* *v_]x*
75 ]x{motion} XML decode. HTML entities are handled as well.
76 ]xx
77 {Visual}]x
78
79 *[u* *[uu* *v_[u*
80 [u{motion} URL encode.
81 [uu foo bar => foo%20bar
82 {Visual}[u
83
84 *]u* *]uu* *v_]u*
85 ]u{motion} URL decode.
86 ]uu
87 {Visual}]u
88
89 *[y* *[yy* *v_[y*
90 [y{motion} C String encode. Backslash escape control
91 [yy characters, quotation marks, and backslashes.
92 {Visual}[y
93
94 *]y* *]yy* *v_]y*
95 ]y{motion} C String decode.
96 ]yy
97 {Visual}]y
98
99 TODO *unimpaired-todo*
100
101 Avoid munging null characters when encoding and decoding.
102
103 vim:tw=78:et:ft=help:norl: