blob: 006245f6b2a4582ffa42fb609211a42b7d6c97eb [file] [log] [blame]
Bram Moolenaar89cb5e02004-07-19 20:55:54 +00001*version7.txt* For Vim version 7.0aa. Last change: 2004 Jul 19
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 Moolenaar071d4272004-06-13 20:20:40 +0000123
124New functions: ~
125
Bram Moolenaar89cb5e02004-07-19 20:55:54 +0000126byteidx(expr, nr) |byteidx()| Index of a character. (Ilya Sher)
127finddir(name) |finddir()| Find a directory in 'path'.
128findfile(name) |findfile()| Find a file in 'path'. (Johannes
129 Zellner)
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000130repeat(expr, count) |repeat()| Repeat "expr" "count" times.
131 (Christophe Poucet)
132tr(expr, from, to) |tr()| Translate characters. (Ron Aaron)
Bram Moolenaar8299df92004-07-10 09:47:34 +0000133
Bram Moolenaar071d4272004-06-13 20:20:40 +0000134
135New autocommand events: ~
136
Bram Moolenaar8299df92004-07-10 09:47:34 +0000137|InsertEnter| starting Insert or Replace mode
138|InsertChange| going from Insert to Replace mode or back
139|InsertLeave| leaving Insert or Replace mode
Bram Moolenaar843ee412004-06-30 16:16:41 +0000140
Bram Moolenaar8299df92004-07-10 09:47:34 +0000141|ColorScheme| after loading a color scheme
Bram Moolenaar071d4272004-06-13 20:20:40 +0000142
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +0000143
144New Syntax/Indent/FTplugin files: ~
145
146MuPAD source syntax, indent and ftplugin. (Dave Silvia)
147
Bram Moolenaar071d4272004-06-13 20:20:40 +0000148
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000149Others: ~
150
151Mac: Add the selection type to the clipboard, so that Block, line and
152character selections can be used between two Vims. (Eckehard Berns)
153Also fixes the problem that setting 'clipboard' to "unnamed" breaks using
154"yyp".
Bram Moolenaar071d4272004-06-13 20:20:40 +0000155
Bram Moolenaar592e0a22004-07-03 16:05:59 +0000156Mac: GUI font selector. (Peter "Rain Dog" Cucka)
157
Bram Moolenaar843ee412004-06-30 16:16:41 +0000158The netrw plugin now also supports viewing a directory, when "scp://" is used.
159Deleting and renaming files is possible. (Charles Campbell)
160
Bram Moolenaar071d4272004-06-13 20:20:40 +0000161==============================================================================
162IMPROVEMENTS *improvements-7*
163
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000164":helpgrep" accepts a language specifier after the pattern: "pat@it".
165
Bram Moolenaar8299df92004-07-10 09:47:34 +0000166Move the help for printing to a separate help file. It's quite a lot now.
167
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000168":breakadd here" and ":breakdel here" can be used to set or delete a
169breakpoint at the cursor.
170
Bram Moolenaar843ee412004-06-30 16:16:41 +0000171The tutor was updated to make it simpler to use and added text to explain a
172few more important commands. Used ideas from Gabriel Zachmann.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000173
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +0000174Unix: When libcall() fails obtain an error message with dlerror() and display
175it. (Johannes Zellner)
176
Bram Moolenaar592e0a22004-07-03 16:05:59 +0000177Added "nbsp" in 'listchars'. (David Blanchet)
178
Bram Moolenaar21cf8232004-07-16 20:18:37 +0000179Added the "acwrite" value for the 'buftype' option. This is for a buffer that
180doesn not have a name that refers to a file and is written with BufWriteCmd
181autocommands.
182
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000183For lisp indenting and matching parenthesis: (Sergey Khorev)
184- square brackets are recognized properly
185- #\(, #\), #\[ and #\] are recognized as character literals
186- Lisp line comments (delimited by semicolon) are recognized
187
Bram Moolenaar89cb5e02004-07-19 20:55:54 +0000188Added the "count" argument to match(), matchend() and matchstr(). (Ilya Sher)
189
Bram Moolenaar071d4272004-06-13 20:20:40 +0000190==============================================================================
191COMPILE TIME CHANGES *compile-changes-7*
192
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000193Mac: "make" now creates the Vim.app directory and "make install" copies it to
194its final destination. (Raf)
195
196Mac: Made it possible to compile with Motif, Athena or GTK without tricks and
197still being able to use the MacRoman conversion. Added the os_mac_conv.c
198file.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000199
200==============================================================================
201BUG FIXES *bug-fixes-7*
202
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000203When using PostScript printing on MS-DOS the default 'printexpr' used "lpr"
204instead of "copy". When 'printdevice' was empty the copy command did not
205work. Use "LPT1" then.
206
207The GTK font dialog uses a font size zero when the font name doesn't include a
208size. Use a default size of 10.
209
210This example in the documentation didn't work:
211 :e `=foo . ".c" `
212Skip over the expression in `=expr` when looking for comments, |, % and #.
213
214When ":helpgrep" doesn't find anything there is no error message.
215
216"L" and "H" did not take closed folds into account.
217
218Win32: The "-P title" argument stopped at the first title that matched, even
219when it doesn't support MDI.
220
221Mac GUI: CTRL-^ and CTRL-@ did not work.
222
223"2daw" on "word." at the end of a line didn't include the preceding white
224space.
225
226Win32: Using FindExecutable() doesn't work to find a program. Use
227SearchPath() instead. For executable() use $PATHEXT when the program searched
228for doesn't have an extension.
229
230When 'virtualedit' is set, moving the cursor up after appending a character
231may move it to a different column. Was caused by auto-formatting moving the
232cursor and not putting it back where it was.
233
234When indent was added automatically and then moving the cursor, the indent was
235not deleted (like when pressing ESC). The "I" flag in 'cpoptions' can be used
236to make it work the old way.
237
238When <Space> is mapped to something that starts with a space, typing <Space>
239does not expand abbreviations. Only disable expanding abbreviations when a
240mapping is not remapped, not when the RHS starts with the LHS.
241
242When opening a command-line window, 'textwidth' gets set to 78 by the Vim
243filetype plugin. Reset 'textwidth' to 0 to avoid lines are broken.
244
245After using cursor(line, col) moving up/down doesn't keep the same column.
246
247Win32: Borland C before 5.5 requires using ".u." for LowPart and HighPart
248fields. (Walter Briscoe)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000249
Bram Moolenaar843ee412004-06-30 16:16:41 +0000250On Sinix SYS_NMLN isn't always defined. Define it ourselves. (Cristiano De
251Michele)
252
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000253Printing with PostScript may keep the printer waiting for more. Append a
254CTRL-D to the printer output. (Mike Williams)
255
Bram Moolenaar2df6dcc2004-07-12 15:53:54 +0000256When converting a string with a hex or octal number the leading '-' was
257ignored. ":echo '-05' + 0" resulted in 5 instead of -5.
258
259Using "@:" to repeat a command line didn't work when it contains control
260characters.
261
Bram Moolenaar21cf8232004-07-16 20:18:37 +0000262When using file completion for a user command, it would not expand environment
263variables like for a regular command with a file argument.
264
265'cindent': When the argument of a #define looks like a C++ class the next line
266is indented too much.
267
268When 'comments' includes multi-byte characters inserting the middle part and
269alignment may go wrong. 'cindent' also suffers from this for right-aligned
270items.
271
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000272The default for 'helplang' was "zh" for both "zh_cn" and "zh_tw". Now use
273"cn" or "tw" as intended.
274
Bram Moolenaar071d4272004-06-13 20:20:40 +0000275 vim:tw=78:ts=8:ft=help:norl: