1*version7.txt* For Vim version 7.0aa. Last change: 2004 Sep 01 2 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| 21KDE support |new-KDE| 22Various 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 36":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". 50 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 65NOT IMPLEMENTED YET! 66 67 68KDE support *new-KDE* 69----------- 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 74 75MzScheme 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 82Printing 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 89 90Various new items *new-items-7* 91----------------- 92 93Normal mode commands: ~ 94 95a", a' and a` New text objects to select quoted strings. |a'| 96i", i' and i' (Taro Muraoka) 97 98Options: ~ 99 100'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'| 105'numberwidth' Minimal width of the space used for the 'number' 106 option. (Emmanuel Renieris) 107'mzquantum' Time in msec to schedule MzScheme threads. 108'printmbcharset' CJK character set to be used for :hardcopy 109'printmbfont' font names to be used for CJK output of :hardcopy 110 111 112Ex commands: ~ 113 114Win32: The ":winpos" command now also works in the console. (Vipin Aravind) 115 116|:startreplace| Start Replace mode. (Charles Campbell) 117 118|:0file| Removes the name of the buffer. (Charles Campbell) 119 120|:diffoff| Switch off diff mode in the current window or in all 121 windows. 122 123|:keepalt| Do not change the alternate file. 124 125 126New functions: ~ 127 128byteidx(expr, nr) |byteidx()| Index of a character. (Ilya Sher) 129finddir(name) |finddir()| Find a directory in 'path'. 130findfile(name) |findfile()| Find a file in 'path'. (Johannes 131 Zellner) 132getfperm(fname) |getfperm()| Get file permission string. (Nikolai 133 Weibull) 134getftype(fname) |getftype()| Get type of file. (Nikolai Weibull) 135repeat(expr, count) |repeat()| Repeat "expr" "count" times. 136 (Christophe Poucet) 137tr(expr, from, to) |tr()| Translate characters. (Ron Aaron) 138 139 140New autocommand events: ~ 141 142|InsertEnter| starting Insert or Replace mode 143|InsertChange| going from Insert to Replace mode or back 144|InsertLeave| leaving Insert or Replace mode 145 146|ColorScheme| after loading a color scheme 147 148 149New Syntax/Indent/FTplugin files: ~ 150 151MuPAD source syntax, indent and ftplugin. (Dave Silvia) 152 153ABAB/4 syntax file. (Marius van Wyk) 154 155SQL-Informix syntax file. (Dean L Hill) 156 157 158Others: ~ 159 160Mac: Add the selection type to the clipboard, so that Block, line and 161character selections can be used between two Vims. (Eckehard Berns) 162Also fixes the problem that setting 'clipboard' to "unnamed" breaks using 163"yyp". 164 165Mac: GUI font selector. (Peter "Rain Dog" Cucka) 166 167The netrw plugin now also supports viewing a directory, when "scp://" is used. 168Deleting and renaming files is possible. (Charles Campbell) 169 170============================================================================== 171IMPROVEMENTS *improvements-7* 172 173":helpgrep" accepts a language specifier after the pattern: "pat@it". 174 175Move the help for printing to a separate help file. It's quite a lot now. 176 177":breakadd here" and ":breakdel here" can be used to set or delete a 178breakpoint at the cursor. 179 180The tutor was updated to make it simpler to use and added text to explain a 181few more important commands. Used ideas from Gabriel Zachmann. 182 183Unix: When libcall() fails obtain an error message with dlerror() and display 184it. (Johannes Zellner) 185 186Added "nbsp" in 'listchars'. (David Blanchet) 187 188Added the "acwrite" value for the 'buftype' option. This is for a buffer that 189doesn not have a name that refers to a file and is written with BufWriteCmd 190autocommands. 191 192For lisp indenting and matching parenthesis: (Sergey Khorev) 193- square brackets are recognized properly 194- #\(, #\), #\[ and #\] are recognized as character literals 195- Lisp line comments (delimited by semicolon) are recognized 196 197Added the "count" argument to match(), matchend() and matchstr(). (Ilya Sher) 198 199winnr() takes an optional "$" and "#" arguments. (Nikolai Weibull, Yegappan 200Lakshmanan) 201 202Added 'n' flag to search(): don't move the cursor. (Nikolai Weibull) 203 204When uncompressing fails in the gzip plugin, give an error message but don't 205delete the raw text. Helps if the file has a .gz extension but is not 206actually compressed. (Andrew Pimlott) 207 208When C, C++ or IDL syntax is used, may additionally load doxygen syntax. 209Also support setting the filetype to "cdoxygen" for C plus doxygen syntax. 210(Michael Geddes) 211 212The ":registers" command now displays multi-byte characters properly. 213 214VMS: In the usage message mention that a slash can be used to make a flag 215upper case. Add color support to the builtin vt320 terminal codes. 216(Zoltan Arpadffy) 217 218============================================================================== 219COMPILE TIME CHANGES *compile-changes-7* 220 221Mac: "make" now creates the Vim.app directory and "make install" copies it to 222its final destination. (Raf) 223 224Mac: Made it possible to compile with Motif, Athena or GTK without tricks and 225still being able to use the MacRoman conversion. Added the os_mac_conv.c 226file. 227 228============================================================================== 229BUG FIXES *bug-fixes-7* 230 231When using PostScript printing on MS-DOS the default 'printexpr' used "lpr" 232instead of "copy". When 'printdevice' was empty the copy command did not 233work. Use "LPT1" then. 234 235The GTK font dialog uses a font size zero when the font name doesn't include a 236size. Use a default size of 10. 237 238This example in the documentation didn't work: 239 :e `=foo . ".c" ` 240Skip over the expression in `=expr` when looking for comments, |, % and #. 241 242When ":helpgrep" doesn't find anything there is no error message. 243 244"L" and "H" did not take closed folds into account. 245 246Win32: The "-P title" argument stopped at the first title that matched, even 247when it doesn't support MDI. 248 249Mac GUI: CTRL-^ and CTRL-@ did not work. 250 251"2daw" on "word." at the end of a line didn't include the preceding white 252space. 253 254Win32: Using FindExecutable() doesn't work to find a program. Use 255SearchPath() instead. For executable() use $PATHEXT when the program searched 256for doesn't have an extension. 257 258When 'virtualedit' is set, moving the cursor up after appending a character 259may move it to a different column. Was caused by auto-formatting moving the 260cursor and not putting it back where it was. 261 262When indent was added automatically and then moving the cursor, the indent was 263not deleted (like when pressing ESC). The "I" flag in 'cpoptions' can be used 264to make it work the old way. 265 266When <Space> is mapped to something that starts with a space, typing <Space> 267does not expand abbreviations. Only disable expanding abbreviations when a 268mapping is not remapped, not when the RHS starts with the LHS. 269 270When opening a command-line window, 'textwidth' gets set to 78 by the Vim 271filetype plugin. Reset 'textwidth' to 0 to avoid lines are broken. 272 273After using cursor(line, col) moving up/down doesn't keep the same column. 274 275Win32: Borland C before 5.5 requires using ".u." for LowPart and HighPart 276fields. (Walter Briscoe) 277 278On Sinix SYS_NMLN isn't always defined. Define it ourselves. (Cristiano De 279Michele) 280 281Printing with PostScript may keep the printer waiting for more. Append a 282CTRL-D to the printer output. (Mike Williams) 283 284When converting a string with a hex or octal number the leading '-' was 285ignored. ":echo '-05' + 0" resulted in 5 instead of -5. 286 287Using "@:" to repeat a command line didn't work when it contains control 288characters. 289 290When using file completion for a user command, it would not expand environment 291variables like for a regular command with a file argument. 292 293'cindent': When the argument of a #define looks like a C++ class the next line 294is indented too much. 295 296When 'comments' includes multi-byte characters inserting the middle part and 297alignment may go wrong. 'cindent' also suffers from this for right-aligned 298items. 299 300The default for 'helplang' was "zh" for both "zh_cn" and "zh_tw". Now use 301"cn" or "tw" as intended. 302 303When 'bin' is set and 'eol' is not set then line2byte() added the line break 304after the last line while it's not there. 305 306Using foldlevel() in a WinEnter autocommand may not work. Noticed when 307resizing the GUI shell upon startup. 308 309Python: Using buffer.append(f.readlines()) didn't work. Allow appending a 310string with a trailing newline. The newline is ignored. 311 312When using the ":saveas f2" command for buffer "f1", the Buffers menu would 313contain "f2" twice, one of them leading to "f1". Also trigger the BufFilePre 314and BufFilePost events for the alternate buffer that gets the old name. 315 316strridx() did not work well when the needle is empty. (Ciaran McCreesh) 317 318GTK: Avoid a potential hang in gui_mch_wait_for_chars() when input arrives 319just before it is invoked 320 321VMS: Occasionally CR characters were inserted in the file. Expansion of 322environment variables was not correct. (Zoltan Arpadffy) 323 324UTF-8: When 'delcombine' is set "dw" only deleted the last combining character 325from the first character of the word. 326 327When using ":sball" in an autocommand only the filetype in one buffer was 328detected. Reset did_filetype in enter_buffer(). 329 330When using ":argdo" and the window already was at the first argument index, 331but not actually editing it, the current buffer would be used instead. 332 333 vim:tw=78:ts=8:ft=help:norl: 334