|
18879
|
1 *version4.txt* For Vim version 8.2. Last change: 2006 Apr 24
|
|
7
|
2
|
|
|
3
|
|
|
4 VIM REFERENCE MANUAL by Bram Moolenaar
|
|
|
5
|
|
|
6
|
|
|
7 This document lists the incompatible differences between Vim 3.0 and Vim 4.0.
|
|
|
8 Although 4.0 is mentioned here, this is also for version 4.1, 4.2, etc..
|
|
|
9
|
|
|
10 This file is important for everybody upgrading from Vim 3.0. Read it
|
|
|
11 carefully to avoid unexpected problems.
|
|
|
12
|
|
|
13 'backup' option default changed |backup-changed|
|
|
|
14 Extension for backup file changed |backup-extension|
|
|
|
15 Structure of swap file changed |swapfile-changed|
|
|
|
16 "-w scriptout" argument changed |scriptout-changed|
|
|
|
17 Backspace and Delete keys |backspace-delete|
|
|
|
18 Escape for | changed |escape-bar|
|
|
|
19 Key codes changed |key-codes-changed|
|
|
|
20 Terminal options changed |termcap-changed|
|
|
|
21 'errorformat' option changed |errorformat-changed|
|
|
|
22 'graphic' option gone |graphic-option-gone|
|
|
|
23 'yankendofline' option gone |ye-option-gone|
|
|
|
24 'icon' and 'title' default value changed |icon-changed|
|
|
|
25 'highlight' option changed |highlight-changed|
|
|
|
26 'tildeop' and 'weirdinvert' short names changed |short-name-changed|
|
|
|
27 Use of "v", "V" and "CTRL-V" in Visual mode |use-visual-cmds|
|
|
|
28 CTRL-B in Insert mode removed |toggle-revins|
|
|
|
29
|
|
|
30
|
|
|
31 'backup' option default changed *backup-changed*
|
|
|
32 -------------------------------
|
|
|
33
|
|
|
34 The default value for 'backup' used to be on. This resulted in a backup file
|
|
|
35 being made when the original file was overwritten.
|
|
|
36
|
|
|
37 Now the default for 'backup' is off. As soon as the writing of the file has
|
|
|
38 successfully finished, the backup file is deleted. If you want to keep the
|
|
|
39 backup file, set 'backup' on in your vimrc. The reason for this change is
|
|
|
40 that many people complained that leaving a backup file behind is not
|
|
|
41 Vi-compatible. |'backup'|
|
|
|
42
|
|
|
43
|
|
|
44 Extension for backup file changed *backup-extension*
|
|
|
45 ---------------------------------
|
|
|
46
|
|
|
47 The extension for the backup file used to be ".bak". Since other programs
|
|
|
48 also use this extension and some users make copies with this extension, it was
|
|
|
49 changed to the less obvious "~". Another advantage is that this takes less
|
|
|
50 space, which is useful when working on a system with short file names. For
|
|
|
51 example, on MS-DOS the backup files for "longfile.c" and "longfile.h" would
|
|
|
52 both become "longfile.bak"; now they will be "longfile.c~" and "longfile.h~".
|
|
|
53
|
|
|
54 If you prefer to use ".bak", you can set the 'backupext' option: >
|
|
|
55 :set bex=.bak
|
|
|
56
|
|
|
57
|
|
|
58 Structure of swap file changed *swapfile-changed*
|
|
|
59 ------------------------------
|
|
|
60
|
|
|
61 The contents of the swap file were extended with several parameters. Vim
|
|
|
62 stores the user name and other information about the edited file to make
|
|
|
63 recovery more easy and to be able to know where the swap file comes from. The
|
|
|
64 first part of the swap file can now be understood on a machine with a
|
|
|
65 different byte order or sizeof(int). When you try to recover a file on such a
|
|
|
66 machine, you will get an error message that this is not possible.
|
|
|
67
|
|
|
68 Because of this change, swap files cannot be exchanged between 3.0 and 4.0.
|
|
|
69 If you have a swap file from a crashed session with 3.0, use Vim 3.0 to
|
|
|
70 recover the file---don't use 4.0. |swap-file|
|
|
|
71
|
|
|
72
|
|
|
73 "-w scriptout" argument changed *scriptout-changed*
|
|
|
74 -------------------------------
|
|
|
75
|
|
|
76 "vim -w scriptout" used to append to the scriptout file. Since this was
|
|
|
77 illogical, it now creates a new file. An existing file is not overwritten
|
|
|
78 (to avoid destroying an existing file for those who rely on the appending).
|
|
|
79 [This was removed again later] |-w|
|
|
|
80
|
|
|
81
|
|
|
82 Backspace and Delete keys *backspace-delete*
|
|
|
83 -------------------------
|
|
|
84
|
|
|
85 In 3.0 both the delete key and the backspace key worked as a backspace in
|
|
|
86 insert mode; they deleted the character to the left of the cursor. In 4.0 the
|
|
|
87 delete key has a new function: it deletes the character under the cursor, just
|
|
|
88 like it does on the command-line. If the cursor is after the end of the line
|
|
|
89 and 'bs' is set, two lines are joined. |<Del>| |i_<Del>|
|
|
|
90
|
|
|
91 In 3.0 the backspace key was always defined as CTRL-H and delete as CTRL-?.
|
|
|
92 In 4.0 the code for the backspace and delete key is obtained from termcap or
|
|
|
93 termlib, and adjusted for the "stty erase" value on Unix. This helps people
|
|
|
94 who define the erase character according to the keyboard they are working on.
|
|
|
95 |<BS>| |i_<BS>|
|
|
|
96
|
|
|
97 If you prefer backspace and delete in Insert mode to have the old behavior,
|
|
|
98 put this line in your vimrc:
|
|
|
99
|
|
|
100 inoremap ^? ^H
|
|
|
101
|
|
|
102 And you may also want to add these, to fix the values for <BS> and <Del>:
|
|
|
103
|
|
|
104 set t_kb=^H
|
|
|
105 set t_kD=^?
|
|
|
106
|
|
|
107 (Enter ^H with CTRL-V CTRL-H and ^? with CTRL-V CTRL-? or <Del>.)
|
|
|
108
|
|
|
109 If the value for t_kb is correct, but the t_kD value is not, use the ":fixdel"
|
|
|
110 command. It will set t_kD according to the value of t_kb. This is useful if
|
|
|
111 you are using several different terminals. |:fixdel|
|
|
|
112
|
|
|
113 When ^H is not recognized as <BS> or <Del>, it is used like a backspace.
|
|
|
114
|
|
|
115
|
|
|
116 Escape for | changed *escape-bar*
|
|
|
117 --------------------
|
|
|
118
|
|
|
119 When the 'b' flag is present in 'cpoptions', the backslash cannot be used to
|
|
|
120 escape '|' in mapping and abbreviate commands, only CTRL-V can. This is
|
|
|
121 Vi-compatible. If you work in Vi-compatible mode and had used "\|" to include
|
|
|
122 a bar in a mapping, this needs to be replaced by "^V|". See |:bar|.
|
|
|
123
|
|
|
124
|
|
|
125 Key codes changed *key-codes-changed*
|
|
|
126 -----------------
|
|
|
127
|
|
|
128 The internal representation of key codes has changed dramatically. In 3.0 a
|
|
|
129 one-byte code was used to represent a key. This caused problems with
|
|
|
130 different characters sets that also used these codes. In 4.0 a three-byte
|
|
|
131 code is used that cannot be confused with a character. |key-notation|
|
|
|
132
|
|
|
133 If you have used the single-byte key codes in your vimrc for mappings, you
|
|
|
134 will have to replace them with the 4.0 codes. Instead of using the three-byte
|
|
|
135 code directly, you should use the symbolic representation for this in <>. See
|
|
|
136 the table below. The table also lists the old name, as it was used in the 3.0
|
|
|
137 documentation.
|
|
|
138
|
|
|
139 The key names in <> can be used in mappings directly. This makes it possible
|
|
|
140 to copy/paste examples or type them literally. The <> notation has been
|
|
|
141 introduced for this |<>|. The 'B' and '<' flags must not be present in
|
|
|
142 'cpoptions' to enable this to work |'cpoptions'|.
|
|
|
143
|
|
|
144 old name new name old code old MS-DOS code ~
|
|
|
145 hex dec hex dec ~
|
|
|
146 <ESC> <Esc>
|
|
|
147 <TAB> <Tab>
|
|
|
148 <LF> <NL> <NewLine> <LineFeed>
|
|
|
149 <SPACE> <Space>
|
|
|
150 <NUL> <Nul>
|
|
|
151 <BELL> <Bell>
|
|
|
152 <BS> <BS> <BackSpace>
|
|
|
153 <INSERT> <Insert>
|
|
|
154 <DEL> <Del> <Delete>
|
|
|
155 <HOME> <Home>
|
|
|
156 <END> <End>
|
|
|
157 <PAGE_UP> <PageUp>
|
|
|
158 <PAGE_DOWN> <PageDown>
|
|
|
159
|
|
|
160 <C_UP> <Up> 0x80 128 0xb0 176
|
|
|
161 <C_DOWN> <Down> 0x81 129 0xb1 177
|
|
|
162 <C_LEFT> <Left> 0x82 130 0xb2 178
|
|
|
163 <C_RIGHT> <Right> 0x83 131 0xb3 179
|
|
|
164 <SC_UP> <S-Up> 0x84 132 0xb4 180
|
|
|
165 <SC_DOWN> <S-Down> 0x85 133 0xb5 181
|
|
|
166 <SC_LEFT> <S-Left> 0x86 134 0xb6 182
|
|
|
167 <SC_RIGHT> <S-Right> 0x87 135 0xb7 183
|
|
|
168
|
|
|
169 <F1> <F1> 0x88 136 0xb8 184
|
|
|
170 <F2> <F2> 0x89 137 0xb9 185
|
|
|
171 <F3> <F3> 0x8a 138 0xba 186
|
|
|
172 <F4> <F4> 0x8b 139 0xbb 187
|
|
|
173 <F5> <F5> 0x8c 140 0xbc 188
|
|
|
174 <F6> <F6> 0x8d 141 0xbd 189
|
|
|
175 <F7> <F7> 0x8e 142 0xbe 190
|
|
|
176 <F8> <F8> 0x8f 143 0xbf 191
|
|
|
177 <F9> <F9> 0x90 144 0xc0 192
|
|
|
178 <F10> <F10> 0x91 145 0xc1 193
|
|
|
179
|
|
|
180 <SF1> <S-F1> 0x92 146 0xc2 194
|
|
|
181 <SF2> <S-F2> 0x93 147 0xc3 195
|
|
|
182 <SF3> <S-F3> 0x94 148 0xc4 196
|
|
|
183 <SF4> <S-F4> 0x95 149 0xc5 197
|
|
|
184 <SF5> <S-F5> 0x96 150 0xc6 198
|
|
|
185 <SF6> <S-F6> 0x97 151 0xc7 199
|
|
|
186 <SF7> <S-F7> 0x98 152 0xc8 200
|
|
|
187 <SF8> <S-F8> 0x99 153 0xc9 201
|
|
|
188 <SF9> <S-F9> 0x9a 154 0xca 202
|
|
|
189 <SF10> <S-F10> 0x9b 155 0xcb 203
|
|
|
190
|
|
|
191 <HELP> <Help> 0x9c 156 0xcc 204
|
|
|
192 <UNDO> <Undo> 0x9d 157 0xcd 205
|
|
|
193
|
|
|
194 (not used) 0x9e 158 0xce 206
|
|
|
195 (not used) 0x9f 159 0xcf 207
|
|
|
196
|
|
|
197
|
|
|
198 Terminal options changed *termcap-changed*
|
|
|
199 ------------------------
|
|
|
200
|
|
|
201 The names of the terminal options have been changed to match the termcap names
|
|
|
202 of these options. All terminal options now have the name t_xx, where xx is
|
|
|
203 the termcap name. Normally these options are not used, unless you have a
|
|
|
204 termcap entry that is wrong or incomplete, or you have set the highlight
|
|
|
205 options to a different value. |terminal-options|
|
|
|
206
|
|
|
207 Note that for some keys there is no termcap name. Use the <> type of name
|
|
|
208 instead, which is a good idea anyway.
|
|
|
209
|
|
|
210 Note that "t_ti" has become "t_mr" (invert/reverse output) and "t_ts" has
|
|
|
211 become "t_ti" (init terminal mode). Be careful when you use "t_ti"!
|
|
|
212
|
|
|
213 old name new name meaning ~
|
|
|
214 t_cdl t_DL delete number of lines *t_cdl*
|
|
|
215 t_ci t_vi cursor invisible *t_ci*
|
|
|
216 t_cil t_AL insert number of lines *t_cil*
|
|
|
217 t_cm t_cm move cursor
|
|
|
218 t_cri t_RI cursor number of chars right *t_cri*
|
|
|
219 t_cv t_ve cursor visible *t_cv*
|
|
|
220 t_cvv t_vs cursor very visible *t_cvv*
|
|
|
221 t_dl t_dl delete line
|
|
|
222 t_cs t_cs scroll region
|
|
|
223 t_ed t_cl clear display *t_ed*
|
|
|
224 t_el t_ce clear line *t_el*
|
|
|
225 t_il t_al insert line *t_il*
|
|
|
226 t_da display may be retained above the screen
|
|
|
227 t_db display may be retained below the screen
|
|
|
228 t_ke t_ke put terminal out of keypad transmit mode
|
|
|
229 t_ks t_ks put terminal in keypad transmit mode
|
|
|
230 t_ms t_ms save to move cursor in highlight mode
|
|
|
231 t_se t_se normal mode (undo t_so)
|
|
|
232 t_so t_so shift out (standout) mode
|
|
|
233 t_ti t_mr reverse highlight
|
|
|
234 t_tb t_md bold mode *t_tb*
|
|
|
235 t_tp t_me highlight end *t_tp*
|
|
|
236 t_sr t_sr scroll reverse
|
|
|
237 t_te t_te out of termcap mode
|
|
|
238 t_ts t_ti into termcap mode *t_ts_old*
|
|
|
239 t_vb t_vb visual bell
|
|
|
240 t_csc t_CS cursor is relative to scroll region *t_csc*
|
|
|
241
|
|
|
242 t_ku t_ku <Up> arrow up
|
|
|
243 t_kd t_kd <Down> arrow down
|
|
|
244 t_kr t_kr <Right> arrow right
|
|
|
245 t_kl t_kl <Left> arrow left
|
|
|
246 t_sku <S-Up> shifted arrow up *t_sku*
|
|
|
247 t_skd <S-Down> shifted arrow down *t_skd*
|
|
|
248 t_skr t_%i <S-Right> shifted arrow right *t_skr*
|
|
|
249 t_skl t_#4 <S-Left> shifted arrow left *t_skl*
|
|
|
250 t_f1 t_k1 <F1> function key 1 *t_f1*
|
|
|
251 t_f2 t_k2 <F2> function key 2 *t_f2*
|
|
|
252 t_f3 t_k3 <F3> function key 3 *t_f3*
|
|
|
253 t_f4 t_k4 <F4> function key 4 *t_f4*
|
|
|
254 t_f5 t_k5 <F5> function key 5 *t_f5*
|
|
|
255 t_f6 t_k6 <F6> function key 6 *t_f6*
|
|
|
256 t_f7 t_k7 <F7> function key 7 *t_f7*
|
|
|
257 t_f8 t_k8 <F8> function key 8 *t_f8*
|
|
|
258 t_f9 t_k9 <F9> function key 9 *t_f9*
|
|
|
259 t_f10 t_k; <F10> function key 10 *t_f10*
|
|
|
260 t_sf1 <S-F1> shifted function key 1 *t_sf1*
|
|
|
261 t_sf2 <S-F2> shifted function key 2 *t_sf2*
|
|
|
262 t_sf3 <S-F3> shifted function key 3 *t_sf3*
|
|
|
263 t_sf4 <S-F4> shifted function key 4 *t_sf4*
|
|
|
264 t_sf5 <S-F5> shifted function key 5 *t_sf5*
|
|
|
265 t_sf6 <S-F6> shifted function key 6 *t_sf6*
|
|
|
266 t_sf7 <S-F7> shifted function key 7 *t_sf7*
|
|
|
267 t_sf8 <S-F8> shifted function key 8 *t_sf8*
|
|
|
268 t_sf9 <S-F9> shifted function key 9 *t_sf9*
|
|
|
269 t_sf10 <S-F10> shifted function key 10 *t_sf10*
|
|
|
270 t_help t_%1 <Help> help key *t_help*
|
|
|
271 t_undo t_&8 <Undo> undo key *t_undo*
|
|
|
272
|
|
|
273
|
|
|
274 'errorformat' option changed *errorformat-changed*
|
|
|
275 ----------------------------
|
|
|
276
|
|
|
277 'errorformat' can now contain several formats, separated by commas. The first
|
|
|
278 format that matches is used. The default values have been adjusted to catch
|
|
|
279 the most common formats. |errorformat|
|
|
|
280
|
|
|
281 If you have a format that contains a comma, it needs to be preceded with a
|
|
|
282 backslash. Type two backslashes, because the ":set" command will eat one.
|
|
|
283
|
|
|
284
|
|
|
285 'graphic' option gone *graphic-option-gone*
|
|
|
286 ---------------------
|
|
|
287
|
|
|
288 The 'graphic' option was used to make the characters between <~> and 0xa0
|
|
|
289 display directly on the screen. Now the 'isprint' option takes care of this
|
|
|
290 with many more possibilities. The default setting is the same; you only need
|
|
|
291 to look into this if you previously set the 'graphic' option in your vimrc.
|
|
|
292 |'isprint'|
|
|
|
293
|
|
|
294
|
|
|
295 'yankendofline' option gone *ye-option-gone*
|
|
|
296 ---------------------------
|
|
|
297
|
|
|
298 The 'yankendofline' option has been removed. Instead you can just use
|
|
|
299 :map Y y$
|
|
|
300
|
|
|
301
|
|
|
302 'icon' and 'title' default value changed *icon-changed*
|
|
|
303 ----------------------------------------
|
|
|
304
|
|
|
305 The 'title' option is now only set by default if the original title can be
|
|
|
306 restored. Avoids "Thanks for flying Vim" titles. If you want them anyway,
|
|
|
307 put ":set title" in your vimrc. |'title'|
|
|
|
308
|
|
|
309 The default for 'icon' now depends on the possibility of restoring the
|
|
|
310 original value, just like 'title'. If you don't like your icon titles to be
|
|
|
311 changed, add this line to your vimrc: |'icon'|
|
|
|
312 :set noicon
|
|
|
313
|
|
|
314
|
|
|
315 'highlight' option changed *highlight-changed*
|
|
|
316 --------------------------
|
|
|
317
|
|
|
318 The 'i' flag now means italic highlighting, instead of invert. The 'r' flag
|
|
|
319 is used for reverse highlighting, which is what 'i' used to be. Normally you
|
|
|
320 won't see the difference, because italic mode is not supported on most
|
|
|
321 terminals and reverse mode is used as a fallback. |'highlight'|
|
|
|
322
|
|
|
323 When an occasion is not present in 'highlight', use the mode from the default
|
|
|
324 value for 'highlight', instead of reverse mode.
|
|
|
325
|
|
|
326
|
|
|
327 'tildeop' and 'weirdinvert' short names changed *short-name-changed*
|
|
|
328 -----------------------------------------------
|
|
|
329
|
|
|
330 Renamed 'to' (abbreviation for 'tildeop') to 'top'. |'tildeop'|
|
|
|
331 Renamed 'wi' (abbreviation for 'weirdinvert') to 'wiv'. |'weirdinvert'|
|
|
|
332
|
|
|
333 This was done because Vi uses 'wi' as the short name for 'window' and 'to' as
|
|
|
334 the short name for 'timeout'. This means that if you try setting these
|
|
|
335 options, you won't get an error message, but the effect will be different.
|
|
|
336
|
|
|
337
|
|
|
338 Use of "v", "V" and "CTRL-V" in Visual mode *use-visual-cmds*
|
|
|
339 -------------------------------------------
|
|
|
340
|
|
|
341 In Visual mode, "v", "V", and "CTRL-V" used to end Visual mode. Now this
|
|
|
342 happens only if the Visual mode was in the corresponding type. Otherwise the
|
|
|
343 type of Visual mode is changed. Now only ESC can be used in all circumstances
|
|
|
344 to end Visual mode without doing anything. |v_V|
|
|
|
345
|
|
|
346
|
|
|
347 CTRL-B in Insert mode removed *toggle-revins*
|
|
|
348 -----------------------------
|
|
|
349
|
|
|
350 CTRL-B in Insert mode used to toggle the 'revins' option. If you don't know
|
|
|
351 this and accidentally hit CTRL-B, it is very difficult to find out how to undo
|
|
|
352 it. Since hardly anybody uses this feature, it is disabled by default. If
|
|
|
353 you want to use it, define RIGHTLEFT in feature.h before compiling. |'revins'|
|
|
|
354
|
|
14519
|
355 vim:tw=78:ts=8:noet:ft=help:norl:
|
