]> git.r.bdr.sh - rbdr/dotfiles/blame_incremental - vim/doc/unimpaired.txt
A whole bunch of new additions to the submodules
[rbdr/dotfiles] / vim / doc / unimpaired.txt
... / ...
CommitLineData
1*unimpaired.txt* Pairs of handy bracket mappings
2
3Author: Tim Pope <http://tpo.pe/>
4License: Same terms as Vim itself (see |license|)
5
6This plugin is only available if 'compatible' is not set.
7
8INTRODUCTION *unimpaired*
9
10This plugin provides several pairs of bracket maps.
11
12NEXT AND PREVIOUS *unimpaired-next*
13
14The following maps all correspond to normal mode commands. If a count is
15given, it becomes an argument to the command. A mnemonic for the "a" commands
16is "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
47LINE 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
61ENCODING AND DECODING *unimpaired-encoding*
62
63Each of these operations has a map that takes a motion, a map that
64targets [count] lines, and a visual mode map. The linewise variant integrates
65with repeat.vim.
66
67Mnenomic: 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
99TODO *unimpaired-todo*
100
101Avoid munging null characters when encoding and decoding.
102
103 vim:tw=78:et:ft=help:norl: