blob: 70745324982b171f35d6b04ff5fdc22beca64fbd [file] [log] [blame]
Bram Moolenaar3fdfa4a2004-10-07 21:02:47 +00001*version7.txt* For Vim version 7.0aa. Last change: 2004 Oct 07
Bram Moolenaar071d4272004-06-13 20:20:40 +00002
3
4 VIM REFERENCE MANUAL by Bram Moolenaar
5
6
7Welcome to Vim 7! A large number of features has been added. This file
8mentions all the new items, changes to existing features and bug fixes
9compared to Vim 6.x.
10
11See |vi_diff.txt| for an overview of differences between Vi and Vim 7.0.
12See |version4.txt| for differences between Vim 3.x and Vim 4.x.
13See |version5.txt| for differences between Vim 4.x and Vim 5.x.
14See |version6.txt| for differences between Vim 5.x and Vim 6.x.
15
16INCOMPATIBLE CHANGES |incompatible-7|
17
18NEW FEATURES |new-7|
19
20New data types |new-data-types|
Bram Moolenaar325b7a22004-07-05 15:58:32 +000021KDE support |new-KDE|
Bram Moolenaar071d4272004-06-13 20:20:40 +000022Various new items |new-items-7|
23
24IMPROVEMENTS |improvements-7|
25
26COMPILE TIME CHANGES |compile-changes-7|
27
28BUG FIXES |bug-fixes-7|
29
30==============================================================================
31INCOMPATIBLE CHANGES *incompatible-7*
32
33These changes are incompatible with previous releases. Check this list if you
34run into a problem when upgrading from Vim 6.x to 7.0
35
Bram Moolenaarf4b8e572004-06-24 15:53:16 +000036":helpgrep" now uses a help window to display a match.
37
38
39Minor incompatibilities:
40
41For filetype detection: For many types, instead of ~/.dir/filename use
42*/.dir/filename, so that it also works for other user's files.
43
44":0verbose" now sets 'verbose' to zero instead of one.
45
46Removed the old and incomplete "VimBuddy" code.
47
48Buffers without a name report "No Name" instead of "No File". It was
49confusing for buffers with a name and 'buftype' set to "nofile".
Bram Moolenaar071d4272004-06-13 20:20:40 +000050
51==============================================================================
52NEW FEATURES *new-7*
53
54New data types *new-data-types*
55--------------
56
57In Vim scripts the following types have been added:
58
59 list ordered list of items
60 dictionary associative array of items
61 function reference to a function
62
63Many functions and commands have been added to support the new types.
64
Bram Moolenaar843ee412004-06-30 16:16:41 +000065NOT IMPLEMENTED YET!
66
67
Bram Moolenaar325b7a22004-07-05 15:58:32 +000068KDE support *new-KDE*
Bram Moolenaar843ee412004-06-30 16:16:41 +000069-----------
70
71Kvim is the KDE version of Vim. It uses the Qt toolkit. See |KVim|.
72(Thomas Capricelli, Philippe Fremy, Mickael Marchand, Mark Westcott, et al.)
73
Bram Moolenaar071d4272004-06-13 20:20:40 +000074
Bram Moolenaar325b7a22004-07-05 15:58:32 +000075MzScheme interface *new-MzScheme*
76------------------
77
78The MzScheme interpreter is supported. |MzScheme|
79The |:mzscheme| command can be used to execute MzScheme commands.
80The |:mzfile| command can be used to execute an MzScheme script file.
81
Bram Moolenaar8299df92004-07-10 09:47:34 +000082Printing multi-byte text *new-print-multi-byte*
83------------------
84
85The |:hardcopy| command now supports printing multi-byte characters.
86The 'printmbcharset' and 'printmbfont' options are used for this.
87Also see |postscript-cjk-printing|. (Mike Williams)
88
Bram Moolenaar325b7a22004-07-05 15:58:32 +000089
Bram Moolenaar071d4272004-06-13 20:20:40 +000090Various new items *new-items-7*
91-----------------
92
93Normal mode commands: ~
94
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +000095a", a' and a` New text objects to select quoted strings. |a'|
96i", i' and i' (Taro Muraoka)
Bram Moolenaar071d4272004-06-13 20:20:40 +000097
98Options: ~
99
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +0000100'completefunc' The name of a function used for user-specified Insert
101 mode completion. CTRL-X CTRL-U can be used in Insert
102 mode to do any kind of completion. (Taro Muraoka)
103'quoteescape' Characters used to escape quotes inside a string.
104 Used for the a", a' and a` text objects. |a'|
Bram Moolenaar592e0a22004-07-03 16:05:59 +0000105'numberwidth' Minimal width of the space used for the 'number'
106 option. (Emmanuel Renieris)
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000107'mzquantum' Time in msec to schedule MzScheme threads.
Bram Moolenaar8299df92004-07-10 09:47:34 +0000108'printmbcharset' CJK character set to be used for :hardcopy
109'printmbfont' font names to be used for CJK output of :hardcopy
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000110
Bram Moolenaar071d4272004-06-13 20:20:40 +0000111
112Ex commands: ~
113
Bram Moolenaar843ee412004-06-30 16:16:41 +0000114Win32: The ":winpos" command now also works in the console. (Vipin Aravind)
115
Bram Moolenaar8299df92004-07-10 09:47:34 +0000116|:startreplace| Start Replace mode. (Charles Campbell)
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000117
Bram Moolenaar8299df92004-07-10 09:47:34 +0000118|:0file| Removes the name of the buffer. (Charles Campbell)
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000119
Bram Moolenaar2df6dcc2004-07-12 15:53:54 +0000120|:diffoff| Switch off diff mode in the current window or in all
121 windows.
122
Bram Moolenaard4755bb2004-09-02 19:12:26 +0000123|:keepalt| Do not change the alternate file.
124
Bram Moolenaarc0197e22004-09-13 20:26:32 +0000125|:delmarks| Delete marks.
126
Bram Moolenaar071d4272004-06-13 20:20:40 +0000127
128New functions: ~
129
Bram Moolenaar89cb5e02004-07-19 20:55:54 +0000130byteidx(expr, nr) |byteidx()| Index of a character. (Ilya Sher)
131finddir(name) |finddir()| Find a directory in 'path'.
132findfile(name) |findfile()| Find a file in 'path'. (Johannes
133 Zellner)
Bram Moolenaar5eb86f92004-07-26 12:53:41 +0000134getfperm(fname) |getfperm()| Get file permission string. (Nikolai
135 Weibull)
136getftype(fname) |getftype()| Get type of file. (Nikolai Weibull)
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000137repeat(expr, count) |repeat()| Repeat "expr" "count" times.
138 (Christophe Poucet)
139tr(expr, from, to) |tr()| Translate characters. (Ron Aaron)
Bram Moolenaarc0197e22004-09-13 20:26:32 +0000140system(cmd, input) |system()| Filters {input} through a shell
141 command.
Bram Moolenaar8299df92004-07-10 09:47:34 +0000142
Bram Moolenaar071d4272004-06-13 20:20:40 +0000143
144New autocommand events: ~
145
Bram Moolenaar8299df92004-07-10 09:47:34 +0000146|InsertEnter| starting Insert or Replace mode
147|InsertChange| going from Insert to Replace mode or back
148|InsertLeave| leaving Insert or Replace mode
Bram Moolenaar843ee412004-06-30 16:16:41 +0000149
Bram Moolenaar8299df92004-07-10 09:47:34 +0000150|ColorScheme| after loading a color scheme
Bram Moolenaar071d4272004-06-13 20:20:40 +0000151
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +0000152
Bram Moolenaarc0197e22004-09-13 20:26:32 +0000153New items in search patterns: ~
154|/\%d| \%d123 search for character with decimal number
155|/\]| [\d123] idem, in a colletion
156|/\%o| \%o103 search for character with octal number
157|/\]| [\o1o3] idem, in a colletion
158|/\%x| \%x1a search for character with 2 pos. hex number
159|/\]| [\x1a] idem, in a colletion
160|/\%u| \%u12ab search for character with 4 pos. hex number
161|/\]| [\u12ab] idem, in a colletion
162|/\%U| \%U1234abcd search for character with 8 pos. hex number
163|/\]| [\U1234abcd] idem, in a colletion
164 (The above partly by Ciaran McCreesh)
165
166
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +0000167New Syntax/Indent/FTplugin files: ~
168
169MuPAD source syntax, indent and ftplugin. (Dave Silvia)
170
Bram Moolenaard4755bb2004-09-02 19:12:26 +0000171ABAB/4 syntax file. (Marius van Wyk)
172
173SQL-Informix syntax file. (Dean L Hill)
174
Bram Moolenaar15d0a8c2004-09-06 17:44:46 +0000175PHP compiler plugin. (Doug Kearns)
176
177
178New message translations: ~
179
180The Ukranian messages are now also available in cp1251.
181
Bram Moolenaar071d4272004-06-13 20:20:40 +0000182
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000183Others: ~
184
185Mac: Add the selection type to the clipboard, so that Block, line and
186character selections can be used between two Vims. (Eckehard Berns)
187Also fixes the problem that setting 'clipboard' to "unnamed" breaks using
188"yyp".
Bram Moolenaar071d4272004-06-13 20:20:40 +0000189
Bram Moolenaar592e0a22004-07-03 16:05:59 +0000190Mac: GUI font selector. (Peter "Rain Dog" Cucka)
191
Bram Moolenaar843ee412004-06-30 16:16:41 +0000192The netrw plugin now also supports viewing a directory, when "scp://" is used.
193Deleting and renaming files is possible. (Charles Campbell)
194
Bram Moolenaar071d4272004-06-13 20:20:40 +0000195==============================================================================
196IMPROVEMENTS *improvements-7*
197
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000198":helpgrep" accepts a language specifier after the pattern: "pat@it".
199
Bram Moolenaar8299df92004-07-10 09:47:34 +0000200Move the help for printing to a separate help file. It's quite a lot now.
201
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000202":breakadd here" and ":breakdel here" can be used to set or delete a
203breakpoint at the cursor.
204
Bram Moolenaar843ee412004-06-30 16:16:41 +0000205The tutor was updated to make it simpler to use and added text to explain a
206few more important commands. Used ideas from Gabriel Zachmann.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000207
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +0000208Unix: When libcall() fails obtain an error message with dlerror() and display
209it. (Johannes Zellner)
210
Bram Moolenaar592e0a22004-07-03 16:05:59 +0000211Added "nbsp" in 'listchars'. (David Blanchet)
212
Bram Moolenaar21cf8232004-07-16 20:18:37 +0000213Added the "acwrite" value for the 'buftype' option. This is for a buffer that
214doesn not have a name that refers to a file and is written with BufWriteCmd
215autocommands.
216
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000217For lisp indenting and matching parenthesis: (Sergey Khorev)
218- square brackets are recognized properly
219- #\(, #\), #\[ and #\] are recognized as character literals
220- Lisp line comments (delimited by semicolon) are recognized
221
Bram Moolenaar89cb5e02004-07-19 20:55:54 +0000222Added the "count" argument to match(), matchend() and matchstr(). (Ilya Sher)
223
Bram Moolenaar5eb86f92004-07-26 12:53:41 +0000224winnr() takes an optional "$" and "#" arguments. (Nikolai Weibull, Yegappan
225Lakshmanan)
226
227Added 'n' flag to search(): don't move the cursor. (Nikolai Weibull)
228
Bram Moolenaard4755bb2004-09-02 19:12:26 +0000229When uncompressing fails in the gzip plugin, give an error message but don't
230delete the raw text. Helps if the file has a .gz extension but is not
231actually compressed. (Andrew Pimlott)
232
233When C, C++ or IDL syntax is used, may additionally load doxygen syntax.
234Also support setting the filetype to "cdoxygen" for C plus doxygen syntax.
235(Michael Geddes)
236
237The ":registers" command now displays multi-byte characters properly.
238
239VMS: In the usage message mention that a slash can be used to make a flag
240upper case. Add color support to the builtin vt320 terminal codes.
241(Zoltan Arpadffy)
242
Bram Moolenaar15d0a8c2004-09-06 17:44:46 +0000243For the '%' item in 'viminfo', allow a number to set a maximum for the number
244of buffers.
245
Bram Moolenaar3fdfa4a2004-10-07 21:02:47 +0000246When a file looks like a shell script, check for an "exec" command that starts
247the tcl interpreter. (suggested by Alexios Zavras)
248
249Support conversion between utf-8 and latin9 (iso-8859-15) internally, so that
250digraphs still work when iconv is not available.
251
Bram Moolenaar071d4272004-06-13 20:20:40 +0000252==============================================================================
253COMPILE TIME CHANGES *compile-changes-7*
254
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000255Mac: "make" now creates the Vim.app directory and "make install" copies it to
256its final destination. (Raf)
257
258Mac: Made it possible to compile with Motif, Athena or GTK without tricks and
259still being able to use the MacRoman conversion. Added the os_mac_conv.c
260file.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000261
262==============================================================================
263BUG FIXES *bug-fixes-7*
264
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000265When using PostScript printing on MS-DOS the default 'printexpr' used "lpr"
266instead of "copy". When 'printdevice' was empty the copy command did not
267work. Use "LPT1" then.
268
269The GTK font dialog uses a font size zero when the font name doesn't include a
270size. Use a default size of 10.
271
272This example in the documentation didn't work:
273 :e `=foo . ".c" `
274Skip over the expression in `=expr` when looking for comments, |, % and #.
275
276When ":helpgrep" doesn't find anything there is no error message.
277
278"L" and "H" did not take closed folds into account.
279
280Win32: The "-P title" argument stopped at the first title that matched, even
281when it doesn't support MDI.
282
283Mac GUI: CTRL-^ and CTRL-@ did not work.
284
285"2daw" on "word." at the end of a line didn't include the preceding white
286space.
287
288Win32: Using FindExecutable() doesn't work to find a program. Use
289SearchPath() instead. For executable() use $PATHEXT when the program searched
290for doesn't have an extension.
291
292When 'virtualedit' is set, moving the cursor up after appending a character
293may move it to a different column. Was caused by auto-formatting moving the
294cursor and not putting it back where it was.
295
296When indent was added automatically and then moving the cursor, the indent was
297not deleted (like when pressing ESC). The "I" flag in 'cpoptions' can be used
298to make it work the old way.
299
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000300When opening a command-line window, 'textwidth' gets set to 78 by the Vim
301filetype plugin. Reset 'textwidth' to 0 to avoid lines are broken.
302
303After using cursor(line, col) moving up/down doesn't keep the same column.
304
305Win32: Borland C before 5.5 requires using ".u." for LowPart and HighPart
306fields. (Walter Briscoe)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000307
Bram Moolenaar843ee412004-06-30 16:16:41 +0000308On Sinix SYS_NMLN isn't always defined. Define it ourselves. (Cristiano De
309Michele)
310
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000311Printing with PostScript may keep the printer waiting for more. Append a
312CTRL-D to the printer output. (Mike Williams)
313
Bram Moolenaar2df6dcc2004-07-12 15:53:54 +0000314When converting a string with a hex or octal number the leading '-' was
315ignored. ":echo '-05' + 0" resulted in 5 instead of -5.
316
317Using "@:" to repeat a command line didn't work when it contains control
318characters.
319
Bram Moolenaar21cf8232004-07-16 20:18:37 +0000320When using file completion for a user command, it would not expand environment
321variables like for a regular command with a file argument.
322
323'cindent': When the argument of a #define looks like a C++ class the next line
324is indented too much.
325
326When 'comments' includes multi-byte characters inserting the middle part and
327alignment may go wrong. 'cindent' also suffers from this for right-aligned
328items.
329
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000330The default for 'helplang' was "zh" for both "zh_cn" and "zh_tw". Now use
331"cn" or "tw" as intended.
332
Bram Moolenaar5eb86f92004-07-26 12:53:41 +0000333When 'bin' is set and 'eol' is not set then line2byte() added the line break
334after the last line while it's not there.
335
336Using foldlevel() in a WinEnter autocommand may not work. Noticed when
337resizing the GUI shell upon startup.
338
339Python: Using buffer.append(f.readlines()) didn't work. Allow appending a
340string with a trailing newline. The newline is ignored.
341
Bram Moolenaar269ec652004-07-29 08:43:53 +0000342When using the ":saveas f2" command for buffer "f1", the Buffers menu would
343contain "f2" twice, one of them leading to "f1". Also trigger the BufFilePre
344and BufFilePost events for the alternate buffer that gets the old name.
345
Bram Moolenaard4755bb2004-09-02 19:12:26 +0000346strridx() did not work well when the needle is empty. (Ciaran McCreesh)
347
348GTK: Avoid a potential hang in gui_mch_wait_for_chars() when input arrives
349just before it is invoked
350
351VMS: Occasionally CR characters were inserted in the file. Expansion of
352environment variables was not correct. (Zoltan Arpadffy)
353
354UTF-8: When 'delcombine' is set "dw" only deleted the last combining character
355from the first character of the word.
356
357When using ":sball" in an autocommand only the filetype in one buffer was
358detected. Reset did_filetype in enter_buffer().
359
360When using ":argdo" and the window already was at the first argument index,
361but not actually editing it, the current buffer would be used instead.
362
Bram Moolenaar15d0a8c2004-09-06 17:44:46 +0000363When ":next dir/*" includes many matches, adding the names to the argument
364list may take an awful lot of time and can't be interrupted. Allow
365interrupting this.
366
367When editing a file that was already loaded in a buffer, modelines were not
368used. Now window-local options in the modeline are set. Buffer-local options
369and global options remain unmodified.
370
371Win32: When 'encoding' is set to "utf-8" in the vimrc file, files from the
372command line with non-ASCII characters are not used correctly. Recode the
373file names when 'encoding' is set, using the Unicode command line.
374
Bram Moolenaarc0197e22004-09-13 20:26:32 +0000375Win32 console: When the default for 'encoding' ends up to be "latin1", the
376default value of 'isprint' was wrong.
377
378When an error message is given while waiting for a character (e.g., when an
379xterm reports the number of colors), the hit-enter prompt overwrote the last
380line. Don't reset msg_didout in normal_cmd() for K_IGNORE.
381
Bram Moolenaar3fdfa4a2004-10-07 21:02:47 +0000382Mac GUI: Shift-Tab didn't work.
383
384When defining tooltip text, don't translate terminal codes, since it's not
385going to be used like a command.
386
387GTK 2: Check the tooltip text for valid utf-8 characters to avoid getting a
388GTK error. Invalid characters may appear when 'encoding' is changed.
389
390GTK 2: Add a safety check for invalid utf-8 sequences, they can crash pango.
391
392Win32: When 'encoding' is changed while starting up, use the Unicode command
393line to convert the file arguments to 'encoding'. Both for the GUI and the
394console version.
395
396Win32 GUI: latin9 text (iso-8859-15) was not displayed correctly, because
397there is no codepage for latin9. Do our own conversion from latin9 to UCS2.
398
Bram Moolenaar071d4272004-06-13 20:20:40 +0000399 vim:tw=78:ts=8:ft=help:norl: