1 *move.txt* Moving lines and selections up and even down
3 Author: Matthias Vogelgesang <github.com/matze>
4 License: MIT (see |move-license|)
6 ===============================================================================
7 Contents *move-contents*
9 1. Usage..................................|move-usage|
10 2. Mappings...............................|move-mappings|
11 3. License................................|move-license|
12 4. Changelog..............................|move-changelog|
14 ===============================================================================
17 The move plugin is used to move lines and visual selections up and down by
18 wrapping the :move command.
20 ===============================================================================
21 2. Mappings *move-mappings*
23 To enable custom key maps you must disable the automatic key maps with >
25 let g:move_map_keys = 0
27 The plugin provide finger-friendly mappings to move text around by using <jk>
28 keys. Your can specify the key modifier that uses in key bindings with >
30 let g:move_key_modifier = 'M'
32 All mappings can be prefixed with a {count} and will move {count} steps
35 -------------------------------------------------------------------------------
36 2.1 <Plug>MoveBlockDown
38 Move selected block down by one line.
40 Default: vmap <A-j> <Plug>MoveBlockDown
42 -------------------------------------------------------------------------------
45 Move selected block up by one line.
47 Default: vmap <A-k> <Plug>MoveBlockUp
49 -------------------------------------------------------------------------------
50 2.3 <Plug>MoveLineDown
52 Move current line down by one.
54 Default: nmap <A-j> <Plug>MoveLineDown
56 -------------------------------------------------------------------------------
59 Move current line up by one.
61 Default: nmap <A-k> <Plug>MoveLineUp
63 -------------------------------------------------------------------------------
64 2.5 <Plug>MoveBlockHalfPageDown
66 Move selected block down by half a page size.
70 -------------------------------------------------------------------------------
71 2.6 <Plug>MoveBlockHalfPageUp
73 Move selected block up by half a page size.
77 -------------------------------------------------------------------------------
78 2.7 <Plug>MoveLineHalfPageDown
80 Move current line down by half a page size.
84 -------------------------------------------------------------------------------
85 2.7 <Plug>MoveLineHalfPageUp
87 Move current line up by half a page size.
91 ===============================================================================
92 3. License *move-license*
94 This plugin is copyright by Matthias Vogelgesang and licensed under the MIT
97 ===============================================================================
98 3. Changelog *move-changelog*
101 * Silence :move commands to avoid first-time errors on read-only files.
104 * Released on 08/14/13
105 * Add key modifier for bindings (@vitalk)
106 * Use <A-j> and <A-k> in normal and visual mode (@vitalk)
107 * Add <Plug>Move{Block,Line}HalfPage{Up,Down} to move text in larger
110 * Released on 08/10/13
111 * Minor bug fixes (helptags, mapping, docs)
113 * Released on 08/10/13