192
|
1 *version7.txt* For Vim version 7.0aa. Last change: 2005 Mar 07
|
7
|
2
|
|
3
|
|
4 VIM REFERENCE MANUAL by Bram Moolenaar
|
|
5
|
|
6
|
|
7 Welcome to Vim 7! A large number of features has been added. This file
|
|
8 mentions all the new items, changes to existing features and bug fixes
|
141
|
9 compared to Vim 6.x. Use this command to see the version you are using: >
|
|
10 :version
|
7
|
11
|
|
12 See |vi_diff.txt| for an overview of differences between Vi and Vim 7.0.
|
|
13 See |version4.txt| for differences between Vim 3.x and Vim 4.x.
|
|
14 See |version5.txt| for differences between Vim 4.x and Vim 5.x.
|
|
15 See |version6.txt| for differences between Vim 5.x and Vim 6.x.
|
|
16
|
|
17 INCOMPATIBLE CHANGES |incompatible-7|
|
|
18
|
|
19 NEW FEATURES |new-7|
|
|
20
|
116
|
21 Vim script enhancements |new-vim-script|
|
14
|
22 KDE support |new-KDE|
|
36
|
23 Translated manual pages |new-manpage-trans|
|
43
|
24 Internal grep |new-vimgrep|
|
164
|
25 POSIX compatibility |new-posix|
|
192
|
26 Debugger support |new-debug-support|
|
7
|
27 Various new items |new-items-7|
|
|
28
|
|
29 IMPROVEMENTS |improvements-7|
|
|
30
|
|
31 COMPILE TIME CHANGES |compile-changes-7|
|
|
32
|
|
33 BUG FIXES |bug-fixes-7|
|
|
34
|
|
35 ==============================================================================
|
|
36 INCOMPATIBLE CHANGES *incompatible-7*
|
|
37
|
|
38 These changes are incompatible with previous releases. Check this list if you
|
141
|
39 run into a problem when upgrading from Vim 6.x to 7.0.
|
|
40
|
|
41 A ":write file" command no longer resets the 'modified' flag of the buffer,
|
|
42 unless the '+' flag is in 'cpoptions' |cpo-+|. This was illogical, since the
|
|
43 buffer is still modified compared to the original file. And when undoing
|
|
44 all changes the file would actually be marked modified. It does mean that
|
|
45 ":quit" fails now.
|
7
|
46
|
10
|
47 ":helpgrep" now uses a help window to display a match.
|
|
48
|
39
|
49 In an argument list double quotes could be used to include spaces in a file
|
|
50 name. This caused a difference between ":edit" and ":next" for escaping
|
|
51 double quotes and it is incompatible with some versions of Vi.
|
|
52 Command Vim 6.x file name Vim 7.x file name ~
|
|
53 :edit foo\"888 'foo"888' 'foo"888'
|
|
54 :next foo\"888 'foo888' 'foo"888'
|
|
55 :next a\"b c\"d 'ab cd' 'a"b' and 'c"d'
|
|
56
|
100
|
57 In a |literal-string| a single quote can be doubled to get one.
|
|
58 ":echo 'a''b'" would result in "a b", but now that two quotes stand for one it
|
|
59 results in "a'b".
|
|
60
|
10
|
61
|
|
62 Minor incompatibilities:
|
|
63
|
|
64 For filetype detection: For many types, instead of ~/.dir/filename use
|
|
65 */.dir/filename, so that it also works for other user's files.
|
|
66
|
|
67 ":0verbose" now sets 'verbose' to zero instead of one.
|
|
68
|
|
69 Removed the old and incomplete "VimBuddy" code.
|
|
70
|
|
71 Buffers without a name report "No Name" instead of "No File". It was
|
|
72 confusing for buffers with a name and 'buftype' set to "nofile".
|
7
|
73
|
29
|
74 When ":file xxx" is used in a buffer without a name, the alternate file name
|
|
75 isn't set. This avoids creating buffers without a name that are not useful.
|
|
76
|
|
77 The "2html.vim" script now converts closed folds to HTML. This means the HTML
|
|
78 looks like its displayed, with the same folds open and closed. Use "zR" if no
|
|
79 folds should appear in the HTML. (partly by Carl Osterwisch)
|
32
|
80 Diff mode now is also converted as it is displayed.
|
29
|
81
|
36
|
82 Win32: The effect of the <F10> key depended on 'winaltkeys'. Now it depends
|
|
83 on whether <F10> has been mapped or not. This allows mapping <F10> without
|
|
84 changing 'winaltkeys'.
|
|
85
|
100
|
86 When 'octal' is in 'nrformats' and using CTRL-A on "08" it became "018", which
|
|
87 is illogical. Now it becomes "9". The leading zero(s) is(are) removed to
|
|
88 avoid the number becoming octal after incrementing "009" to "010".
|
39
|
89
|
|
90 When 'encoding' is set to a Unicode encoding, the value for 'fileencodings'
|
|
91 now includes "default" before "latin1". This means that for files with 8-bit
|
|
92 encodings the default is to use the encoding specified by the environment, if
|
|
93 possible. Previously latin1 would always be used, which is wrong in a
|
|
94 non-latin1 environment, such as Russian.
|
|
95
|
149
|
96 Previously Vim would exit when there are two windows, both of them displaying
|
|
97 a help file, and using ":quit". Now only the window is closed.
|
|
98
|
164
|
99 "-w {scriptout}" only works when {scriptout} doesn't start with a digit.
|
|
100 Otherwise it's used to set the 'window' option.
|
|
101
|
181
|
102 Previously <Home> and <xHome> could be mapped separately. This had the
|
|
103 disadvantage that all mappings (with modifiers) had to be duplicated, since
|
|
104 you can't be sure what the keyboard generates. Now all <xHome> are internally
|
|
105 translated to <Home>, both for the keys and for mappings. Also for <xEnd>,
|
|
106 <xF1>, etc.
|
|
107
|
7
|
108 ==============================================================================
|
|
109 NEW FEATURES *new-7*
|
|
110
|
116
|
111 Vim script enhancements *new-vim-script*
|
|
112 -----------------------
|
7
|
113
|
|
114 In Vim scripts the following types have been added:
|
|
115
|
97
|
116 List ordered list of items |List|
|
|
117 Dictionary associative array of items |Dictionary|
|
|
118 Funcref reference to a function |Funcref|
|
7
|
119
|
|
120 Many functions and commands have been added to support the new types.
|
|
121
|
97
|
122 The |string()| function can be used to get a string representation of a
|
|
123 variable. Works for Numbers, Strings and composites of them. Then |eval()|
|
|
124 can be used to turn the string back into the variable value.
|
|
125
|
116
|
126 The |:let| command can now use ":let var += expr" like using ":let var = var +
|
|
127 expr". "-=" and ".=" works in a similar way.
|
|
128
|
175
|
129 With the |:profile| command you can find out where your function or script
|
|
130 wastes its time.
|
|
131
|
11
|
132
|
14
|
133 KDE support *new-KDE*
|
11
|
134 -----------
|
|
135
|
|
136 Kvim is the KDE version of Vim. It uses the Qt toolkit. See |KVim|.
|
|
137 (Thomas Capricelli, Philippe Fremy, Mickael Marchand, Mark Westcott, et al.)
|
|
138
|
7
|
139
|
14
|
140 MzScheme interface *new-MzScheme*
|
|
141 ------------------
|
|
142
|
|
143 The MzScheme interpreter is supported. |MzScheme|
|
|
144 The |:mzscheme| command can be used to execute MzScheme commands.
|
|
145 The |:mzfile| command can be used to execute an MzScheme script file.
|
|
146
|
97
|
147
|
15
|
148 Printing multi-byte text *new-print-multi-byte*
|
|
149 ------------------
|
|
150
|
|
151 The |:hardcopy| command now supports printing multi-byte characters.
|
|
152 The 'printmbcharset' and 'printmbfont' options are used for this.
|
|
153 Also see |postscript-cjk-printing|. (Mike Williams)
|
|
154
|
14
|
155
|
36
|
156 Translated manual pages *new-manpage-trans*
|
|
157 -----------------------
|
|
158
|
|
159 The manual page of Vim and associated programs is now also available in
|
|
160 Italian (translated by Antonio Colombo). More languages will follow.
|
|
161
|
40
|
162 The Unix Makefile installs the Italian manual pages in .../man/it/man1/.
|
|
163
|
36
|
164
|
43
|
165 Internal grep *new-vimgrep*
|
|
166 -------------
|
|
167
|
|
168 The ":vimgrep" command can be used to search for a pattern in a list of files.
|
|
169 This is like the ":grep" command, but no external program is used. Besides
|
|
170 better portability, handling of different file encodings and using multi-line
|
|
171 patterns, this also allows grepping in compressed and remote files.
|
|
172 |:vimgrep|.
|
|
173
|
170
|
174 If you want to use the search results in a script you can use the
|
|
175 |errorlist()| function.
|
|
176
|
43
|
177
|
164
|
178 POSIX compatibility *new-posix*
|
|
179 -------------------
|
|
180
|
|
181 The POSIX test suite was used to verify POSIX compatibility. A number of
|
|
182 problems have been fixed to make Vim more POSIX compatible. Some of them
|
|
183 conflict with traditional Vi or expected behavior. The $VIM_POSIX environment
|
|
184 variable can be set to get POSIX compatibility. See |posix|.
|
|
185
|
|
186 Items that were fixed for both Vi and POSIX compatibilty:
|
|
187 - repeating "R" with a count only overwrites text once; added the 'X' flag to
|
|
188 'cpoptions' |cpo-X|
|
|
189 - a vertical movement command that moves to a non-existing line fails; added
|
|
190 the '-' flag to 'cpoptions' |cpo--|
|
|
191 - when preserving a file and doing ":q!" the file can be recovered; added the
|
|
192 '&' flag to 'cpoptions' |cpo-&|
|
|
193 - The 'window' option is partly implemented. It specifies how much CTRL-F and
|
|
194 CTRL-B scroll when there is one window. The "-w {number}" argument is now
|
|
195 accepted. "-w {scriptout}" only works when {scriptout} doesn't start with a
|
|
196 digit.
|
|
197 - Allow "-c{command}" argument, no space between "-c" and {command}.
|
|
198 - When writing a file with ":w!" don't reset 'readonly' when 'Z' is present in
|
|
199 'cpoptions'.
|
169
|
200 - Allow 'l' and '#' flags for ":list", ":print" and ":number".
|
|
201 - Added the '.' flag to 'cpoptions': ":cd" fails when the buffer is modified.
|
|
202 - In Ex mode with an empty buffer ":read file" doesn't keep an empty line
|
|
203 above or below the new lines.
|
|
204 - Remove a backslash before a NL for the ":global" command.
|
|
205 - When ":append", ":insert" or ":change" is used with ":global", get the
|
|
206 inserted lines from the command. Can use backslash-NL to separate lines.
|
|
207 - Can use ":global /pat/ visual" to execute Normal mode commands at each
|
|
208 matched line. Use "Q" to continue and go to the next line.
|
|
209 - The |:open| command has been partially implemented. It stops Ex mode, but
|
|
210 redraws the whole screen, not just one line as open mode is supposed to do.
|
|
211 - Support using a pipe to read the output from and write input to an external
|
|
212 command. Added the 'shelltemp' option and has("filterpipe").
|
|
213 - In ex silent mode the ":set" command output is displayed.
|
|
214 - The ":@@" and ":**" give an error message when no register was used before.
|
|
215 - The search pattern "[]-`]" matches ']', '^', '_' and '`'.
|
|
216 - Autoindent for ":insert" is using the line below the insert.
|
|
217 - Autoindent for ":change" is using the first changed line.
|
|
218 - Editing Ex command lines is not done in cooked mode, because CTRL-D and
|
|
219 CTRL-T cannot be handled then.
|
|
220 - In Ex mode, "1,3" prints three lines.
|
|
221 - Implemented the 'prompt' option.
|
164
|
222
|
|
223
|
192
|
224 Debugger support *new-debug-support*
|
|
225 ----------------
|
|
226
|
|
227 The 'balloonexpr' option has been added. This is a generic way to implement
|
|
228 balloon functionality. You can use it to show info for the word under the
|
|
229 mouse pointer.
|
|
230
|
|
231
|
7
|
232 Various new items *new-items-7*
|
|
233 -----------------
|
|
234
|
|
235 Normal mode commands: ~
|
|
236
|
12
|
237 a", a' and a` New text objects to select quoted strings. |a'|
|
|
238 i", i' and i' (Taro Muraoka)
|
7
|
239
|
170
|
240 CTRL-W <Enter> In the quickfix window: opens a new window to show the
|
|
241 location of the error under the cursor.
|
|
242
|
7
|
243 Options: ~
|
|
244
|
12
|
245 'completefunc' The name of a function used for user-specified Insert
|
|
246 mode completion. CTRL-X CTRL-U can be used in Insert
|
|
247 mode to do any kind of completion. (Taro Muraoka)
|
|
248 'quoteescape' Characters used to escape quotes inside a string.
|
|
249 Used for the a", a' and a` text objects. |a'|
|
13
|
250 'numberwidth' Minimal width of the space used for the 'number'
|
|
251 option. (Emmanuel Renieris)
|
14
|
252 'mzquantum' Time in msec to schedule MzScheme threads.
|
15
|
253 'printmbcharset' CJK character set to be used for :hardcopy
|
|
254 'printmbfont' font names to be used for CJK output of :hardcopy
|
36
|
255 'fsync' Whether fsync() is called after writing a file.
|
|
256 (Ciaran McCreesh)
|
40
|
257 'wildoptions' "tagfile" value enables listing the file name of
|
|
258 matching tags for CTRL-D command line completion.
|
|
259 (based on an idea from Yegappan Lakshmanan)
|
41
|
260 'formatlistpat' pattern to recognize a numbered list for formatting.
|
|
261 (idea by Hugo Haas)
|
|
262
|
7
|
263
|
|
264 Ex commands: ~
|
|
265
|
11
|
266 Win32: The ":winpos" command now also works in the console. (Vipin Aravind)
|
|
267
|
15
|
268 |:startreplace| Start Replace mode. (Charles Campbell)
|
14
|
269
|
15
|
270 |:0file| Removes the name of the buffer. (Charles Campbell)
|
14
|
271
|
16
|
272 |:diffoff| Switch off diff mode in the current window or in all
|
|
273 windows.
|
|
274
|
22
|
275 |:keepalt| Do not change the alternate file.
|
|
276
|
24
|
277 |:delmarks| Delete marks.
|
|
278
|
29
|
279 |:sandbox| Command modifier: execute the argument in the sandbox.
|
|
280
|
40
|
281 |:exusage| Help for Ex commands (Nvi command).
|
|
282
|
|
283 |:viusage| Help for Vi commands (Nvi command).
|
|
284
|
41
|
285 |:cbuffer| Read error lines from a buffer. (partly by Yegappan
|
|
286 Lakshmanan)
|
7
|
287
|
|
288 New functions: ~
|
|
289
|
116
|
290 |add()| append an item to a List
|
|
291 |append()| append List of lines to the buffer
|
|
292 |browsedir()| Dialog to select a directory.
|
|
293 |byteidx()| Index of a character. (Ilya Sher)
|
|
294 |call()| call a function with List as arguments
|
|
295 |copy()| make a shallow copy of a List or Dictionary
|
|
296 |count()| count nr of times a value is in a List or Dictionary
|
|
297 |deepcopy()| make a full copy of a List or Dictionary
|
|
298 |empty()| check if List or Dictionary is empty
|
170
|
299 |errorlist()| list of quickfix errors
|
116
|
300 |extend()| append one List to another or add items from one
|
|
301 Dictionary to another
|
|
302 |filter()| remove selected items from a List or Dictionary
|
|
303 |finddir()| Find a directory in 'path'.
|
|
304 |findfile()| Find a file in 'path'. (Johannes Zellner)
|
|
305 |foldtextresult()| The text displayed for a closed fold at line "lnum".
|
|
306 |function()| make a Funcref out of a function name
|
|
307 |get()| get an item from a List or Dictionary
|
|
308 |getfontname()| Get actual font name being used.
|
|
309 |getfperm()| Get file permission string. (Nikolai Weibull)
|
|
310 |getftype()| Get type of file. (Nikolai Weibull)
|
170
|
311 |getline()| With second argument: get List with buffer lines
|
116
|
312 |has_key()| check whether a key appears in a Dictionary
|
|
313 |insert()| insert an item somewhere in a List
|
|
314 |items()| get List of Dictionary key-value pairs
|
|
315 |join()| join List items into a String
|
|
316 |keys()| get List of Dictionary keys
|
|
317 |len()| number of items in a List or Dictionary
|
|
318 |map()| change each List or Dictionary item
|
159
|
319 |matchlist()| list with match and submatches of a pattern in a string
|
116
|
320 |max()| maximum value in a List or Dictionary
|
|
321 |min()| minimum value in a List or Dictionary
|
169
|
322 |mkdir()| create a directory
|
159
|
323 |readfile()| read a file into a list of lines
|
116
|
324 |remove()| remove one or more items from a List or Dictionary
|
|
325 |repeat()| Repeat "expr" "count" times. (Christophe Poucet)
|
|
326 |reverse()| reverse the order of a List
|
|
327 |sort()| sort a List
|
|
328 |split()| split a String into a List
|
|
329 |string()| String representation of a List or Dictionary
|
|
330 |system()| Filters {input} through a shell command.
|
|
331 |tr()| Translate characters. (Ron Aaron)
|
|
332 |values()| get List of Dictionary values
|
159
|
333 |writefile()| write a list of lines into a file
|
15
|
334
|
162
|
335 User defined functions can now be loaded automatically from the "autoload"
|
|
336 directory in 'runtimepath'. See |autoload-functions|.
|
|
337
|
7
|
338
|
|
339 New autocommand events: ~
|
|
340
|
15
|
341 |InsertEnter| starting Insert or Replace mode
|
|
342 |InsertChange| going from Insert to Replace mode or back
|
|
343 |InsertLeave| leaving Insert or Replace mode
|
11
|
344
|
15
|
345 |ColorScheme| after loading a color scheme
|
162
|
346 |QuickFixCmdPre| before :make, :grep et al. (Ciaran McCreesh)
|
|
347 |QuickFixCmdPost| after :make, :grep et al. (Ciaran McCreesh)
|
7
|
348
|
12
|
349
|
24
|
350 New items in search patterns: ~
|
|
351 |/\%d| \%d123 search for character with decimal number
|
|
352 |/\]| [\d123] idem, in a colletion
|
|
353 |/\%o| \%o103 search for character with octal number
|
|
354 |/\]| [\o1o3] idem, in a colletion
|
|
355 |/\%x| \%x1a search for character with 2 pos. hex number
|
|
356 |/\]| [\x1a] idem, in a colletion
|
|
357 |/\%u| \%u12ab search for character with 4 pos. hex number
|
|
358 |/\]| [\u12ab] idem, in a colletion
|
|
359 |/\%U| \%U1234abcd search for character with 8 pos. hex number
|
|
360 |/\]| [\U1234abcd] idem, in a colletion
|
|
361 (The above partly by Ciaran McCreesh)
|
169
|
362 |/[=| [[=a=]] an equivalence class (only for latin1 characters)
|
|
363 |/[.| [[.a.]] a collation element (only works with single char)
|
|
364
|
|
365 Nesting |/multi| items no longer is an error when an empty match is possible.
|
|
366
|
|
367 It is now possible to use \{0}, it matches the preceding atom zero times. Not
|
|
368 useful, just for compatibility.
|
24
|
369
|
|
370
|
12
|
371 New Syntax/Indent/FTplugin files: ~
|
|
372
|
|
373 MuPAD source syntax, indent and ftplugin. (Dave Silvia)
|
|
374
|
22
|
375 ABAB/4 syntax file. (Marius van Wyk)
|
|
376
|
|
377 SQL-Informix syntax file. (Dean L Hill)
|
|
378
|
23
|
379 PHP compiler plugin. (Doug Kearns)
|
|
380
|
36
|
381 Sive syntax file. (Nikolai Weibull)
|
|
382
|
23
|
383
|
32
|
384 New Keymaps: ~
|
|
385
|
|
386 Sinhala (Sri Lanka) (Harshula Jayasuriya)
|
|
387
|
|
388
|
23
|
389 New message translations: ~
|
|
390
|
|
391 The Ukranian messages are now also available in cp1251.
|
|
392
|
169
|
393 Irish message translations. (Kevin Patrick Scannell)
|
|
394
|
170
|
395 Vietnamese message translations and menu. (Phan Vinh Thinh)
|
|
396
|
7
|
397
|
10
|
398 Others: ~
|
|
399
|
|
400 Mac: Add the selection type to the clipboard, so that Block, line and
|
|
401 character selections can be used between two Vims. (Eckehard Berns)
|
|
402 Also fixes the problem that setting 'clipboard' to "unnamed" breaks using
|
|
403 "yyp".
|
7
|
404
|
13
|
405 Mac: GUI font selector. (Peter "Rain Dog" Cucka)
|
|
406
|
169
|
407 Mac: support for multi-byte characters. (Da Woon Jung)
|
|
408
|
69
|
409 GUI font selector for Motif. (Marcin Dalecki)
|
46
|
410
|
162
|
411 Nicer toolbar buttons for Motif. (Marcin Dalecki)
|
|
412
|
69
|
413 Mnemonics for the Motif find/replace dialog. (Marcin Dalecki)
|
46
|
414
|
38
|
415 Mac: better integration with Xcode. Post a fake mouse-up event after the odoc
|
|
416 event and the drag receive handler to work around a stall after Vim loads a
|
|
417 file. Fixed an off-by-one line number error. (Da Woon Jung)
|
|
418
|
11
|
419 The netrw plugin now also supports viewing a directory, when "scp://" is used.
|
|
420 Deleting and renaming files is possible. (Charles Campbell)
|
|
421
|
36
|
422 Added the t_SI and t_EI escape sequences for starting and ending Insert mode.
|
|
423 To be used to set the cursor shape to a bar or a block. No default values,
|
|
424 they are not supported by termcap/terminfo.
|
|
425
|
40
|
426 Autocommands can be defined local to a buffer. This means they will also work
|
|
427 when the buffer does not have a name or no specific name. See
|
|
428 |autocmd-buflocal|. (Yakov Lerner)
|
|
429
|
179
|
430 For xterm most combinations of modifiers with function keys are recognized.
|
|
431 |xterm-modifier-keys|
|
|
432
|
7
|
433 ==============================================================================
|
|
434 IMPROVEMENTS *improvements-7*
|
|
435
|
10
|
436 ":helpgrep" accepts a language specifier after the pattern: "pat@it".
|
|
437
|
15
|
438 Move the help for printing to a separate help file. It's quite a lot now.
|
|
439
|
181
|
440 The pattern matching code was changed from a recursive function to an
|
|
441 iterative mechanism. This avoids out-of-stack errors. State is stored in
|
|
442 allocated memory, running out of memory can always be detected. Allows
|
|
443 matching more complex things, but Vim may seem to hang while doing that.
|
|
444
|
10
|
445 ":breakadd here" and ":breakdel here" can be used to set or delete a
|
|
446 breakpoint at the cursor.
|
|
447
|
11
|
448 The tutor was updated to make it simpler to use and added text to explain a
|
|
449 few more important commands. Used ideas from Gabriel Zachmann.
|
7
|
450
|
12
|
451 Unix: When libcall() fails obtain an error message with dlerror() and display
|
|
452 it. (Johannes Zellner)
|
|
453
|
13
|
454 Added "nbsp" in 'listchars'. (David Blanchet)
|
|
455
|
17
|
456 Added the "acwrite" value for the 'buftype' option. This is for a buffer that
|
|
457 doesn not have a name that refers to a file and is written with BufWriteCmd
|
|
458 autocommands.
|
|
459
|
14
|
460 For lisp indenting and matching parenthesis: (Sergey Khorev)
|
|
461 - square brackets are recognized properly
|
|
462 - #\(, #\), #\[ and #\] are recognized as character literals
|
|
463 - Lisp line comments (delimited by semicolon) are recognized
|
|
464
|
19
|
465 Added the "count" argument to match(), matchend() and matchstr(). (Ilya Sher)
|
|
466
|
20
|
467 winnr() takes an optional "$" and "#" arguments. (Nikolai Weibull, Yegappan
|
|
468 Lakshmanan)
|
|
469
|
|
470 Added 'n' flag to search(): don't move the cursor. (Nikolai Weibull)
|
|
471
|
22
|
472 When uncompressing fails in the gzip plugin, give an error message but don't
|
|
473 delete the raw text. Helps if the file has a .gz extension but is not
|
|
474 actually compressed. (Andrew Pimlott)
|
|
475
|
|
476 When C, C++ or IDL syntax is used, may additionally load doxygen syntax.
|
|
477 Also support setting the filetype to "cdoxygen" for C plus doxygen syntax.
|
|
478 (Michael Geddes)
|
|
479
|
|
480 The ":registers" command now displays multi-byte characters properly.
|
|
481
|
|
482 VMS: In the usage message mention that a slash can be used to make a flag
|
|
483 upper case. Add color support to the builtin vt320 terminal codes.
|
|
484 (Zoltan Arpadffy)
|
|
485
|
23
|
486 For the '%' item in 'viminfo', allow a number to set a maximum for the number
|
|
487 of buffers.
|
|
488
|
40
|
489 The 'statusline' option can be local to the window, so that each window can
|
|
490 have a different value. (partly by Yegappan Lakshmanan)
|
|
491
|
26
|
492 When a file looks like a shell script, check for an "exec" command that starts
|
|
493 the tcl interpreter. (suggested by Alexios Zavras)
|
|
494
|
|
495 Support conversion between utf-8 and latin9 (iso-8859-15) internally, so that
|
|
496 digraphs still work when iconv is not available.
|
|
497
|
36
|
498 When a session file is loaded while editing an unnamed, empty buffer that
|
|
499 buffer is wiped out. Avoids that there is an unused buffer in the buffer
|
|
500 list.
|
|
501
|
|
502 Win32: When libintl.dll supports bind_textdomain_codeset(), use it.
|
|
503 (NAKADAIRA Yukihiro)
|
|
504
|
|
505 When foldtext() finds no text after removing the comment leader, use the
|
|
506 second line of the fold. Helps for C-style /* */ comments where the first
|
|
507 line is just "/*".
|
|
508
|
39
|
509 When editing the same file from two systems (e.g., Unix and MS-Windows) there
|
|
510 mostly was no warning for an existing swap file, because the name of the
|
|
511 edited file differs (e.g., y:\dir\file vs /home/me/dir/file). Added a flag to
|
|
512 the swap file to indicate it is in the same directory as the edited file. The
|
|
513 used path then doesn't matter and the check for editing the same file is much
|
|
514 more reliable.
|
|
515
|
|
516 Client-server communication now supports 'encoding'. When setting 'encoding'
|
|
517 in a Vim server to "utf-8", and using "vim --remote fname" in a console,
|
|
518 "fname" is converted from the console encoding to utf-8. Also allows Vims
|
|
519 with different 'encoding' settings to exchange messages.
|
|
520
|
41
|
521 Internal: Changed ga_room into ga_maxlen, so that it doesn't need to be
|
|
522 incremented/decremented each time.
|
|
523
|
69
|
524 Included a few improvements for Motif from Marcin Dalecki. Draw label
|
46
|
525 contents ourselves to make them handle fonts in a way configurable by Vim and
|
|
526 a bit less dependent on the X11 font management.
|
|
527
|
56
|
528 When a register is empty it is not stored in the viminfo file.
|
|
529
|
100
|
530 Removed the tcltags script, it's obsolete.
|
|
531
|
123
|
532 ":redir @*>" and ":redir @+>" append to the clipboard. Better check for
|
169
|
533 invalid characters after the register name. |:redir|
|
|
534
|
|
535 ":redir => variable" and ":redir =>> variable" write or append to a variable.
|
|
536 (Yegappan Lakshmanan) |:redir|
|
123
|
537
|
|
538 ":let g:" lists global variables.
|
|
539 ":let b:" lists buffer-local variables.
|
|
540 ":let w:" lists window-local variables.
|
|
541 ":let v:" lists Vim variables.
|
|
542
|
149
|
543 The stridx() and strridx() functions take a third argument, where to start
|
|
544 searching. (Yegappan Lakshmanan)
|
136
|
545
|
162
|
546 g CTRL-G also shows the number of characters if it differs from the number of
|
|
547 bytes.
|
|
548
|
169
|
549 Completion for ":debug" and entering an expression for the '=' register. Skip
|
|
550 ":" between range and command name. (Peter winters)
|
|
551
|
|
552 CTRL-Q in Insert mode now works like CTRL-V by default. Previously it was
|
|
553 ignored.
|
|
554
|
|
555 When "beep" is included in 'debug' a function or script that causes a beep
|
|
556 will result in a message with the source of the error.
|
|
557
|
170
|
558 When completing buffer names, match with "\(^\|[\/]\)" instead of "^", so that
|
|
559 ":buf stor<Tab>" finds both "include/storage.h" and "storage/main.c".
|
|
560
|
|
561 To count items (pattern matches) without changing the buffer the 'n' flag has
|
|
562 been added to |:substitute|. See |count-items|.
|
|
563
|
175
|
564 The "screen.linux" $TERM name is recognized to set the default for
|
179
|
565 'background' to "dark". (Ciaran McCreesh) Also for "cygwin".
|
|
566
|
|
567 The |FileChangedShell| autocommand event can now use the |v:fcs_reason|
|
|
568 variable that specifies what triggered the event. |v:fcs_choice| can be used
|
|
569 to reload the buffer or ask the user what to do.
|
175
|
570
|
181
|
571 Not all modifiers were recognized for xterm function keys. Added the
|
|
572 possibility in term codes to end in ";*X" or "O*X", where X is any character
|
|
573 and the * stands for the modifier code.
|
|
574 Added the <xUp>, <xDown>, <xLeft> and <xRight> keys, to be able to recognize
|
|
575 the two forms that xterm can send their codes in and still handle all possible
|
|
576 modifiers.
|
|
577
|
7
|
578 ==============================================================================
|
|
579 COMPILE TIME CHANGES *compile-changes-7*
|
|
580
|
69
|
581 Dropped the support for the BeOS and Amiga GUI. They were not maintained and
|
|
582 probably didn't work. If you want to work on this: get the Vim 6.x version
|
|
583 and merge it back in.
|
|
584
|
18
|
585 Mac: "make" now creates the Vim.app directory and "make install" copies it to
|
|
586 its final destination. (Raf)
|
|
587
|
|
588 Mac: Made it possible to compile with Motif, Athena or GTK without tricks and
|
|
589 still being able to use the MacRoman conversion. Added the os_mac_conv.c
|
|
590 file.
|
7
|
591
|
169
|
592 When running the tests and one of them fails to produce "test.out" the
|
|
593 following tests are still executed. This helps when running out of memory.
|
|
594
|
7
|
595 ==============================================================================
|
|
596 BUG FIXES *bug-fixes-7*
|
|
597
|
10
|
598 When using PostScript printing on MS-DOS the default 'printexpr' used "lpr"
|
|
599 instead of "copy". When 'printdevice' was empty the copy command did not
|
|
600 work. Use "LPT1" then.
|
|
601
|
|
602 The GTK font dialog uses a font size zero when the font name doesn't include a
|
|
603 size. Use a default size of 10.
|
|
604
|
|
605 This example in the documentation didn't work:
|
|
606 :e `=foo . ".c" `
|
|
607 Skip over the expression in `=expr` when looking for comments, |, % and #.
|
|
608
|
|
609 When ":helpgrep" doesn't find anything there is no error message.
|
|
610
|
|
611 "L" and "H" did not take closed folds into account.
|
|
612
|
|
613 Win32: The "-P title" argument stopped at the first title that matched, even
|
|
614 when it doesn't support MDI.
|
|
615
|
|
616 Mac GUI: CTRL-^ and CTRL-@ did not work.
|
|
617
|
|
618 "2daw" on "word." at the end of a line didn't include the preceding white
|
|
619 space.
|
|
620
|
|
621 Win32: Using FindExecutable() doesn't work to find a program. Use
|
|
622 SearchPath() instead. For executable() use $PATHEXT when the program searched
|
|
623 for doesn't have an extension.
|
|
624
|
|
625 When 'virtualedit' is set, moving the cursor up after appending a character
|
|
626 may move it to a different column. Was caused by auto-formatting moving the
|
|
627 cursor and not putting it back where it was.
|
|
628
|
|
629 When indent was added automatically and then moving the cursor, the indent was
|
|
630 not deleted (like when pressing ESC). The "I" flag in 'cpoptions' can be used
|
|
631 to make it work the old way.
|
|
632
|
|
633 When opening a command-line window, 'textwidth' gets set to 78 by the Vim
|
|
634 filetype plugin. Reset 'textwidth' to 0 to avoid lines are broken.
|
|
635
|
|
636 After using cursor(line, col) moving up/down doesn't keep the same column.
|
|
637
|
|
638 Win32: Borland C before 5.5 requires using ".u." for LowPart and HighPart
|
|
639 fields. (Walter Briscoe)
|
7
|
640
|
11
|
641 On Sinix SYS_NMLN isn't always defined. Define it ourselves. (Cristiano De
|
|
642 Michele)
|
|
643
|
14
|
644 Printing with PostScript may keep the printer waiting for more. Append a
|
|
645 CTRL-D to the printer output. (Mike Williams)
|
|
646
|
16
|
647 When converting a string with a hex or octal number the leading '-' was
|
|
648 ignored. ":echo '-05' + 0" resulted in 5 instead of -5.
|
|
649
|
|
650 Using "@:" to repeat a command line didn't work when it contains control
|
|
651 characters.
|
|
652
|
17
|
653 When using file completion for a user command, it would not expand environment
|
|
654 variables like for a regular command with a file argument.
|
|
655
|
|
656 'cindent': When the argument of a #define looks like a C++ class the next line
|
|
657 is indented too much.
|
|
658
|
|
659 When 'comments' includes multi-byte characters inserting the middle part and
|
|
660 alignment may go wrong. 'cindent' also suffers from this for right-aligned
|
|
661 items.
|
|
662
|
170
|
663 Win32: when 'encoding' is set to "utf-8" getenv() still returns strings in the
|
|
664 active codepage. Convert to utf-8. Also for $HOME.
|
|
665
|
18
|
666 The default for 'helplang' was "zh" for both "zh_cn" and "zh_tw". Now use
|
|
667 "cn" or "tw" as intended.
|
|
668
|
20
|
669 When 'bin' is set and 'eol' is not set then line2byte() added the line break
|
|
670 after the last line while it's not there.
|
|
671
|
|
672 Using foldlevel() in a WinEnter autocommand may not work. Noticed when
|
|
673 resizing the GUI shell upon startup.
|
|
674
|
|
675 Python: Using buffer.append(f.readlines()) didn't work. Allow appending a
|
|
676 string with a trailing newline. The newline is ignored.
|
|
677
|
21
|
678 When using the ":saveas f2" command for buffer "f1", the Buffers menu would
|
|
679 contain "f2" twice, one of them leading to "f1". Also trigger the BufFilePre
|
|
680 and BufFilePost events for the alternate buffer that gets the old name.
|
|
681
|
22
|
682 strridx() did not work well when the needle is empty. (Ciaran McCreesh)
|
|
683
|
|
684 GTK: Avoid a potential hang in gui_mch_wait_for_chars() when input arrives
|
|
685 just before it is invoked
|
|
686
|
|
687 VMS: Occasionally CR characters were inserted in the file. Expansion of
|
|
688 environment variables was not correct. (Zoltan Arpadffy)
|
|
689
|
|
690 UTF-8: When 'delcombine' is set "dw" only deleted the last combining character
|
|
691 from the first character of the word.
|
|
692
|
|
693 When using ":sball" in an autocommand only the filetype in one buffer was
|
|
694 detected. Reset did_filetype in enter_buffer().
|
|
695
|
|
696 When using ":argdo" and the window already was at the first argument index,
|
|
697 but not actually editing it, the current buffer would be used instead.
|
|
698
|
23
|
699 When ":next dir/*" includes many matches, adding the names to the argument
|
|
700 list may take an awful lot of time and can't be interrupted. Allow
|
|
701 interrupting this.
|
|
702
|
|
703 When editing a file that was already loaded in a buffer, modelines were not
|
|
704 used. Now window-local options in the modeline are set. Buffer-local options
|
|
705 and global options remain unmodified.
|
|
706
|
|
707 Win32: When 'encoding' is set to "utf-8" in the vimrc file, files from the
|
|
708 command line with non-ASCII characters are not used correctly. Recode the
|
|
709 file names when 'encoding' is set, using the Unicode command line.
|
|
710
|
24
|
711 Win32 console: When the default for 'encoding' ends up to be "latin1", the
|
|
712 default value of 'isprint' was wrong.
|
|
713
|
|
714 When an error message is given while waiting for a character (e.g., when an
|
|
715 xterm reports the number of colors), the hit-enter prompt overwrote the last
|
|
716 line. Don't reset msg_didout in normal_cmd() for K_IGNORE.
|
|
717
|
26
|
718 Mac GUI: Shift-Tab didn't work.
|
|
719
|
|
720 When defining tooltip text, don't translate terminal codes, since it's not
|
|
721 going to be used like a command.
|
|
722
|
|
723 GTK 2: Check the tooltip text for valid utf-8 characters to avoid getting a
|
|
724 GTK error. Invalid characters may appear when 'encoding' is changed.
|
|
725
|
|
726 GTK 2: Add a safety check for invalid utf-8 sequences, they can crash pango.
|
|
727
|
|
728 Win32: When 'encoding' is changed while starting up, use the Unicode command
|
|
729 line to convert the file arguments to 'encoding'. Both for the GUI and the
|
|
730 console version.
|
|
731
|
|
732 Win32 GUI: latin9 text (iso-8859-15) was not displayed correctly, because
|
|
733 there is no codepage for latin9. Do our own conversion from latin9 to UCS2.
|
|
734
|
29
|
735 When two versions of GTK+ 2 are installed it was possible to use the header
|
|
736 files from one and the library from the other. Use GTK_LIBDIR to put the
|
|
737 directory for the library early in the link flags.
|
|
738
|
|
739 With the GUI find/replace dialog a replace only worked if the pattern was
|
|
740 literal text. Now it works for any pattern.
|
|
741
|
36
|
742 When 'equalalways' is set and 'eadirection' is "hor", ":quit" would still
|
|
743 cause equalizing window heights in the vertical direction.
|
|
744
|
|
745 When ":emenu" is used in a startup script the command was put in the typeahead
|
|
746 buffer, causing a prompt for the crypt key to be messed up.
|
|
747
|
|
748 Mac OS/X: The default for 'isprint' included characters 128-160, causes
|
|
749 problems for Terminal.app.
|
|
750
|
|
751 When a syntax item with "containedin" is used, it may match in the start or
|
|
752 end of a region with a matchgroup, while this doesn't happen for a "contains"
|
|
753 argument.
|
|
754
|
|
755 When a transparent syntax items matches in another item where the highlighting
|
|
756 has already stopped (because of a he= argument), the highlighting would come
|
|
757 back.
|
|
758
|
|
759 When cscope is used to set the quickfix error list, it didn't get set if there
|
|
760 was only one match. (Sergey Khorev)
|
|
761
|
|
762 When 'confirm' is set and using ":bdel" in a modified buffer, then selecting
|
|
763 "cancel", would still give an error message.
|
|
764
|
|
765 The PopUp menu items that started Visual mode didn't work when not in Normal
|
|
766 mode. Switching between selecting a word and a line was not possible.
|
|
767
|
|
768 Win32: The keypad decimal point always resulted in a '.', while on some
|
|
769 keyboards it's a ','. Use MapVirtualKey(VK_DECIMAL, 2).
|
|
770
|
|
771 Removed unused function DisplayCompStringOpaque() from gui_w32.c
|
|
772
|
|
773 In Visual mode there is not always an indication whether the line break is
|
|
774 selected or not. Highlight the character after the line when the line break
|
|
775 is included, e.g., after "v$o".
|
|
776
|
|
777 GTK: The <F10> key can't be mapped, it selects the menu. Disable that with a
|
|
778 GTK setting and do select the menu when <F10> isn't mapped. (David Necas)
|
|
779
|
|
780 After "Y" '[ and '] were not at start/end of the yanked text.
|
|
781
|
|
782 When a telnet connection is dropped Vim preserves files and exits. While
|
|
783 doing that a SIGHUP may arrive and disturbe us, thus ignore it. (Scott
|
38
|
784 Anderson) Also postpone SIGHUP, SIGQUIT and SIGTERM until it's safe to
|
|
785 handle. Added handle_signal().
|
|
786
|
|
787 When using "set laststatus=2 cmdheight=2" in the .gvimrc you may only get one
|
|
788 line for the cmdline. (Christian Robinson) Invoke command_height() after the
|
|
789 GUI has started up.
|
36
|
790
|
39
|
791 When completing a file name on the command line backslashes are required for
|
|
792 white space. Was only done for a space, not for a Tab.
|
|
793
|
|
794 When configure could not find a terminal library, compiling continued for a
|
|
795 long time before reporting the problem. Added a configure check for tgetent()
|
|
796 being found in a library.
|
|
797
|
|
798 When the cursor is on the first char of the last line a ":g/pat/s///" command
|
|
799 may cause the cursor to be displayed below the text.
|
|
800
|
|
801 Win32: Editing a file with non-ASCII characters doesn't work when 'encoding'
|
|
802 is "utf-8". use _wfullpath() instead of _fullpath(). (Yu-sung Moon)
|
|
803
|
|
804 When recovering the 'fileformat' and 'fileencoding' were taken from the
|
|
805 original file instead of from the swapfile. When the file didn't exist, was
|
|
806 empty or the option was changed (e.g., with ":e ++fenc=cp123 file") it could
|
|
807 be wrong. Now store 'fileformat' and 'fileencoding' in the swapfile and use
|
|
808 the values when recovering.
|
|
809
|
|
810 ":bufdo g/something/p" overwrites each last printed text line with the file
|
|
811 message for the next buffer. Temporarily clear 'shortmess' to avoid that.
|
|
812
|
40
|
813 Win32: Cannot edit a file starting with # with --remote. Do escape % and #
|
|
814 when building the ":drop" command.
|
|
815
|
41
|
816 A comment or | just after a expresion-backtick argument was not recognized.
|
|
817 E.g. in :e `="foo"`"comment.
|
|
818
|
46
|
819 "(" does not stop at an empty sentence (single dot and white space) while ")"
|
|
820 does. Also breaks "das" on that dot.
|
|
821
|
|
822 When doing "yy" with the cursor on a TAB the ruler could be wrong and "k"
|
|
823 moved the cursor to another column.
|
|
824
|
|
825 When 'commentstring' is '"%s' and there is a double quote in the line a double
|
|
826 quote before the fold marker isn't removed in the text displayed for a closed
|
|
827 fold.
|
|
828
|
|
829 In Visual mode, when 'bin' and 'eol' set, g CTRL-G counted the last line
|
|
830 break, resulting in "selected 202 of 201 bytes".
|
|
831
|
69
|
832 Motif: fonts were not used for dialog components. (Marcin Dalecki)
|
46
|
833
|
56
|
834 Motif: After using a toolbar button the keyboard focus would be on the toolbar
|
69
|
835 (Lesstif problem). (Marcin Dalecki)
|
56
|
836
|
51
|
837 When using "y<C-V>`x" where mark x is in the first column, the last line was
|
|
838 not included.
|
|
839
|
|
840 Not all test scripts work properly on MS-Windows when checked out from CVS.
|
|
841 Use a Vim command to fix all fileformats to dos before executing the tests.
|
|
842
|
|
843 When using ":new" and the file fits in the window, lines could still be above
|
|
844 the window. Now remove empty lines instead of keeping the relative position.
|
|
845
|
76
|
846 Cmdline completion didn't work after ":let var1 var<Tab>".
|
|
847
|
91
|
848 When using ":startinsert" or ":startreplace" when already in Insert mode
|
|
849 (possible when using CTRL-R =), pressing Esc would directly restart Insert
|
|
850 mode. (Peter Winters)
|
|
851
|
97
|
852 "2daw" didn't work at end of file if the last word is a single character.
|
|
853
|
100
|
854 Completion for ":next a'<Tab>" put a backslash before single quote, but it was
|
|
855 not removed when editing a file. Now halve backslashes in save_patterns().
|
109
|
856 Also fix expanding a file name with the shell that contains "\'".
|
100
|
857
|
136
|
858 When doing "1,6d|put" only "fewer lines" was reported. Now a following "more
|
|
859 lines" overwrites the message.
|
|
860
|
|
861 Configure could not handle "-Dfoo=long\ long" in the TCL config output.
|
|
862
|
141
|
863 When searching backwards, using a pattern that matches a newline and uses \zs
|
|
864 after that, didn't find a match. Could also get a hang or end up in the right
|
|
865 column in the wrong line.
|
|
866
|
149
|
867 When $LANG is "sl" for slovenian, the slovak menu was used, since "slovak"
|
|
868 starts with "sl".
|
|
869
|
|
870 When 'paste' is set in the GUI the Paste toolbar button doesn't work. Clear
|
|
871 'paste' when starting the GUI.
|
|
872
|
155
|
873 A message about a wrong viminfo line included the trailing NL.
|
|
874
|
159
|
875 When 'paste' is set in the GUI the toolbar button doesn't work in Insert mode.
|
|
876 Use ":exe" in menu.vim to avoid duplicating the commands, instead of using a
|
|
877 mapping.
|
|
878
|
|
879 Treat "mlterm" as an xterm-like terminal. (Seiichi Sato)
|
|
880
|
|
881 ":z.4" and ":z=4" didn't work Vi compatible.
|
|
882
|
162
|
883 When sourcing a file, editing it and sourcing it again, it could appear twice
|
|
884 in ":scriptnames" and get a new <SID>, because the inode has changed.
|
|
885
|
|
886 When $SHELL is set but empty the 'shell' option would be empty. Don't use an
|
|
887 empty $SHELL value.
|
|
888
|
|
889 A command "w! file" in .vimrc or $EXINIT didn't work. Now it writes an empty
|
|
890 file.
|
|
891
|
|
892 When a CTRL-F command at the end of the file failed, the cursor was still
|
|
893 moved to the start of the line. Now it remains where it is.
|
|
894
|
|
895 When using ":s" or "&" to repeat the last substitute and "$" was used to put
|
|
896 the cursor in the last column, put the cursor in the last column again. This
|
|
897 is Vi compatible.
|
|
898
|
164
|
899 Vim is not fully POSIX compliant but sticks with traditional Vi behavior.
|
|
900 Added a few flags in 'cpoptions' to behave the POSIX way when wanted. The
|
|
901 $VIM_POSIX environment variable is checked to set the default.
|
|
902
|
|
903 Appending to a register didn't insert a line break like Vi. Added the '>'
|
|
904 flag to 'cpoptions' for this.
|
|
905
|
|
906 Using "I" in a line with only blanks appended to the line. This is not Vi
|
|
907 compatible. Added the 'H' flag in 'coptions' for this.
|
|
908
|
|
909 When joining multiple lines the cursor would be at the last joint, but Vi
|
|
910 leaves it at the position where "J" would put it. Added the 'q' flag in
|
|
911 'cpoptions' for this.
|
|
912
|
|
913 Autoindent didn't work for ":insert" and ":append".
|
|
914
|
|
915 Using ":append" in an empty buffer kept the dummy line. Now it's deleted to
|
|
916 be Vi compatible.
|
|
917
|
|
918 When reading commands from a file and stdout goes to a terminal, would still
|
|
919 request the xterm version. Vim can't read it, thus the output went to the
|
|
920 shell and caused trouble there.
|
|
921
|
169
|
922 When redirecting to a register with an invalid name the redirection would
|
|
923 still be done (after an error message). Now reset "redir_reg". (Yegappan
|
|
924 Lakshmanan)
|
|
925
|
|
926 It was not possible to use a NL after a backslash in Ex mode. This is
|
|
927 sometimes used to feed multiple lines to a shell command.
|
|
928
|
170
|
929 When 'cmdheight' is set to 2 in .vimrc and the GUI uses the number of lines
|
|
930 from the terminal we actually get 3 lines for the cmdline in gvim.
|
|
931
|
|
932 When setting $HOME allocated memory would leak.
|
|
933
|
179
|
934 Win32: bold characters may sometimes write in another character cell. Use
|
|
935 unicodepdy[] as for UTF-8. (Taro Muraoka)
|
|
936
|
|
937 ":w fname" didn't work for files with 'buftype' set to "nofile".
|
|
938
|
192
|
939 The method used to locate user commands for completion differed from when they
|
|
940 are executed. Abiguous command names were not completed properly.
|
|
941
|
7
|
942 vim:tw=78:ts=8:ft=help:norl:
|