[rbdr/dotfiles] / vim / doc / unimpaired.txt

*unimpaired.txt*  Pairs of handy bracket mappings

Author:  Tim Pope <http://tpo.pe/>
License: Same terms as Vim itself (see |license|)

This plugin is only available if 'compatible' is not set.

INTRODUCTION                                    *unimpaired*

This plugin provides several pairs of bracket maps.

NEXT AND PREVIOUS                               *unimpaired-next*

The following maps all correspond to normal mode commands.  If a count is
given, it becomes an argument to the command.  A mnemonic for the "a" commands
is "args" and for the "q" commands is "quickfix".

*[a* |:previous|
*]a* |:next|
*[A* |:first|
*]A* |:last|
*[b* |:bprevious|
*]b* |:bnext|
*[B* |:bfirst|
*]B* |:blast|
*[l* |:lprevious|
*]l* |:lnext|
*[L* |:lfirst|
*]L* |:llast|
*[q* |:cprevious|
*]q* |:cnext|
*[Q* |:cfirst|
*]Q* |:clast|
*[t* |:tprevious|
*]t* |:tnext|
*[T* |:tfirst|
*]T* |:tlast|

                                                *[o*
[o                      Go to the file preceding the current one
                        alphabetically in the current file's directory.

                                                *]o*
]o                      Go to the file succeeding the current one
                        alphabetically in the current file's directory.

LINE OPERATIONS                                 *unimpaired-lines*

                                                *[<Space>*
[<Space>                Add [count] blank lines above the cursor.

                                                *]<Space>*
]<Space>                Add [count] blank lines below the cursor.

                                                *[e* *v_[e*
[e                      Exchange the current line with [count] lines above it.

                                                *]e* *v_]e*
]e                      Exchange the current line with [count] lines below it.

ENCODING AND DECODING                           *unimpaired-encoding*

Each of these operations has a map that takes a motion, a map that
targets [count] lines, and a visual mode map.  The linewise variant integrates
with repeat.vim.

Mnenomic: encoding always comes before decoding; "[" always comes before "]".

                                                *[x* *[xx* *v_[x*
[x{motion}              XML encode.
[xx                     <foo bar="baz"> => &lt;foo bar=&quot;baz&quot&gt;
{Visual}[x

                                                *]x* *]xx* *v_]x*
]x{motion}              XML decode.  HTML entities are handled as well.
]xx
{Visual}]x

                                                *[u* *[uu* *v_[u*
[u{motion}              URL encode.
[uu                     foo bar => foo%20bar
{Visual}[u

                                                *]u* *]uu* *v_]u*
]u{motion}              URL decode.
]uu
{Visual}]u

                                                *[y* *[yy* *v_[y*
[y{motion}              C String encode.  Backslash escape control
[yy                     characters, quotation marks, and backslashes.
{Visual}[y

                                                *]y* *]yy* *v_]y*
]y{motion}              C String decode.
]yy
{Visual}]y

TODO                                            *unimpaired-todo*

Avoid munging null characters when encoding and decoding.

 vim:tw=78:et:ft=help:norl:
Commit	Line	Data
0d23b6e5 BB	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"> => <foo bar="baz&quot>
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: