blob: b007cddba82f8b89270813f393469462cccf270d [file] [log] [blame]
Bram Moolenaar05159a02005-02-26 23:04:13 +00001*version7.txt* For Vim version 7.0aa. Last change: 2005 Feb 24
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
Bram Moolenaarb2956cd2005-01-27 14:42:53 +00009compared to Vim 6.x. Use this command to see the version you are using: >
10 :version
Bram Moolenaar071d4272004-06-13 20:20:40 +000011
12See |vi_diff.txt| for an overview of differences between Vi and Vim 7.0.
13See |version4.txt| for differences between Vim 3.x and Vim 4.x.
14See |version5.txt| for differences between Vim 4.x and Vim 5.x.
15See |version6.txt| for differences between Vim 5.x and Vim 6.x.
16
17INCOMPATIBLE CHANGES |incompatible-7|
18
19NEW FEATURES |new-7|
20
Bram Moolenaarbac234e2005-01-17 22:21:07 +000021Vim script enhancements |new-vim-script|
Bram Moolenaar325b7a22004-07-05 15:58:32 +000022KDE support |new-KDE|
Bram Moolenaar293ee4d2004-12-09 21:34:53 +000023Translated manual pages |new-manpage-trans|
Bram Moolenaar8fc061c2004-12-29 21:03:02 +000024Internal grep |new-vimgrep|
Bram Moolenaar4399ef42005-02-12 14:29:27 +000025POSIX compatibility |new-posix|
Bram Moolenaar071d4272004-06-13 20:20:40 +000026Various new items |new-items-7|
27
28IMPROVEMENTS |improvements-7|
29
30COMPILE TIME CHANGES |compile-changes-7|
31
32BUG FIXES |bug-fixes-7|
33
34==============================================================================
35INCOMPATIBLE CHANGES *incompatible-7*
36
37These changes are incompatible with previous releases. Check this list if you
Bram Moolenaarb2956cd2005-01-27 14:42:53 +000038run into a problem when upgrading from Vim 6.x to 7.0.
39
40A ":write file" command no longer resets the 'modified' flag of the buffer,
41unless the '+' flag is in 'cpoptions' |cpo-+|. This was illogical, since the
42buffer is still modified compared to the original file. And when undoing
43all changes the file would actually be marked modified. It does mean that
44":quit" fails now.
Bram Moolenaar071d4272004-06-13 20:20:40 +000045
Bram Moolenaarf4b8e572004-06-24 15:53:16 +000046":helpgrep" now uses a help window to display a match.
47
Bram Moolenaar1cd871b2004-12-19 22:46:22 +000048In an argument list double quotes could be used to include spaces in a file
49name. This caused a difference between ":edit" and ":next" for escaping
50double quotes and it is incompatible with some versions of Vi.
51 Command Vim 6.x file name Vim 7.x file name ~
52 :edit foo\"888 'foo"888' 'foo"888'
53 :next foo\"888 'foo888' 'foo"888'
54 :next a\"b c\"d 'ab cd' 'a"b' and 'c"d'
55
Bram Moolenaar8c711452005-01-14 21:53:12 +000056In a |literal-string| a single quote can be doubled to get one.
57":echo 'a''b'" would result in "a b", but now that two quotes stand for one it
58results in "a'b".
59
Bram Moolenaarf4b8e572004-06-24 15:53:16 +000060
61Minor incompatibilities:
62
63For filetype detection: For many types, instead of ~/.dir/filename use
64*/.dir/filename, so that it also works for other user's files.
65
66":0verbose" now sets 'verbose' to zero instead of one.
67
68Removed the old and incomplete "VimBuddy" code.
69
70Buffers without a name report "No Name" instead of "No File". It was
71confusing for buffers with a name and 'buftype' set to "nofile".
Bram Moolenaar071d4272004-06-13 20:20:40 +000072
Bram Moolenaar7b0294c2004-10-11 10:16:09 +000073When ":file xxx" is used in a buffer without a name, the alternate file name
74isn't set. This avoids creating buffers without a name that are not useful.
75
76The "2html.vim" script now converts closed folds to HTML. This means the HTML
77looks like its displayed, with the same folds open and closed. Use "zR" if no
78folds should appear in the HTML. (partly by Carl Osterwisch)
Bram Moolenaar47136d72004-10-12 20:02:24 +000079Diff mode now is also converted as it is displayed.
Bram Moolenaar7b0294c2004-10-11 10:16:09 +000080
Bram Moolenaar293ee4d2004-12-09 21:34:53 +000081Win32: The effect of the <F10> key depended on 'winaltkeys'. Now it depends
82on whether <F10> has been mapped or not. This allows mapping <F10> without
83changing 'winaltkeys'.
84
Bram Moolenaar8c711452005-01-14 21:53:12 +000085When 'octal' is in 'nrformats' and using CTRL-A on "08" it became "018", which
86is illogical. Now it becomes "9". The leading zero(s) is(are) removed to
87avoid the number becoming octal after incrementing "009" to "010".
Bram Moolenaar1cd871b2004-12-19 22:46:22 +000088
89When 'encoding' is set to a Unicode encoding, the value for 'fileencodings'
90now includes "default" before "latin1". This means that for files with 8-bit
91encodings the default is to use the encoding specified by the environment, if
92possible. Previously latin1 would always be used, which is wrong in a
93non-latin1 environment, such as Russian.
94
Bram Moolenaard438e912005-01-31 19:21:46 +000095Previously Vim would exit when there are two windows, both of them displaying
96a help file, and using ":quit". Now only the window is closed.
97
Bram Moolenaar4399ef42005-02-12 14:29:27 +000098"-w {scriptout}" only works when {scriptout} doesn't start with a digit.
99Otherwise it's used to set the 'window' option.
100
Bram Moolenaar071d4272004-06-13 20:20:40 +0000101==============================================================================
102NEW FEATURES *new-7*
103
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000104Vim script enhancements *new-vim-script*
105-----------------------
Bram Moolenaar071d4272004-06-13 20:20:40 +0000106
107In Vim scripts the following types have been added:
108
Bram Moolenaar31c67ef2005-01-11 21:34:41 +0000109 List ordered list of items |List|
110 Dictionary associative array of items |Dictionary|
111 Funcref reference to a function |Funcref|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000112
113Many functions and commands have been added to support the new types.
114
Bram Moolenaar31c67ef2005-01-11 21:34:41 +0000115The |string()| function can be used to get a string representation of a
116variable. Works for Numbers, Strings and composites of them. Then |eval()|
117can be used to turn the string back into the variable value.
118
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000119The |:let| command can now use ":let var += expr" like using ":let var = var +
120expr". "-=" and ".=" works in a similar way.
121
Bram Moolenaar843ee412004-06-30 16:16:41 +0000122
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000123KDE support *new-KDE*
Bram Moolenaar843ee412004-06-30 16:16:41 +0000124-----------
125
126Kvim is the KDE version of Vim. It uses the Qt toolkit. See |KVim|.
127(Thomas Capricelli, Philippe Fremy, Mickael Marchand, Mark Westcott, et al.)
128
Bram Moolenaar071d4272004-06-13 20:20:40 +0000129
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000130MzScheme interface *new-MzScheme*
131------------------
132
133The MzScheme interpreter is supported. |MzScheme|
134The |:mzscheme| command can be used to execute MzScheme commands.
135The |:mzfile| command can be used to execute an MzScheme script file.
136
Bram Moolenaar31c67ef2005-01-11 21:34:41 +0000137
Bram Moolenaar8299df92004-07-10 09:47:34 +0000138Printing multi-byte text *new-print-multi-byte*
139------------------
140
141The |:hardcopy| command now supports printing multi-byte characters.
142The 'printmbcharset' and 'printmbfont' options are used for this.
143Also see |postscript-cjk-printing|. (Mike Williams)
144
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000145
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000146Translated manual pages *new-manpage-trans*
147-----------------------
148
149The manual page of Vim and associated programs is now also available in
150Italian (translated by Antonio Colombo). More languages will follow.
151
Bram Moolenaarb5bf5b82004-12-24 14:35:23 +0000152The Unix Makefile installs the Italian manual pages in .../man/it/man1/.
153
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000154
Bram Moolenaar8fc061c2004-12-29 21:03:02 +0000155Internal grep *new-vimgrep*
156-------------
157
158The ":vimgrep" command can be used to search for a pattern in a list of files.
159This is like the ":grep" command, but no external program is used. Besides
160better portability, handling of different file encodings and using multi-line
161patterns, this also allows grepping in compressed and remote files.
162|:vimgrep|.
163
Bram Moolenaar05159a02005-02-26 23:04:13 +0000164If you want to use the search results in a script you can use the
165|errorlist()| function.
166
Bram Moolenaar8fc061c2004-12-29 21:03:02 +0000167
Bram Moolenaar4399ef42005-02-12 14:29:27 +0000168POSIX compatibility *new-posix*
169-------------------
170
171The POSIX test suite was used to verify POSIX compatibility. A number of
172problems have been fixed to make Vim more POSIX compatible. Some of them
173conflict with traditional Vi or expected behavior. The $VIM_POSIX environment
174variable can be set to get POSIX compatibility. See |posix|.
175
176Items that were fixed for both Vi and POSIX compatibilty:
177- repeating "R" with a count only overwrites text once; added the 'X' flag to
178 'cpoptions' |cpo-X|
179- a vertical movement command that moves to a non-existing line fails; added
180 the '-' flag to 'cpoptions' |cpo--|
181- when preserving a file and doing ":q!" the file can be recovered; added the
182 '&' flag to 'cpoptions' |cpo-&|
183- The 'window' option is partly implemented. It specifies how much CTRL-F and
184 CTRL-B scroll when there is one window. The "-w {number}" argument is now
185 accepted. "-w {scriptout}" only works when {scriptout} doesn't start with a
186 digit.
187- Allow "-c{command}" argument, no space between "-c" and {command}.
188- When writing a file with ":w!" don't reset 'readonly' when 'Z' is present in
189 'cpoptions'.
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000190- Allow 'l' and '#' flags for ":list", ":print" and ":number".
191- Added the '.' flag to 'cpoptions': ":cd" fails when the buffer is modified.
192- In Ex mode with an empty buffer ":read file" doesn't keep an empty line
193 above or below the new lines.
194- Remove a backslash before a NL for the ":global" command.
195- When ":append", ":insert" or ":change" is used with ":global", get the
196 inserted lines from the command. Can use backslash-NL to separate lines.
197- Can use ":global /pat/ visual" to execute Normal mode commands at each
198 matched line. Use "Q" to continue and go to the next line.
199- The |:open| command has been partially implemented. It stops Ex mode, but
200 redraws the whole screen, not just one line as open mode is supposed to do.
201- Support using a pipe to read the output from and write input to an external
202 command. Added the 'shelltemp' option and has("filterpipe").
203- In ex silent mode the ":set" command output is displayed.
204- The ":@@" and ":**" give an error message when no register was used before.
205- The search pattern "[]-`]" matches ']', '^', '_' and '`'.
206- Autoindent for ":insert" is using the line below the insert.
207- Autoindent for ":change" is using the first changed line.
208- Editing Ex command lines is not done in cooked mode, because CTRL-D and
209 CTRL-T cannot be handled then.
210- In Ex mode, "1,3" prints three lines.
211- Implemented the 'prompt' option.
Bram Moolenaar4399ef42005-02-12 14:29:27 +0000212
213
Bram Moolenaar071d4272004-06-13 20:20:40 +0000214Various new items *new-items-7*
215-----------------
216
217Normal mode commands: ~
218
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +0000219a", a' and a` New text objects to select quoted strings. |a'|
220i", i' and i' (Taro Muraoka)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000221
Bram Moolenaar05159a02005-02-26 23:04:13 +0000222CTRL-W <Enter> In the quickfix window: opens a new window to show the
223 location of the error under the cursor.
224
Bram Moolenaar071d4272004-06-13 20:20:40 +0000225Options: ~
226
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +0000227'completefunc' The name of a function used for user-specified Insert
228 mode completion. CTRL-X CTRL-U can be used in Insert
229 mode to do any kind of completion. (Taro Muraoka)
230'quoteescape' Characters used to escape quotes inside a string.
231 Used for the a", a' and a` text objects. |a'|
Bram Moolenaar592e0a22004-07-03 16:05:59 +0000232'numberwidth' Minimal width of the space used for the 'number'
233 option. (Emmanuel Renieris)
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000234'mzquantum' Time in msec to schedule MzScheme threads.
Bram Moolenaar8299df92004-07-10 09:47:34 +0000235'printmbcharset' CJK character set to be used for :hardcopy
236'printmbfont' font names to be used for CJK output of :hardcopy
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000237'fsync' Whether fsync() is called after writing a file.
238 (Ciaran McCreesh)
Bram Moolenaarb5bf5b82004-12-24 14:35:23 +0000239'wildoptions' "tagfile" value enables listing the file name of
240 matching tags for CTRL-D command line completion.
241 (based on an idea from Yegappan Lakshmanan)
Bram Moolenaar86b68352004-12-27 21:59:20 +0000242'formatlistpat' pattern to recognize a numbered list for formatting.
243 (idea by Hugo Haas)
244
Bram Moolenaar071d4272004-06-13 20:20:40 +0000245
246Ex commands: ~
247
Bram Moolenaar843ee412004-06-30 16:16:41 +0000248Win32: The ":winpos" command now also works in the console. (Vipin Aravind)
249
Bram Moolenaar8299df92004-07-10 09:47:34 +0000250|:startreplace| Start Replace mode. (Charles Campbell)
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000251
Bram Moolenaar8299df92004-07-10 09:47:34 +0000252|:0file| Removes the name of the buffer. (Charles Campbell)
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000253
Bram Moolenaar2df6dcc2004-07-12 15:53:54 +0000254|:diffoff| Switch off diff mode in the current window or in all
255 windows.
256
Bram Moolenaard4755bb2004-09-02 19:12:26 +0000257|:keepalt| Do not change the alternate file.
258
Bram Moolenaarc0197e22004-09-13 20:26:32 +0000259|:delmarks| Delete marks.
260
Bram Moolenaar7b0294c2004-10-11 10:16:09 +0000261|:sandbox| Command modifier: execute the argument in the sandbox.
262
Bram Moolenaarb5bf5b82004-12-24 14:35:23 +0000263|:exusage| Help for Ex commands (Nvi command).
264
265|:viusage| Help for Vi commands (Nvi command).
266
Bram Moolenaar86b68352004-12-27 21:59:20 +0000267|:cbuffer| Read error lines from a buffer. (partly by Yegappan
268 Lakshmanan)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000269
270New functions: ~
271
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000272|add()| append an item to a List
273|append()| append List of lines to the buffer
274|browsedir()| Dialog to select a directory.
275|byteidx()| Index of a character. (Ilya Sher)
276|call()| call a function with List as arguments
277|copy()| make a shallow copy of a List or Dictionary
278|count()| count nr of times a value is in a List or Dictionary
279|deepcopy()| make a full copy of a List or Dictionary
280|empty()| check if List or Dictionary is empty
Bram Moolenaar05159a02005-02-26 23:04:13 +0000281|errorlist()| list of quickfix errors
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000282|extend()| append one List to another or add items from one
283 Dictionary to another
284|filter()| remove selected items from a List or Dictionary
285|finddir()| Find a directory in 'path'.
286|findfile()| Find a file in 'path'. (Johannes Zellner)
287|foldtextresult()| The text displayed for a closed fold at line "lnum".
288|function()| make a Funcref out of a function name
289|get()| get an item from a List or Dictionary
290|getfontname()| Get actual font name being used.
291|getfperm()| Get file permission string. (Nikolai Weibull)
292|getftype()| Get type of file. (Nikolai Weibull)
Bram Moolenaar05159a02005-02-26 23:04:13 +0000293|getline()| With second argument: get List with buffer lines
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000294|has_key()| check whether a key appears in a Dictionary
295|insert()| insert an item somewhere in a List
296|items()| get List of Dictionary key-value pairs
297|join()| join List items into a String
298|keys()| get List of Dictionary keys
299|len()| number of items in a List or Dictionary
300|map()| change each List or Dictionary item
Bram Moolenaar2a8d1f82005-02-05 21:43:56 +0000301|matchlist()| list with match and submatches of a pattern in a string
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000302|max()| maximum value in a List or Dictionary
303|min()| minimum value in a List or Dictionary
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000304|mkdir()| create a directory
Bram Moolenaar2a8d1f82005-02-05 21:43:56 +0000305|readfile()| read a file into a list of lines
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000306|remove()| remove one or more items from a List or Dictionary
307|repeat()| Repeat "expr" "count" times. (Christophe Poucet)
308|reverse()| reverse the order of a List
309|sort()| sort a List
310|split()| split a String into a List
311|string()| String representation of a List or Dictionary
312|system()| Filters {input} through a shell command.
313|tr()| Translate characters. (Ron Aaron)
314|values()| get List of Dictionary values
Bram Moolenaar2a8d1f82005-02-05 21:43:56 +0000315|writefile()| write a list of lines into a file
Bram Moolenaar8299df92004-07-10 09:47:34 +0000316
Bram Moolenaarbee0c5b2005-02-07 22:03:36 +0000317User defined functions can now be loaded automatically from the "autoload"
318directory in 'runtimepath'. See |autoload-functions|.
319
Bram Moolenaar071d4272004-06-13 20:20:40 +0000320
321New autocommand events: ~
322
Bram Moolenaar8299df92004-07-10 09:47:34 +0000323|InsertEnter| starting Insert or Replace mode
324|InsertChange| going from Insert to Replace mode or back
325|InsertLeave| leaving Insert or Replace mode
Bram Moolenaar843ee412004-06-30 16:16:41 +0000326
Bram Moolenaar8299df92004-07-10 09:47:34 +0000327|ColorScheme| after loading a color scheme
Bram Moolenaarbee0c5b2005-02-07 22:03:36 +0000328|QuickFixCmdPre| before :make, :grep et al. (Ciaran McCreesh)
329|QuickFixCmdPost| after :make, :grep et al. (Ciaran McCreesh)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000330
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +0000331
Bram Moolenaarc0197e22004-09-13 20:26:32 +0000332New items in search patterns: ~
333|/\%d| \%d123 search for character with decimal number
334|/\]| [\d123] idem, in a colletion
335|/\%o| \%o103 search for character with octal number
336|/\]| [\o1o3] idem, in a colletion
337|/\%x| \%x1a search for character with 2 pos. hex number
338|/\]| [\x1a] idem, in a colletion
339|/\%u| \%u12ab search for character with 4 pos. hex number
340|/\]| [\u12ab] idem, in a colletion
341|/\%U| \%U1234abcd search for character with 8 pos. hex number
342|/\]| [\U1234abcd] idem, in a colletion
343 (The above partly by Ciaran McCreesh)
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000344|/[=| [[=a=]] an equivalence class (only for latin1 characters)
345|/[.| [[.a.]] a collation element (only works with single char)
346
347Nesting |/multi| items no longer is an error when an empty match is possible.
348
349It is now possible to use \{0}, it matches the preceding atom zero times. Not
350useful, just for compatibility.
Bram Moolenaarc0197e22004-09-13 20:26:32 +0000351
352
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +0000353New Syntax/Indent/FTplugin files: ~
354
355MuPAD source syntax, indent and ftplugin. (Dave Silvia)
356
Bram Moolenaard4755bb2004-09-02 19:12:26 +0000357ABAB/4 syntax file. (Marius van Wyk)
358
359SQL-Informix syntax file. (Dean L Hill)
360
Bram Moolenaar15d0a8c2004-09-06 17:44:46 +0000361PHP compiler plugin. (Doug Kearns)
362
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000363Sive syntax file. (Nikolai Weibull)
364
Bram Moolenaar15d0a8c2004-09-06 17:44:46 +0000365
Bram Moolenaar47136d72004-10-12 20:02:24 +0000366New Keymaps: ~
367
368Sinhala (Sri Lanka) (Harshula Jayasuriya)
369
370
Bram Moolenaar15d0a8c2004-09-06 17:44:46 +0000371New message translations: ~
372
373The Ukranian messages are now also available in cp1251.
374
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000375Irish message translations. (Kevin Patrick Scannell)
376
Bram Moolenaar05159a02005-02-26 23:04:13 +0000377Vietnamese message translations and menu. (Phan Vinh Thinh)
378
Bram Moolenaar071d4272004-06-13 20:20:40 +0000379
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000380Others: ~
381
382Mac: Add the selection type to the clipboard, so that Block, line and
383character selections can be used between two Vims. (Eckehard Berns)
384Also fixes the problem that setting 'clipboard' to "unnamed" breaks using
385"yyp".
Bram Moolenaar071d4272004-06-13 20:20:40 +0000386
Bram Moolenaar592e0a22004-07-03 16:05:59 +0000387Mac: GUI font selector. (Peter "Rain Dog" Cucka)
388
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000389Mac: support for multi-byte characters. (Da Woon Jung)
390
Bram Moolenaar2079a602005-01-04 21:43:22 +0000391GUI font selector for Motif. (Marcin Dalecki)
Bram Moolenaar567e4de2004-12-31 21:01:02 +0000392
Bram Moolenaarbee0c5b2005-02-07 22:03:36 +0000393Nicer toolbar buttons for Motif. (Marcin Dalecki)
394
Bram Moolenaar2079a602005-01-04 21:43:22 +0000395Mnemonics for the Motif find/replace dialog. (Marcin Dalecki)
Bram Moolenaar567e4de2004-12-31 21:01:02 +0000396
Bram Moolenaar46c9c732004-12-12 11:37:09 +0000397Mac: better integration with Xcode. Post a fake mouse-up event after the odoc
398event and the drag receive handler to work around a stall after Vim loads a
399file. Fixed an off-by-one line number error. (Da Woon Jung)
400
Bram Moolenaar843ee412004-06-30 16:16:41 +0000401The netrw plugin now also supports viewing a directory, when "scp://" is used.
402Deleting and renaming files is possible. (Charles Campbell)
403
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000404Added the t_SI and t_EI escape sequences for starting and ending Insert mode.
405To be used to set the cursor shape to a bar or a block. No default values,
406they are not supported by termcap/terminfo.
407
Bram Moolenaarb5bf5b82004-12-24 14:35:23 +0000408Autocommands can be defined local to a buffer. This means they will also work
409when the buffer does not have a name or no specific name. See
410|autocmd-buflocal|. (Yakov Lerner)
411
Bram Moolenaar071d4272004-06-13 20:20:40 +0000412==============================================================================
413IMPROVEMENTS *improvements-7*
414
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000415":helpgrep" accepts a language specifier after the pattern: "pat@it".
416
Bram Moolenaar8299df92004-07-10 09:47:34 +0000417Move the help for printing to a separate help file. It's quite a lot now.
418
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000419":breakadd here" and ":breakdel here" can be used to set or delete a
420breakpoint at the cursor.
421
Bram Moolenaar843ee412004-06-30 16:16:41 +0000422The tutor was updated to make it simpler to use and added text to explain a
423few more important commands. Used ideas from Gabriel Zachmann.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000424
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +0000425Unix: When libcall() fails obtain an error message with dlerror() and display
426it. (Johannes Zellner)
427
Bram Moolenaar592e0a22004-07-03 16:05:59 +0000428Added "nbsp" in 'listchars'. (David Blanchet)
429
Bram Moolenaar21cf8232004-07-16 20:18:37 +0000430Added the "acwrite" value for the 'buftype' option. This is for a buffer that
431doesn not have a name that refers to a file and is written with BufWriteCmd
432autocommands.
433
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000434For lisp indenting and matching parenthesis: (Sergey Khorev)
435- square brackets are recognized properly
436- #\(, #\), #\[ and #\] are recognized as character literals
437- Lisp line comments (delimited by semicolon) are recognized
438
Bram Moolenaar89cb5e02004-07-19 20:55:54 +0000439Added the "count" argument to match(), matchend() and matchstr(). (Ilya Sher)
440
Bram Moolenaar5eb86f92004-07-26 12:53:41 +0000441winnr() takes an optional "$" and "#" arguments. (Nikolai Weibull, Yegappan
442Lakshmanan)
443
444Added 'n' flag to search(): don't move the cursor. (Nikolai Weibull)
445
Bram Moolenaard4755bb2004-09-02 19:12:26 +0000446When uncompressing fails in the gzip plugin, give an error message but don't
447delete the raw text. Helps if the file has a .gz extension but is not
448actually compressed. (Andrew Pimlott)
449
450When C, C++ or IDL syntax is used, may additionally load doxygen syntax.
451Also support setting the filetype to "cdoxygen" for C plus doxygen syntax.
452(Michael Geddes)
453
454The ":registers" command now displays multi-byte characters properly.
455
456VMS: In the usage message mention that a slash can be used to make a flag
457upper case. Add color support to the builtin vt320 terminal codes.
458(Zoltan Arpadffy)
459
Bram Moolenaar15d0a8c2004-09-06 17:44:46 +0000460For the '%' item in 'viminfo', allow a number to set a maximum for the number
461of buffers.
462
Bram Moolenaarb5bf5b82004-12-24 14:35:23 +0000463The 'statusline' option can be local to the window, so that each window can
464have a different value. (partly by Yegappan Lakshmanan)
465
Bram Moolenaar3fdfa4a2004-10-07 21:02:47 +0000466When a file looks like a shell script, check for an "exec" command that starts
467the tcl interpreter. (suggested by Alexios Zavras)
468
469Support conversion between utf-8 and latin9 (iso-8859-15) internally, so that
470digraphs still work when iconv is not available.
471
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000472When a session file is loaded while editing an unnamed, empty buffer that
473buffer is wiped out. Avoids that there is an unused buffer in the buffer
474list.
475
476Win32: When libintl.dll supports bind_textdomain_codeset(), use it.
477(NAKADAIRA Yukihiro)
478
479When foldtext() finds no text after removing the comment leader, use the
480second line of the fold. Helps for C-style /* */ comments where the first
481line is just "/*".
482
Bram Moolenaar1cd871b2004-12-19 22:46:22 +0000483When editing the same file from two systems (e.g., Unix and MS-Windows) there
484mostly was no warning for an existing swap file, because the name of the
485edited file differs (e.g., y:\dir\file vs /home/me/dir/file). Added a flag to
486the swap file to indicate it is in the same directory as the edited file. The
487used path then doesn't matter and the check for editing the same file is much
488more reliable.
489
490Client-server communication now supports 'encoding'. When setting 'encoding'
491in a Vim server to "utf-8", and using "vim --remote fname" in a console,
492"fname" is converted from the console encoding to utf-8. Also allows Vims
493with different 'encoding' settings to exchange messages.
494
Bram Moolenaar86b68352004-12-27 21:59:20 +0000495Internal: Changed ga_room into ga_maxlen, so that it doesn't need to be
496incremented/decremented each time.
497
Bram Moolenaar2079a602005-01-04 21:43:22 +0000498Included a few improvements for Motif from Marcin Dalecki. Draw label
Bram Moolenaar567e4de2004-12-31 21:01:02 +0000499contents ourselves to make them handle fonts in a way configurable by Vim and
500a bit less dependent on the X11 font management.
501
Bram Moolenaar49cd9572005-01-03 21:06:01 +0000502When a register is empty it is not stored in the viminfo file.
503
Bram Moolenaar8c711452005-01-14 21:53:12 +0000504Removed the tcltags script, it's obsolete.
505
Bram Moolenaardcaf10e2005-01-21 11:55:25 +0000506":redir @*>" and ":redir @+>" append to the clipboard. Better check for
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000507invalid characters after the register name. |:redir|
508
509":redir => variable" and ":redir =>> variable" write or append to a variable.
510(Yegappan Lakshmanan) |:redir|
Bram Moolenaardcaf10e2005-01-21 11:55:25 +0000511
512":let g:" lists global variables.
513":let b:" lists buffer-local variables.
514":let w:" lists window-local variables.
515":let v:" lists Vim variables.
516
Bram Moolenaard438e912005-01-31 19:21:46 +0000517The stridx() and strridx() functions take a third argument, where to start
518searching. (Yegappan Lakshmanan)
Bram Moolenaarb71ec9f2005-01-25 22:22:02 +0000519
Bram Moolenaarbee0c5b2005-02-07 22:03:36 +0000520g CTRL-G also shows the number of characters if it differs from the number of
521bytes.
522
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000523Completion for ":debug" and entering an expression for the '=' register. Skip
524":" between range and command name. (Peter winters)
525
526CTRL-Q in Insert mode now works like CTRL-V by default. Previously it was
527ignored.
528
529When "beep" is included in 'debug' a function or script that causes a beep
530will result in a message with the source of the error.
531
Bram Moolenaar05159a02005-02-26 23:04:13 +0000532When completing buffer names, match with "\(^\|[\/]\)" instead of "^", so that
533":buf stor<Tab>" finds both "include/storage.h" and "storage/main.c".
534
535To count items (pattern matches) without changing the buffer the 'n' flag has
536been added to |:substitute|. See |count-items|.
537
Bram Moolenaar071d4272004-06-13 20:20:40 +0000538==============================================================================
539COMPILE TIME CHANGES *compile-changes-7*
540
Bram Moolenaar2079a602005-01-04 21:43:22 +0000541Dropped the support for the BeOS and Amiga GUI. They were not maintained and
542probably didn't work. If you want to work on this: get the Vim 6.x version
543and merge it back in.
544
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000545Mac: "make" now creates the Vim.app directory and "make install" copies it to
546its final destination. (Raf)
547
548Mac: Made it possible to compile with Motif, Athena or GTK without tricks and
549still being able to use the MacRoman conversion. Added the os_mac_conv.c
550file.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000551
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000552When running the tests and one of them fails to produce "test.out" the
553following tests are still executed. This helps when running out of memory.
554
Bram Moolenaar071d4272004-06-13 20:20:40 +0000555==============================================================================
556BUG FIXES *bug-fixes-7*
557
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000558When using PostScript printing on MS-DOS the default 'printexpr' used "lpr"
559instead of "copy". When 'printdevice' was empty the copy command did not
560work. Use "LPT1" then.
561
562The GTK font dialog uses a font size zero when the font name doesn't include a
563size. Use a default size of 10.
564
565This example in the documentation didn't work:
566 :e `=foo . ".c" `
567Skip over the expression in `=expr` when looking for comments, |, % and #.
568
569When ":helpgrep" doesn't find anything there is no error message.
570
571"L" and "H" did not take closed folds into account.
572
573Win32: The "-P title" argument stopped at the first title that matched, even
574when it doesn't support MDI.
575
576Mac GUI: CTRL-^ and CTRL-@ did not work.
577
578"2daw" on "word." at the end of a line didn't include the preceding white
579space.
580
581Win32: Using FindExecutable() doesn't work to find a program. Use
582SearchPath() instead. For executable() use $PATHEXT when the program searched
583for doesn't have an extension.
584
585When 'virtualedit' is set, moving the cursor up after appending a character
586may move it to a different column. Was caused by auto-formatting moving the
587cursor and not putting it back where it was.
588
589When indent was added automatically and then moving the cursor, the indent was
590not deleted (like when pressing ESC). The "I" flag in 'cpoptions' can be used
591to make it work the old way.
592
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000593When opening a command-line window, 'textwidth' gets set to 78 by the Vim
594filetype plugin. Reset 'textwidth' to 0 to avoid lines are broken.
595
596After using cursor(line, col) moving up/down doesn't keep the same column.
597
598Win32: Borland C before 5.5 requires using ".u." for LowPart and HighPart
599fields. (Walter Briscoe)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000600
Bram Moolenaar843ee412004-06-30 16:16:41 +0000601On Sinix SYS_NMLN isn't always defined. Define it ourselves. (Cristiano De
602Michele)
603
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000604Printing with PostScript may keep the printer waiting for more. Append a
605CTRL-D to the printer output. (Mike Williams)
606
Bram Moolenaar2df6dcc2004-07-12 15:53:54 +0000607When converting a string with a hex or octal number the leading '-' was
608ignored. ":echo '-05' + 0" resulted in 5 instead of -5.
609
610Using "@:" to repeat a command line didn't work when it contains control
611characters.
612
Bram Moolenaar21cf8232004-07-16 20:18:37 +0000613When using file completion for a user command, it would not expand environment
614variables like for a regular command with a file argument.
615
616'cindent': When the argument of a #define looks like a C++ class the next line
617is indented too much.
618
619When 'comments' includes multi-byte characters inserting the middle part and
620alignment may go wrong. 'cindent' also suffers from this for right-aligned
621items.
622
Bram Moolenaar05159a02005-02-26 23:04:13 +0000623Win32: when 'encoding' is set to "utf-8" getenv() still returns strings in the
624active codepage. Convert to utf-8. Also for $HOME.
625
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000626The default for 'helplang' was "zh" for both "zh_cn" and "zh_tw". Now use
627"cn" or "tw" as intended.
628
Bram Moolenaar5eb86f92004-07-26 12:53:41 +0000629When 'bin' is set and 'eol' is not set then line2byte() added the line break
630after the last line while it's not there.
631
632Using foldlevel() in a WinEnter autocommand may not work. Noticed when
633resizing the GUI shell upon startup.
634
635Python: Using buffer.append(f.readlines()) didn't work. Allow appending a
636string with a trailing newline. The newline is ignored.
637
Bram Moolenaar269ec652004-07-29 08:43:53 +0000638When using the ":saveas f2" command for buffer "f1", the Buffers menu would
639contain "f2" twice, one of them leading to "f1". Also trigger the BufFilePre
640and BufFilePost events for the alternate buffer that gets the old name.
641
Bram Moolenaard4755bb2004-09-02 19:12:26 +0000642strridx() did not work well when the needle is empty. (Ciaran McCreesh)
643
644GTK: Avoid a potential hang in gui_mch_wait_for_chars() when input arrives
645just before it is invoked
646
647VMS: Occasionally CR characters were inserted in the file. Expansion of
648environment variables was not correct. (Zoltan Arpadffy)
649
650UTF-8: When 'delcombine' is set "dw" only deleted the last combining character
651from the first character of the word.
652
653When using ":sball" in an autocommand only the filetype in one buffer was
654detected. Reset did_filetype in enter_buffer().
655
656When using ":argdo" and the window already was at the first argument index,
657but not actually editing it, the current buffer would be used instead.
658
Bram Moolenaar15d0a8c2004-09-06 17:44:46 +0000659When ":next dir/*" includes many matches, adding the names to the argument
660list may take an awful lot of time and can't be interrupted. Allow
661interrupting this.
662
663When editing a file that was already loaded in a buffer, modelines were not
664used. Now window-local options in the modeline are set. Buffer-local options
665and global options remain unmodified.
666
667Win32: When 'encoding' is set to "utf-8" in the vimrc file, files from the
668command line with non-ASCII characters are not used correctly. Recode the
669file names when 'encoding' is set, using the Unicode command line.
670
Bram Moolenaarc0197e22004-09-13 20:26:32 +0000671Win32 console: When the default for 'encoding' ends up to be "latin1", the
672default value of 'isprint' was wrong.
673
674When an error message is given while waiting for a character (e.g., when an
675xterm reports the number of colors), the hit-enter prompt overwrote the last
676line. Don't reset msg_didout in normal_cmd() for K_IGNORE.
677
Bram Moolenaar3fdfa4a2004-10-07 21:02:47 +0000678Mac GUI: Shift-Tab didn't work.
679
680When defining tooltip text, don't translate terminal codes, since it's not
681going to be used like a command.
682
683GTK 2: Check the tooltip text for valid utf-8 characters to avoid getting a
684GTK error. Invalid characters may appear when 'encoding' is changed.
685
686GTK 2: Add a safety check for invalid utf-8 sequences, they can crash pango.
687
688Win32: When 'encoding' is changed while starting up, use the Unicode command
689line to convert the file arguments to 'encoding'. Both for the GUI and the
690console version.
691
692Win32 GUI: latin9 text (iso-8859-15) was not displayed correctly, because
693there is no codepage for latin9. Do our own conversion from latin9 to UCS2.
694
Bram Moolenaar7b0294c2004-10-11 10:16:09 +0000695When two versions of GTK+ 2 are installed it was possible to use the header
696files from one and the library from the other. Use GTK_LIBDIR to put the
697directory for the library early in the link flags.
698
699With the GUI find/replace dialog a replace only worked if the pattern was
700literal text. Now it works for any pattern.
701
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000702When 'equalalways' is set and 'eadirection' is "hor", ":quit" would still
703cause equalizing window heights in the vertical direction.
704
705When ":emenu" is used in a startup script the command was put in the typeahead
706buffer, causing a prompt for the crypt key to be messed up.
707
708Mac OS/X: The default for 'isprint' included characters 128-160, causes
709problems for Terminal.app.
710
711When a syntax item with "containedin" is used, it may match in the start or
712end of a region with a matchgroup, while this doesn't happen for a "contains"
713argument.
714
715When a transparent syntax items matches in another item where the highlighting
716has already stopped (because of a he= argument), the highlighting would come
717back.
718
719When cscope is used to set the quickfix error list, it didn't get set if there
720was only one match. (Sergey Khorev)
721
722When 'confirm' is set and using ":bdel" in a modified buffer, then selecting
723"cancel", would still give an error message.
724
725The PopUp menu items that started Visual mode didn't work when not in Normal
726mode. Switching between selecting a word and a line was not possible.
727
728Win32: The keypad decimal point always resulted in a '.', while on some
729keyboards it's a ','. Use MapVirtualKey(VK_DECIMAL, 2).
730
731Removed unused function DisplayCompStringOpaque() from gui_w32.c
732
733In Visual mode there is not always an indication whether the line break is
734selected or not. Highlight the character after the line when the line break
735is included, e.g., after "v$o".
736
737GTK: The <F10> key can't be mapped, it selects the menu. Disable that with a
738GTK setting and do select the menu when <F10> isn't mapped. (David Necas)
739
740After "Y" '[ and '] were not at start/end of the yanked text.
741
742When a telnet connection is dropped Vim preserves files and exits. While
743doing that a SIGHUP may arrive and disturbe us, thus ignore it. (Scott
Bram Moolenaar46c9c732004-12-12 11:37:09 +0000744Anderson) Also postpone SIGHUP, SIGQUIT and SIGTERM until it's safe to
745handle. Added handle_signal().
746
747When using "set laststatus=2 cmdheight=2" in the .gvimrc you may only get one
748line for the cmdline. (Christian Robinson) Invoke command_height() after the
749GUI has started up.
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000750
Bram Moolenaar1cd871b2004-12-19 22:46:22 +0000751When completing a file name on the command line backslashes are required for
752white space. Was only done for a space, not for a Tab.
753
754When configure could not find a terminal library, compiling continued for a
755long time before reporting the problem. Added a configure check for tgetent()
756being found in a library.
757
758When the cursor is on the first char of the last line a ":g/pat/s///" command
759may cause the cursor to be displayed below the text.
760
761Win32: Editing a file with non-ASCII characters doesn't work when 'encoding'
762is "utf-8". use _wfullpath() instead of _fullpath(). (Yu-sung Moon)
763
764When recovering the 'fileformat' and 'fileencoding' were taken from the
765original file instead of from the swapfile. When the file didn't exist, was
766empty or the option was changed (e.g., with ":e ++fenc=cp123 file") it could
767be wrong. Now store 'fileformat' and 'fileencoding' in the swapfile and use
768the values when recovering.
769
770":bufdo g/something/p" overwrites each last printed text line with the file
771message for the next buffer. Temporarily clear 'shortmess' to avoid that.
772
Bram Moolenaarb5bf5b82004-12-24 14:35:23 +0000773Win32: Cannot edit a file starting with # with --remote. Do escape % and #
774when building the ":drop" command.
775
Bram Moolenaar86b68352004-12-27 21:59:20 +0000776A comment or | just after a expresion-backtick argument was not recognized.
777E.g. in :e `="foo"`"comment.
778
Bram Moolenaar567e4de2004-12-31 21:01:02 +0000779"(" does not stop at an empty sentence (single dot and white space) while ")"
780does. Also breaks "das" on that dot.
781
782When doing "yy" with the cursor on a TAB the ruler could be wrong and "k"
783moved the cursor to another column.
784
785When 'commentstring' is '"%s' and there is a double quote in the line a double
786quote before the fold marker isn't removed in the text displayed for a closed
787fold.
788
789In Visual mode, when 'bin' and 'eol' set, g CTRL-G counted the last line
790break, resulting in "selected 202 of 201 bytes".
791
Bram Moolenaar2079a602005-01-04 21:43:22 +0000792Motif: fonts were not used for dialog components. (Marcin Dalecki)
Bram Moolenaar567e4de2004-12-31 21:01:02 +0000793
Bram Moolenaar49cd9572005-01-03 21:06:01 +0000794Motif: After using a toolbar button the keyboard focus would be on the toolbar
Bram Moolenaar2079a602005-01-04 21:43:22 +0000795(Lesstif problem). (Marcin Dalecki)
Bram Moolenaar49cd9572005-01-03 21:06:01 +0000796
Bram Moolenaar1c2fda22005-01-02 11:43:19 +0000797When using "y<C-V>`x" where mark x is in the first column, the last line was
798not included.
799
800Not all test scripts work properly on MS-Windows when checked out from CVS.
801Use a Vim command to fix all fileformats to dos before executing the tests.
802
803When using ":new" and the file fits in the window, lines could still be above
804the window. Now remove empty lines instead of keeping the relative position.
805
Bram Moolenaar3d60ec22005-01-05 22:19:46 +0000806Cmdline completion didn't work after ":let var1 var<Tab>".
807
Bram Moolenaarb7d6e722005-01-09 21:22:45 +0000808When using ":startinsert" or ":startreplace" when already in Insert mode
809(possible when using CTRL-R =), pressing Esc would directly restart Insert
810mode. (Peter Winters)
811
Bram Moolenaar31c67ef2005-01-11 21:34:41 +0000812"2daw" didn't work at end of file if the last word is a single character.
813
Bram Moolenaar8c711452005-01-14 21:53:12 +0000814Completion for ":next a'<Tab>" put a backslash before single quote, but it was
815not removed when editing a file. Now halve backslashes in save_patterns().
Bram Moolenaar798c5a72005-01-16 22:06:30 +0000816Also fix expanding a file name with the shell that contains "\'".
Bram Moolenaar8c711452005-01-14 21:53:12 +0000817
Bram Moolenaarb71ec9f2005-01-25 22:22:02 +0000818When doing "1,6d|put" only "fewer lines" was reported. Now a following "more
819lines" overwrites the message.
820
821Configure could not handle "-Dfoo=long\ long" in the TCL config output.
822
Bram Moolenaarb2956cd2005-01-27 14:42:53 +0000823When searching backwards, using a pattern that matches a newline and uses \zs
824after that, didn't find a match. Could also get a hang or end up in the right
825column in the wrong line.
826
Bram Moolenaard438e912005-01-31 19:21:46 +0000827When $LANG is "sl" for slovenian, the slovak menu was used, since "slovak"
828starts with "sl".
829
830When 'paste' is set in the GUI the Paste toolbar button doesn't work. Clear
831'paste' when starting the GUI.
832
Bram Moolenaarf5836682005-02-02 23:09:45 +0000833A message about a wrong viminfo line included the trailing NL.
834
Bram Moolenaar2a8d1f82005-02-05 21:43:56 +0000835When 'paste' is set in the GUI the toolbar button doesn't work in Insert mode.
836Use ":exe" in menu.vim to avoid duplicating the commands, instead of using a
837mapping.
838
839Treat "mlterm" as an xterm-like terminal. (Seiichi Sato)
840
841":z.4" and ":z=4" didn't work Vi compatible.
842
Bram Moolenaarbee0c5b2005-02-07 22:03:36 +0000843When sourcing a file, editing it and sourcing it again, it could appear twice
844in ":scriptnames" and get a new <SID>, because the inode has changed.
845
846When $SHELL is set but empty the 'shell' option would be empty. Don't use an
847empty $SHELL value.
848
849A command "w! file" in .vimrc or $EXINIT didn't work. Now it writes an empty
850file.
851
852When a CTRL-F command at the end of the file failed, the cursor was still
853moved to the start of the line. Now it remains where it is.
854
855When using ":s" or "&" to repeat the last substitute and "$" was used to put
856the cursor in the last column, put the cursor in the last column again. This
857is Vi compatible.
858
Bram Moolenaar4399ef42005-02-12 14:29:27 +0000859Vim is not fully POSIX compliant but sticks with traditional Vi behavior.
860Added a few flags in 'cpoptions' to behave the POSIX way when wanted. The
861$VIM_POSIX environment variable is checked to set the default.
862
863Appending to a register didn't insert a line break like Vi. Added the '>'
864flag to 'cpoptions' for this.
865
866Using "I" in a line with only blanks appended to the line. This is not Vi
867compatible. Added the 'H' flag in 'coptions' for this.
868
869When joining multiple lines the cursor would be at the last joint, but Vi
870leaves it at the position where "J" would put it. Added the 'q' flag in
871'cpoptions' for this.
872
873Autoindent didn't work for ":insert" and ":append".
874
875Using ":append" in an empty buffer kept the dummy line. Now it's deleted to
876be Vi compatible.
877
878When reading commands from a file and stdout goes to a terminal, would still
879request the xterm version. Vim can't read it, thus the output went to the
880shell and caused trouble there.
881
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000882When redirecting to a register with an invalid name the redirection would
883still be done (after an error message). Now reset "redir_reg". (Yegappan
884Lakshmanan)
885
886It was not possible to use a NL after a backslash in Ex mode. This is
887sometimes used to feed multiple lines to a shell command.
888
Bram Moolenaar05159a02005-02-26 23:04:13 +0000889When 'cmdheight' is set to 2 in .vimrc and the GUI uses the number of lines
890from the terminal we actually get 3 lines for the cmdline in gvim.
891
892When setting $HOME allocated memory would leak.
893
Bram Moolenaar071d4272004-06-13 20:20:40 +0000894 vim:tw=78:ts=8:ft=help:norl: