annotate runtime/doc/visual.txt @ 42:c75153d791d0

updated for version 7.0026
author vimboss
date Wed, 29 Dec 2004 20:58:21 +0000
parents 3fc0f57ecb91
children 4707450c2b33
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
42
c75153d791d0 updated for version 7.0026
vimboss
parents: 7
diff changeset
1 *visual.txt* For Vim version 7.0aa. Last change: 2004 Dec 29
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4 VIM REFERENCE MANUAL by Bram Moolenaar
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7 Visual mode *Visual* *Visual-mode* *visual-mode*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9 Visual mode is a flexible and easy way to select a piece of text for an
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10 operator. It is the only way to select a block of text.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12 This is introduced in section |04.4| of the user manual.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14 1. Using Visual mode |visual-use|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
15 2. Starting and stopping Visual mode |visual-start|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
16 3. Changing the Visual area |visual-change|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
17 4. Operating on the Visual area |visual-operators|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
18 5. Blockwise operators |blockwise-operators|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
19 6. Repeating |visual-repeat|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
20 7. Examples |visual-examples|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
21 8. Select mode |Select-mode|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
22
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
23 {Vi has no Visual mode, the name "visual" is used for Normal mode, to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
24 distinguish it from Ex mode}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
25 {not available when the |+visual| feature was disabled when compiling}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
26
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
27 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
28 1. Using Visual mode *visual-use*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
29
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
30 Using Visual mode consists of three parts:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
31 1. Mark the start of the text with "v", "V" or CTRL-V.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
32 The character under the cursor will be used as the start.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
33 2. Move to the end of the text.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
34 The text from the start of the Visual mode up to and including the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
35 character under the cursor is highlighted.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
36 3. Type an operator command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
37 The highlighted characters will be operated upon.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
38
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
39 The 'highlight' option can be used to set the display mode to use for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
40 highlighting in Visual mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
41 The 'virtualedit' option can be used to allow positioning the cursor to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
42 positions where there is no actual character.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
43
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
44 The highlighted text normally includes the character under the cursor.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
45 However, when the 'selection' option is set to "exclusive" and the cursor is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
46 after the Visual area, the character under the cursor is not included.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
47
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
48 With "v" the text before the start position and after the end position will
42
c75153d791d0 updated for version 7.0026
vimboss
parents: 7
diff changeset
49 not be highlighted. However, all uppercase and non-alpha operators, except
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
50 "~" and "U", will work on whole lines anyway. See the list of operators
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
51 below.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
52
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
53 *visual-block*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
54 With CTRL-V (blockwise Visual mode) the highlighted text will be a rectangle
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
55 between start position and the cursor. However, some operators work on whole
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
56 lines anyway (see the list below). The change and substitute operators will
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
57 delete the highlighted text and then start insertion at the top left
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
58 position.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
59
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
60 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
61 2. Starting and stopping Visual mode *visual-start*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
62
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
63 *v* *characterwise-visual*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
64 v start Visual mode per character.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
65
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
66 *V* *linewise-visual*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
67 V start Visual mode linewise.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
68
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
69 *CTRL-V* *blockwise-visual*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
70 CTRL-V start Visual mode blockwise. Note: Under Windows
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
71 CTRL-V could be mapped to paste text, it doesn't work
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
72 to start Visual mode then, see |CTRL-V-alternative|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
73
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
74 If you use <Esc>, click the left mouse button or use any command that
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
75 does a jump to another buffer while in Visual mode, the highlighting stops
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
76 and no text is affected. Also when you hit "v" in characterwise Visual mode,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
77 "CTRL-V" in blockwise Visual mode or "V" in linewise Visual mode. If you hit
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
78 CTRL-Z the highlighting stops and the editor is suspended or a new shell is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
79 started |CTRL-Z|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
80
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
81 new mode after typing: *v_v* *v_CTRL-V* *v_V*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
82 old mode "v" "CTRL-V" "V" ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
83
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
84 Normal Visual blockwise Visual linewise Visual
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
85 Visual Normal blockwise Visual linewise Visual
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
86 blockwise Visual Visual Normal linewise Visual
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
87 linewise Visual Visual blockwise Visual Normal
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
88
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
89 *gv* *v_gv*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
90 gv Start Visual mode with the same area as the previous
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
91 area and the same mode. In Visual mode the current and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
92 the previous Visual area are exchanged.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
93
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
94 *<LeftMouse>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
95 <LeftMouse> Set the current cursor position. If Visual mode is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
96 active it is stopped. Only when 'mouse' option is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
97 contains 'n' or 'a'. If the position is within 'so'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
98 lines from the last line on the screen the text is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
99 scrolled up. If the position is within 'so' lines from
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
100 the first line on the screen the text is scrolled
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
101 down.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
102
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
103 *<RightMouse>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
104 <RightMouse> Start Visual mode if it is not active. The text from
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
105 the cursor position to the position of the click is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
106 highlighted. If Visual mode was already active move
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
107 the start or end of the highlighted text, which ever
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
108 is closest, to the position of the click. Only when
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
109 'mouse' option contains 'n' or 'a'.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
110
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
111 Note: when 'mousemodel' is set to "popup",
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
112 <S-LeftMouse> has to be used instead of <RightMouse>.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
113
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
114 *<LeftRelease>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
115 <LeftRelease> This works like a <LeftMouse>, if it is not at
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
116 the same position as <LeftMouse>. In an older version
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
117 of xterm you won't see the selected area until the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
118 button is released, unless there is access to the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
119 display where the xterm is running (via the DISPLAY
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
120 environment variable or the -display argument). Only
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
121 when 'mouse' option contains 'n' or 'a'.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
122
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
123 If Visual mode is not active and the "v", "V" or CTRL-V is preceded with a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
124 count, the size of the previously highlighted area is used for a start. You
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
125 can then move the end of the highlighted area and give an operator. The type
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
126 of the old area is used (character, line or blockwise).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
127 - Linewise Visual mode: The number of lines is multiplied with the count.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
128 - Blockwise Visual mode: The number of lines and columns is multiplied with
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
129 the count.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
130 - Normal Visual mode within one line: The number of characters is multiplied
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
131 with the count.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
132 - Normal Visual mode with several lines: The number of lines is multiplied
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
133 with the count, in the last line the same number of characters is used as
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
134 in the last line in the previously highlighted area.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
135 The start of the text is the Cursor position. If the "$" command was used as
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
136 one of the last commands to extend the highlighted text, the area will be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
137 extended to the rightmost column of the longest line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
138
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
139 If you want to highlight exactly the same area as the last time, you can use
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
140 "gv" |gv| |v_gv|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
141
42
c75153d791d0 updated for version 7.0026
vimboss
parents: 7
diff changeset
142 *v_<Esc>*
c75153d791d0 updated for version 7.0026
vimboss
parents: 7
diff changeset
143 <Esc> In Visual mode: Stop Visual mode.
c75153d791d0 updated for version 7.0026
vimboss
parents: 7
diff changeset
144
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
145 *v_CTRL-C*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
146 CTRL-C In Visual mode: Stop Visual mode. When insert mode is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
147 pending (the mode message shows
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
148 "-- (insert) VISUAL --"), it is also stopped.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
149
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
150 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
151 3. Changing the Visual area *visual-change*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
152
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
153 *v_o*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
154 o Go to Other end of highlighted text: The current
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
155 cursor position becomes the start of the highlighted
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
156 text and the cursor is moved to the other end of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
157 highlighted text. The highlighted area remains the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
158 same.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
159
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
160 *v_O*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
161 O Go to Other end of highlighted text. This is like
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
162 "o", but in Visual block mode the cursor moves to the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
163 other corner in the same line. When the corner is at
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
164 a character that occupies more than one position on
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
165 the screen (e.g., a <Tab>), the highlighted text may
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
166 change.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
167
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
168 *v_$*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
169 When the "$" command is used with blockwise Visual mode, the right end of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
170 highlighted text will be determined by the longest highlighted line. This
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
171 stops when a motion command is used that does not move straight up or down.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
172
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
173 For moving the end of the block many commands can be used, but you cannot
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
174 use Ex commands, commands that make changes or abandon the file. Commands
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
175 (starting with) ".pPiIaAO&", CTRL-^, "Z", CTRL-], CTRL-T, CTRL-R, CTRL-I
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
176 and CTRL-O cause a beep and Visual mode continues.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
177
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
178 When switching to another window on the same buffer, the cursor position in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
179 that window is adjusted, so that the same Visual area is still selected. This
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
180 is especially useful to view the start of the Visual area in one window, and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
181 the end in another. You can then use <RightMouse> (or <S-LeftMouse> when
42
c75153d791d0 updated for version 7.0026
vimboss
parents: 7
diff changeset
182 'mousemodel' is "popup") to drag either end of the Visual area.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
183
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
184 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
185 4. Operating on the Visual area *visual-operators*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
186
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
187 The operators that can be used are:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
188 ~ switch case |v_~|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
189 d delete |v_d|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
190 c change (4) |v_c|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
191 y yank |v_y|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
192 > shift right (4) |v_>|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
193 < shift left (4) |v_<|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
194 ! filter through external command (1) |v_!|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
195 = filter through 'equalprg' option command (1) |v_=|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
196 gq format lines to 'textwidth' length (1) |v_gq|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
197
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
198 The objects that can be used are:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
199 aw a word (with white space) |v_aw|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
200 iw inner word |v_iw|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
201 aW a WORD (with white space) |v_aW|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
202 iW inner WORD |v_iW|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
203 as a sentence (with white space) |v_as|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
204 is inner sentence |v_is|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
205 ap a paragraph (with white space) |v_ap|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
206 ip inner paragraph |v_ip|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
207 ab a () block (with parenthesis) |v_ab|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
208 ib inner () block |v_ib|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
209 aB a {} block (with braces) |v_aB|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
210 iB inner {} block |v_iB|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
211 a< a <> block (with <>) |v_a<|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
212 i< inner <> block |v_i<|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
213 a[ a [] block (with []) |v_a[|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
214 i[ inner [] block |v_i[|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
215
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
216 Additionally the following commands can be used:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
217 : start ex command for highlighted lines (1) |v_:|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
218 r change (4) |v_r|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
219 s change |v_s|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
220 C change (2)(4) |v_C|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
221 S change (2) |v_S|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
222 R change (2) |v_R|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
223 x delete |v_x|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
224 D delete (3) |v_D|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
225 X delete (2) |v_X|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
226 Y yank (2) |v_Y|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
227 p put |v_p|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
228 J join (1) |v_J|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
229 U make uppercase |v_U|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
230 u make lowercase |v_u|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
231 ^] find tag |v_CTRL-]|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
232 I block insert |v_b_I|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
233 A block append |v_b_A|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
234
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
235 (1): Always whole lines, see |:visual_example|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
236 (2): Whole lines when not using CTRL-V.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
237 (3): Whole lines when not using CTRL-V, delete until the end of the line when
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
238 using CTRL-V.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
239 (4): When using CTRL-V operates on the block only.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
240
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
241 Note that the ":vmap" command can be used to specifically map keys in Visual
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
242 mode. For example, if you would like the "/" command not to extend the Visual
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
243 area, but instead take the highlighted text and search for that: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
244 :vmap / y/<C-R>"<CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
245 (In the <> notation |<>|, when typing it you should type it literally; you
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
246 need to remove the 'B' and '<' flags from 'cpoptions'.)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
247
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
248 If you want to give a register name using the """ command, do this just before
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
249 typing the operator character: "v{move-around}"xd".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
250
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
251 If you want to give a count to the command, do this just before typing the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
252 operator character: "v{move-around}3>" (move lines 3 indents to the right).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
253
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
254 *{move-around}*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
255 The {move-around} is any sequence of movement commands. Note the difference
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
256 with {motion}, which is only ONE movement command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
257
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
258 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
259 5. Blockwise operators *blockwise-operators*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
260
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
261 {not available when compiled without the |+visualextra| feature}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
262
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
263 Reminder: Use 'virtualedit' to be able to select blocks that start or end
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
264 after the end of a line or halfway a tab.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
265
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
266 Visual-block Insert *v_b_I*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
267 With a blockwise selection, I{string}<ESC> will insert {string} at the start
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
268 of block on every line of the block, provided that the line extends into the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
269 block. Thus lines that are short will remain unmodified. TABs are split to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
270 retain visual columns.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
271 See |v_b_I_example|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
272
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
273 Visual-block Append *v_b_A*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
274 With a blockwise selection, A{string}<ESC> will append {string} to the end of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
275 block on every line of the block. There is some differing behavior where the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
276 block RHS is not straight, due to different line lengths:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
277
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
278 1. Block was created with <C-v>$
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
279 In this case the string is appended to the end of each line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
280 2. Block was created with <C-v>{move-around}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
281 In this case the string is appended to the end of the block on each line,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
282 and whitespace is inserted to pad to the end-of-block column.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
283 See |v_b_A_example|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
284 Note: "I" and "A" behave differently for lines that don't extend into the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
285 selected block. This was done intentionally, so that you can do it the way
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
286 you want.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
287
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
288 Visual-block change *v_b_c*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
289 All selected text in the block will be replaced by the same text string. When
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
290 using "c" the selected text is deleted and Insert mode started. You can then
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
291 enter text (without a line break). When you hit <Esc>, the same string is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
292 inserted in all previously selected lines.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
293
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
294 Visual-block Change *v_b_C*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
295 Like using "c", but the selection is extended until the end of the line for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
296 all lines.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
297
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
298 *v_b_<*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
299 Visual-block Shift *v_b_>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
300 The block is shifted by 'shiftwidth'. The RHS of the block is irrelevant. The
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
301 LHS of the block determines the point from which to apply a right shift, and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
302 padding includes TABs optimally according to 'ts' and 'et'. The LHS of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
303 block determines the point upto which to shift left.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
304 Note: v_< padding is buggy if the Visual Block starts and ends in the same
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
305 TAB. (Vim 5.4c).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
306 See |v_b_>_example|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
307 See |v_b_<_example|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
308
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
309 Visual-block Replace *v_b_r*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
310 Every screen char in the highlighted region is replaced with the same char, ie
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
311 TABs are split and the virtual whitespace is replaced, maintaining screen
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
312 layout.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
313 See |v_b_r_example|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
314
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
315
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
316 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
317 6. Repeating *visual-repeat*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
318
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
319 When repeating a Visual mode operator, the operator will be applied to the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
320 same amount of text as the last time:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
321 - Linewise Visual mode: The same number of lines.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
322 - Blockwise Visual mode: The same number of lines and columns.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
323 - Normal Visual mode within one line: The same number of characters.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
324 - Normal Visual mode with several lines: The same number of lines, in the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
325 last line the same number of characters as in the last line the last time.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
326 The start of the text is the Cursor position. If the "$" command was used as
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
327 one of the last commands to extend the highlighted text, the repeating will
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
328 be applied up to the rightmost column of the longest line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
329
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
330
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
331 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
332 7. Examples *visual-examples*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
333
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
334 *:visual_example*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
335 Currently the ":" command works on whole lines only. When you select part of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
336 a line, doing something like ":!date" will replace the whole line. If you
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
337 want only part of the line to be replaced you will have to make a mapping for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
338 it. In a future release ":" may work on partial lines.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
339
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
340 Here is an example, to replace the selected text with the output of "date": >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
341 :vmap _a <Esc>`>a<CR><Esc>`<i<CR><Esc>!!date<CR>kJJ
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
342
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
343 (In the <> notation |<>|, when typing it you should type it literally; you
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
344 need to remove the 'B' and '<' flags from 'cpoptions')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
345
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
346 What this does is:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
347 <Esc> stop Visual mode
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
348 `> go to the end of the Visual area
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
349 a<CR><Esc> break the line after the Visual area
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
350 `< jump to the start of the Visual area
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
351 i<CR><Esc> break the line before the Visual area
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
352 !!date<CR> filter the Visual text through date
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
353 kJJ Join the lines back together
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
354
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
355 *visual-search*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
356 Here is an idea for a mapping that makes it possible to do a search for the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
357 selected text: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
358 :vmap X y/<C-R>"<CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
359
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
360 (In the <> notation |<>|, when typing it you should type it literally; you
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
361 need to remove the 'B' and '<' flags from 'cpoptions')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
362
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
363 Note that special characters (like '.' and '*') will cause problems.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
364
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
365 Visual-block Examples *blockwise-examples*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
366 With the following text, I will indicate the commands to produce the block and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
367 the results below. In all cases, the cursor begins on the 'a' in the first
42
c75153d791d0 updated for version 7.0026
vimboss
parents: 7
diff changeset
368 line of the test text.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
369 The following modeline settings are assumed ":ts=8:sw=4:".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
370
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
371 It will be helpful to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
372 :set hls
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
373 /<TAB>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
374 where <TAB> is a real TAB. This helps visualise the operations.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
375
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
376 The test text is:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
377
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
378 abcdefghijklmnopqrstuvwxyz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
379 abc defghijklmnopqrstuvwxyz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
380 abcdef ghi jklmnopqrstuvwxyz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
381 abcdefghijklmnopqrstuvwxyz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
382
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
383 1. fo<C-v>3jISTRING<ESC> *v_b_I_example*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
384
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
385 abcdefghijklmnSTRINGopqrstuvwxyz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
386 abc STRING defghijklmnopqrstuvwxyz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
387 abcdef ghi STRING jklmnopqrstuvwxyz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
388 abcdefghijklmnSTRINGopqrstuvwxyz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
389
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
390 2. fo<C-v>3j$ASTRING<ESC> *v_b_A_example*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
391
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
392 abcdefghijklmnopqrstuvwxyzSTRING
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
393 abc defghijklmnopqrstuvwxyzSTRING
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
394 abcdef ghi jklmnopqrstuvwxyzSTRING
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
395 abcdefghijklmnopqrstuvwxyzSTRING
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
396
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
397 3. fo<C-v>3j3l<.. *v_b_<_example*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
398
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
399 abcdefghijklmnopqrstuvwxyz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
400 abc defghijklmnopqrstuvwxyz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
401 abcdef ghi jklmnopqrstuvwxyz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
402 abcdefghijklmnopqrstuvwxyz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
403
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
404 4. fo<C-v>3j>.. *v_b_>_example*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
405
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
406 abcdefghijklmn opqrstuvwxyz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
407 abc defghijklmnopqrstuvwxyz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
408 abcdef ghi jklmnopqrstuvwxyz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
409 abcdefghijklmn opqrstuvwxyz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
410
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
411 5. fo<C-v>5l3jrX *v_b_r_example*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
412
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
413 abcdefghijklmnXXXXXXuvwxyz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
414 abc XXXXXXhijklmnopqrstuvwxyz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
415 abcdef ghi XXXXXX jklmnopqrstuvwxyz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
416 abcdefghijklmnXXXXXXuvwxyz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
417
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
418 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
419 8. Select mode *Select* *Select-mode*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
420
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
421 Select mode looks like Visual mode, but the commands accepted are quite
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
422 different. This resembles the selection mode in Microsoft Windows.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
423 When the 'showmode' option is set, "-- SELECT --" is shown in the last line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
424
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
425 Entering Select mode:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
426 - Using the mouse to select an area, and 'selectmode' contains "mouse".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
427 'mouse' must also contain a flag for the current mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
428 - Using a non-printable movement command, with the Shift key pressed, and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
429 'selectmode' contains "key". For example: <S-Left> and <S-End>. 'keymodel'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
430 must also contain "startsel".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
431 - Using "v", "V" or CTRL-V command, and 'selectmode' contains "cmd".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
432 - Using "gh", "gH" or "g_CTRL-H" command in Normal mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
433 - From Visual mode, press CTRL-G. *v_CTRL-G*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
434
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
435 Commands in Select mode:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
436 - Printable characters, <NL> and <CR> cause the selection to be deleted, and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
437 Vim enters Insert mode. The typed character is inserted.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
438 - Non-printable movement commands, with the Shift key pressed, extend the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
439 selection. 'keymodel' must include "startsel".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
440 - Non-printable movement commands, with the Shift key NOT pressed, stop Select
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
441 mode. 'keymodel' must include "stopsel".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
442 - ESC stops Select mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
443 - CTRL-O switches to Visual mode for the duration of one command. *v_CTRL-O*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
444 - CTRL-G switches to Visual mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
445
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
446 Otherwise, typed characters are handled as in Visual mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
447
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
448 When using an operator in Select mode, and the selection is linewise, the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
449 selected lines are operated upon, but like in characterwise selection. For
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
450 example, when a whole line is deleted, it can later be pasted halfway a line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
451
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
452
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
453 Mappings and menus in Select mode. *Select-mode-mapping*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
454
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
455 In Select mode the mappings and menus of Visual mode are used. Before it is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
456 executed, Vim automatically switches to Visual mode, so that the same
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
457 behavior as in Visual mode is effective.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
458
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
459 After the mapping or menu finishes, the selection is enabled again and Select
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
460 mode entered, unless the selected area was deleted, another buffer became
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
461 the current one or the window layout was changed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
462
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
463 When a character was typed that causes the selection to be deleted and Insert
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
464 mode started, Insert mode mappings are applied to this character. This may
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
465 cause some confusion, because it means Insert mode mappings apply to a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
466 character typed in Select mode. Language mappings apply as well.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
467
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
468 *gV* *v_gV*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
469 gV Avoid the automatic reselection of the Visual area
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
470 after a Select mode mapping or menu has finished.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
471 Put this just before the end of the mapping or menu.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
472 At least it should be after any operations on the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
473 selection.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
474
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
475 *gh*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
476 gh Start Select mode, characterwise. This is like "v",
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
477 but starts Select mode instead of Visual mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
478 Mnemonic: "get highlighted".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
479
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
480 *gH*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
481 gH Start Select mode, linewise. This is like "V",
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
482 but starts Select mode instead of Visual mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
483 Mnemonic: "get Highlighted".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
484
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
485 *g_CTRL-H*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
486 g CTRL-H Start Select mode, blockwise. This is like CTRL-V,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
487 but starts Select mode instead of Visual mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
488 Mnemonic: "get Highlighted".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
489
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
490 vim:tw=78:ts=8:ft=help:norl: