blob: 38133641f81462498ea161cd28178c323ab53c6c [file] [log] [blame]
Bram Moolenaar5313dcb2005-02-22 08:56:13 +00001*version7.txt* For Vim version 7.0aa. Last change: 2005 Feb 21
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
164
Bram Moolenaar4399ef42005-02-12 14:29:27 +0000165POSIX compatibility *new-posix*
166-------------------
167
168The POSIX test suite was used to verify POSIX compatibility. A number of
169problems have been fixed to make Vim more POSIX compatible. Some of them
170conflict with traditional Vi or expected behavior. The $VIM_POSIX environment
171variable can be set to get POSIX compatibility. See |posix|.
172
173Items that were fixed for both Vi and POSIX compatibilty:
174- repeating "R" with a count only overwrites text once; added the 'X' flag to
175 'cpoptions' |cpo-X|
176- a vertical movement command that moves to a non-existing line fails; added
177 the '-' flag to 'cpoptions' |cpo--|
178- when preserving a file and doing ":q!" the file can be recovered; added the
179 '&' flag to 'cpoptions' |cpo-&|
180- The 'window' option is partly implemented. It specifies how much CTRL-F and
181 CTRL-B scroll when there is one window. The "-w {number}" argument is now
182 accepted. "-w {scriptout}" only works when {scriptout} doesn't start with a
183 digit.
184- Allow "-c{command}" argument, no space between "-c" and {command}.
185- When writing a file with ":w!" don't reset 'readonly' when 'Z' is present in
186 'cpoptions'.
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000187- Allow 'l' and '#' flags for ":list", ":print" and ":number".
188- Added the '.' flag to 'cpoptions': ":cd" fails when the buffer is modified.
189- In Ex mode with an empty buffer ":read file" doesn't keep an empty line
190 above or below the new lines.
191- Remove a backslash before a NL for the ":global" command.
192- When ":append", ":insert" or ":change" is used with ":global", get the
193 inserted lines from the command. Can use backslash-NL to separate lines.
194- Can use ":global /pat/ visual" to execute Normal mode commands at each
195 matched line. Use "Q" to continue and go to the next line.
196- The |:open| command has been partially implemented. It stops Ex mode, but
197 redraws the whole screen, not just one line as open mode is supposed to do.
198- Support using a pipe to read the output from and write input to an external
199 command. Added the 'shelltemp' option and has("filterpipe").
200- In ex silent mode the ":set" command output is displayed.
201- The ":@@" and ":**" give an error message when no register was used before.
202- The search pattern "[]-`]" matches ']', '^', '_' and '`'.
203- Autoindent for ":insert" is using the line below the insert.
204- Autoindent for ":change" is using the first changed line.
205- Editing Ex command lines is not done in cooked mode, because CTRL-D and
206 CTRL-T cannot be handled then.
207- In Ex mode, "1,3" prints three lines.
208- Implemented the 'prompt' option.
Bram Moolenaar4399ef42005-02-12 14:29:27 +0000209
210
Bram Moolenaar071d4272004-06-13 20:20:40 +0000211Various new items *new-items-7*
212-----------------
213
214Normal mode commands: ~
215
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +0000216a", a' and a` New text objects to select quoted strings. |a'|
217i", i' and i' (Taro Muraoka)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000218
219Options: ~
220
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +0000221'completefunc' The name of a function used for user-specified Insert
222 mode completion. CTRL-X CTRL-U can be used in Insert
223 mode to do any kind of completion. (Taro Muraoka)
224'quoteescape' Characters used to escape quotes inside a string.
225 Used for the a", a' and a` text objects. |a'|
Bram Moolenaar592e0a22004-07-03 16:05:59 +0000226'numberwidth' Minimal width of the space used for the 'number'
227 option. (Emmanuel Renieris)
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000228'mzquantum' Time in msec to schedule MzScheme threads.
Bram Moolenaar8299df92004-07-10 09:47:34 +0000229'printmbcharset' CJK character set to be used for :hardcopy
230'printmbfont' font names to be used for CJK output of :hardcopy
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000231'fsync' Whether fsync() is called after writing a file.
232 (Ciaran McCreesh)
Bram Moolenaarb5bf5b82004-12-24 14:35:23 +0000233'wildoptions' "tagfile" value enables listing the file name of
234 matching tags for CTRL-D command line completion.
235 (based on an idea from Yegappan Lakshmanan)
Bram Moolenaar86b68352004-12-27 21:59:20 +0000236'formatlistpat' pattern to recognize a numbered list for formatting.
237 (idea by Hugo Haas)
238
Bram Moolenaar071d4272004-06-13 20:20:40 +0000239
240Ex commands: ~
241
Bram Moolenaar843ee412004-06-30 16:16:41 +0000242Win32: The ":winpos" command now also works in the console. (Vipin Aravind)
243
Bram Moolenaar8299df92004-07-10 09:47:34 +0000244|:startreplace| Start Replace mode. (Charles Campbell)
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000245
Bram Moolenaar8299df92004-07-10 09:47:34 +0000246|:0file| Removes the name of the buffer. (Charles Campbell)
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000247
Bram Moolenaar2df6dcc2004-07-12 15:53:54 +0000248|:diffoff| Switch off diff mode in the current window or in all
249 windows.
250
Bram Moolenaard4755bb2004-09-02 19:12:26 +0000251|:keepalt| Do not change the alternate file.
252
Bram Moolenaarc0197e22004-09-13 20:26:32 +0000253|:delmarks| Delete marks.
254
Bram Moolenaar7b0294c2004-10-11 10:16:09 +0000255|:sandbox| Command modifier: execute the argument in the sandbox.
256
Bram Moolenaarb5bf5b82004-12-24 14:35:23 +0000257|:exusage| Help for Ex commands (Nvi command).
258
259|:viusage| Help for Vi commands (Nvi command).
260
Bram Moolenaar86b68352004-12-27 21:59:20 +0000261|:cbuffer| Read error lines from a buffer. (partly by Yegappan
262 Lakshmanan)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000263
264New functions: ~
265
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000266|add()| append an item to a List
267|append()| append List of lines to the buffer
268|browsedir()| Dialog to select a directory.
269|byteidx()| Index of a character. (Ilya Sher)
270|call()| call a function with List as arguments
271|copy()| make a shallow copy of a List or Dictionary
272|count()| count nr of times a value is in a List or Dictionary
273|deepcopy()| make a full copy of a List or Dictionary
274|empty()| check if List or Dictionary is empty
275|extend()| append one List to another or add items from one
276 Dictionary to another
277|filter()| remove selected items from a List or Dictionary
278|finddir()| Find a directory in 'path'.
279|findfile()| Find a file in 'path'. (Johannes Zellner)
280|foldtextresult()| The text displayed for a closed fold at line "lnum".
281|function()| make a Funcref out of a function name
282|get()| get an item from a List or Dictionary
283|getfontname()| Get actual font name being used.
284|getfperm()| Get file permission string. (Nikolai Weibull)
285|getftype()| Get type of file. (Nikolai Weibull)
286|getline()| get List with buffer lines
287|has_key()| check whether a key appears in a Dictionary
288|insert()| insert an item somewhere in a List
289|items()| get List of Dictionary key-value pairs
290|join()| join List items into a String
291|keys()| get List of Dictionary keys
292|len()| number of items in a List or Dictionary
293|map()| change each List or Dictionary item
Bram Moolenaar2a8d1f82005-02-05 21:43:56 +0000294|matchlist()| list with match and submatches of a pattern in a string
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000295|max()| maximum value in a List or Dictionary
296|min()| minimum value in a List or Dictionary
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000297|mkdir()| create a directory
Bram Moolenaar2a8d1f82005-02-05 21:43:56 +0000298|readfile()| read a file into a list of lines
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000299|remove()| remove one or more items from a List or Dictionary
300|repeat()| Repeat "expr" "count" times. (Christophe Poucet)
301|reverse()| reverse the order of a List
302|sort()| sort a List
303|split()| split a String into a List
304|string()| String representation of a List or Dictionary
305|system()| Filters {input} through a shell command.
306|tr()| Translate characters. (Ron Aaron)
307|values()| get List of Dictionary values
Bram Moolenaar2a8d1f82005-02-05 21:43:56 +0000308|writefile()| write a list of lines into a file
Bram Moolenaar8299df92004-07-10 09:47:34 +0000309
Bram Moolenaarbee0c5b2005-02-07 22:03:36 +0000310User defined functions can now be loaded automatically from the "autoload"
311directory in 'runtimepath'. See |autoload-functions|.
312
Bram Moolenaar071d4272004-06-13 20:20:40 +0000313
314New autocommand events: ~
315
Bram Moolenaar8299df92004-07-10 09:47:34 +0000316|InsertEnter| starting Insert or Replace mode
317|InsertChange| going from Insert to Replace mode or back
318|InsertLeave| leaving Insert or Replace mode
Bram Moolenaar843ee412004-06-30 16:16:41 +0000319
Bram Moolenaar8299df92004-07-10 09:47:34 +0000320|ColorScheme| after loading a color scheme
Bram Moolenaarbee0c5b2005-02-07 22:03:36 +0000321|QuickFixCmdPre| before :make, :grep et al. (Ciaran McCreesh)
322|QuickFixCmdPost| after :make, :grep et al. (Ciaran McCreesh)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000323
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +0000324
Bram Moolenaarc0197e22004-09-13 20:26:32 +0000325New items in search patterns: ~
326|/\%d| \%d123 search for character with decimal number
327|/\]| [\d123] idem, in a colletion
328|/\%o| \%o103 search for character with octal number
329|/\]| [\o1o3] idem, in a colletion
330|/\%x| \%x1a search for character with 2 pos. hex number
331|/\]| [\x1a] idem, in a colletion
332|/\%u| \%u12ab search for character with 4 pos. hex number
333|/\]| [\u12ab] idem, in a colletion
334|/\%U| \%U1234abcd search for character with 8 pos. hex number
335|/\]| [\U1234abcd] idem, in a colletion
336 (The above partly by Ciaran McCreesh)
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000337|/[=| [[=a=]] an equivalence class (only for latin1 characters)
338|/[.| [[.a.]] a collation element (only works with single char)
339
340Nesting |/multi| items no longer is an error when an empty match is possible.
341
342It is now possible to use \{0}, it matches the preceding atom zero times. Not
343useful, just for compatibility.
Bram Moolenaarc0197e22004-09-13 20:26:32 +0000344
345
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +0000346New Syntax/Indent/FTplugin files: ~
347
348MuPAD source syntax, indent and ftplugin. (Dave Silvia)
349
Bram Moolenaard4755bb2004-09-02 19:12:26 +0000350ABAB/4 syntax file. (Marius van Wyk)
351
352SQL-Informix syntax file. (Dean L Hill)
353
Bram Moolenaar15d0a8c2004-09-06 17:44:46 +0000354PHP compiler plugin. (Doug Kearns)
355
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000356Sive syntax file. (Nikolai Weibull)
357
Bram Moolenaar15d0a8c2004-09-06 17:44:46 +0000358
Bram Moolenaar47136d72004-10-12 20:02:24 +0000359New Keymaps: ~
360
361Sinhala (Sri Lanka) (Harshula Jayasuriya)
362
363
Bram Moolenaar15d0a8c2004-09-06 17:44:46 +0000364New message translations: ~
365
366The Ukranian messages are now also available in cp1251.
367
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000368Irish message translations. (Kevin Patrick Scannell)
369
Bram Moolenaar071d4272004-06-13 20:20:40 +0000370
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000371Others: ~
372
373Mac: Add the selection type to the clipboard, so that Block, line and
374character selections can be used between two Vims. (Eckehard Berns)
375Also fixes the problem that setting 'clipboard' to "unnamed" breaks using
376"yyp".
Bram Moolenaar071d4272004-06-13 20:20:40 +0000377
Bram Moolenaar592e0a22004-07-03 16:05:59 +0000378Mac: GUI font selector. (Peter "Rain Dog" Cucka)
379
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000380Mac: support for multi-byte characters. (Da Woon Jung)
381
Bram Moolenaar2079a602005-01-04 21:43:22 +0000382GUI font selector for Motif. (Marcin Dalecki)
Bram Moolenaar567e4de2004-12-31 21:01:02 +0000383
Bram Moolenaarbee0c5b2005-02-07 22:03:36 +0000384Nicer toolbar buttons for Motif. (Marcin Dalecki)
385
Bram Moolenaar2079a602005-01-04 21:43:22 +0000386Mnemonics for the Motif find/replace dialog. (Marcin Dalecki)
Bram Moolenaar567e4de2004-12-31 21:01:02 +0000387
Bram Moolenaar46c9c732004-12-12 11:37:09 +0000388Mac: better integration with Xcode. Post a fake mouse-up event after the odoc
389event and the drag receive handler to work around a stall after Vim loads a
390file. Fixed an off-by-one line number error. (Da Woon Jung)
391
Bram Moolenaar843ee412004-06-30 16:16:41 +0000392The netrw plugin now also supports viewing a directory, when "scp://" is used.
393Deleting and renaming files is possible. (Charles Campbell)
394
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000395Added the t_SI and t_EI escape sequences for starting and ending Insert mode.
396To be used to set the cursor shape to a bar or a block. No default values,
397they are not supported by termcap/terminfo.
398
Bram Moolenaarb5bf5b82004-12-24 14:35:23 +0000399Autocommands can be defined local to a buffer. This means they will also work
400when the buffer does not have a name or no specific name. See
401|autocmd-buflocal|. (Yakov Lerner)
402
Bram Moolenaar071d4272004-06-13 20:20:40 +0000403==============================================================================
404IMPROVEMENTS *improvements-7*
405
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000406":helpgrep" accepts a language specifier after the pattern: "pat@it".
407
Bram Moolenaar8299df92004-07-10 09:47:34 +0000408Move the help for printing to a separate help file. It's quite a lot now.
409
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000410":breakadd here" and ":breakdel here" can be used to set or delete a
411breakpoint at the cursor.
412
Bram Moolenaar843ee412004-06-30 16:16:41 +0000413The tutor was updated to make it simpler to use and added text to explain a
414few more important commands. Used ideas from Gabriel Zachmann.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000415
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +0000416Unix: When libcall() fails obtain an error message with dlerror() and display
417it. (Johannes Zellner)
418
Bram Moolenaar592e0a22004-07-03 16:05:59 +0000419Added "nbsp" in 'listchars'. (David Blanchet)
420
Bram Moolenaar21cf8232004-07-16 20:18:37 +0000421Added the "acwrite" value for the 'buftype' option. This is for a buffer that
422doesn not have a name that refers to a file and is written with BufWriteCmd
423autocommands.
424
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000425For lisp indenting and matching parenthesis: (Sergey Khorev)
426- square brackets are recognized properly
427- #\(, #\), #\[ and #\] are recognized as character literals
428- Lisp line comments (delimited by semicolon) are recognized
429
Bram Moolenaar89cb5e02004-07-19 20:55:54 +0000430Added the "count" argument to match(), matchend() and matchstr(). (Ilya Sher)
431
Bram Moolenaar5eb86f92004-07-26 12:53:41 +0000432winnr() takes an optional "$" and "#" arguments. (Nikolai Weibull, Yegappan
433Lakshmanan)
434
435Added 'n' flag to search(): don't move the cursor. (Nikolai Weibull)
436
Bram Moolenaard4755bb2004-09-02 19:12:26 +0000437When uncompressing fails in the gzip plugin, give an error message but don't
438delete the raw text. Helps if the file has a .gz extension but is not
439actually compressed. (Andrew Pimlott)
440
441When C, C++ or IDL syntax is used, may additionally load doxygen syntax.
442Also support setting the filetype to "cdoxygen" for C plus doxygen syntax.
443(Michael Geddes)
444
445The ":registers" command now displays multi-byte characters properly.
446
447VMS: In the usage message mention that a slash can be used to make a flag
448upper case. Add color support to the builtin vt320 terminal codes.
449(Zoltan Arpadffy)
450
Bram Moolenaar15d0a8c2004-09-06 17:44:46 +0000451For the '%' item in 'viminfo', allow a number to set a maximum for the number
452of buffers.
453
Bram Moolenaarb5bf5b82004-12-24 14:35:23 +0000454The 'statusline' option can be local to the window, so that each window can
455have a different value. (partly by Yegappan Lakshmanan)
456
Bram Moolenaar3fdfa4a2004-10-07 21:02:47 +0000457When a file looks like a shell script, check for an "exec" command that starts
458the tcl interpreter. (suggested by Alexios Zavras)
459
460Support conversion between utf-8 and latin9 (iso-8859-15) internally, so that
461digraphs still work when iconv is not available.
462
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000463When a session file is loaded while editing an unnamed, empty buffer that
464buffer is wiped out. Avoids that there is an unused buffer in the buffer
465list.
466
467Win32: When libintl.dll supports bind_textdomain_codeset(), use it.
468(NAKADAIRA Yukihiro)
469
470When foldtext() finds no text after removing the comment leader, use the
471second line of the fold. Helps for C-style /* */ comments where the first
472line is just "/*".
473
Bram Moolenaar1cd871b2004-12-19 22:46:22 +0000474When editing the same file from two systems (e.g., Unix and MS-Windows) there
475mostly was no warning for an existing swap file, because the name of the
476edited file differs (e.g., y:\dir\file vs /home/me/dir/file). Added a flag to
477the swap file to indicate it is in the same directory as the edited file. The
478used path then doesn't matter and the check for editing the same file is much
479more reliable.
480
481Client-server communication now supports 'encoding'. When setting 'encoding'
482in a Vim server to "utf-8", and using "vim --remote fname" in a console,
483"fname" is converted from the console encoding to utf-8. Also allows Vims
484with different 'encoding' settings to exchange messages.
485
Bram Moolenaar86b68352004-12-27 21:59:20 +0000486Internal: Changed ga_room into ga_maxlen, so that it doesn't need to be
487incremented/decremented each time.
488
Bram Moolenaar2079a602005-01-04 21:43:22 +0000489Included a few improvements for Motif from Marcin Dalecki. Draw label
Bram Moolenaar567e4de2004-12-31 21:01:02 +0000490contents ourselves to make them handle fonts in a way configurable by Vim and
491a bit less dependent on the X11 font management.
492
Bram Moolenaar49cd9572005-01-03 21:06:01 +0000493When a register is empty it is not stored in the viminfo file.
494
Bram Moolenaar8c711452005-01-14 21:53:12 +0000495Removed the tcltags script, it's obsolete.
496
Bram Moolenaardcaf10e2005-01-21 11:55:25 +0000497":redir @*>" and ":redir @+>" append to the clipboard. Better check for
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000498invalid characters after the register name. |:redir|
499
500":redir => variable" and ":redir =>> variable" write or append to a variable.
501(Yegappan Lakshmanan) |:redir|
Bram Moolenaardcaf10e2005-01-21 11:55:25 +0000502
503":let g:" lists global variables.
504":let b:" lists buffer-local variables.
505":let w:" lists window-local variables.
506":let v:" lists Vim variables.
507
Bram Moolenaard438e912005-01-31 19:21:46 +0000508The stridx() and strridx() functions take a third argument, where to start
509searching. (Yegappan Lakshmanan)
Bram Moolenaarb71ec9f2005-01-25 22:22:02 +0000510
Bram Moolenaarbee0c5b2005-02-07 22:03:36 +0000511g CTRL-G also shows the number of characters if it differs from the number of
512bytes.
513
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000514Completion for ":debug" and entering an expression for the '=' register. Skip
515":" between range and command name. (Peter winters)
516
517CTRL-Q in Insert mode now works like CTRL-V by default. Previously it was
518ignored.
519
520When "beep" is included in 'debug' a function or script that causes a beep
521will result in a message with the source of the error.
522
Bram Moolenaar071d4272004-06-13 20:20:40 +0000523==============================================================================
524COMPILE TIME CHANGES *compile-changes-7*
525
Bram Moolenaar2079a602005-01-04 21:43:22 +0000526Dropped the support for the BeOS and Amiga GUI. They were not maintained and
527probably didn't work. If you want to work on this: get the Vim 6.x version
528and merge it back in.
529
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000530Mac: "make" now creates the Vim.app directory and "make install" copies it to
531its final destination. (Raf)
532
533Mac: Made it possible to compile with Motif, Athena or GTK without tricks and
534still being able to use the MacRoman conversion. Added the os_mac_conv.c
535file.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000536
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000537When running the tests and one of them fails to produce "test.out" the
538following tests are still executed. This helps when running out of memory.
539
Bram Moolenaar071d4272004-06-13 20:20:40 +0000540==============================================================================
541BUG FIXES *bug-fixes-7*
542
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000543When using PostScript printing on MS-DOS the default 'printexpr' used "lpr"
544instead of "copy". When 'printdevice' was empty the copy command did not
545work. Use "LPT1" then.
546
547The GTK font dialog uses a font size zero when the font name doesn't include a
548size. Use a default size of 10.
549
550This example in the documentation didn't work:
551 :e `=foo . ".c" `
552Skip over the expression in `=expr` when looking for comments, |, % and #.
553
554When ":helpgrep" doesn't find anything there is no error message.
555
556"L" and "H" did not take closed folds into account.
557
558Win32: The "-P title" argument stopped at the first title that matched, even
559when it doesn't support MDI.
560
561Mac GUI: CTRL-^ and CTRL-@ did not work.
562
563"2daw" on "word." at the end of a line didn't include the preceding white
564space.
565
566Win32: Using FindExecutable() doesn't work to find a program. Use
567SearchPath() instead. For executable() use $PATHEXT when the program searched
568for doesn't have an extension.
569
570When 'virtualedit' is set, moving the cursor up after appending a character
571may move it to a different column. Was caused by auto-formatting moving the
572cursor and not putting it back where it was.
573
574When indent was added automatically and then moving the cursor, the indent was
575not deleted (like when pressing ESC). The "I" flag in 'cpoptions' can be used
576to make it work the old way.
577
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000578When opening a command-line window, 'textwidth' gets set to 78 by the Vim
579filetype plugin. Reset 'textwidth' to 0 to avoid lines are broken.
580
581After using cursor(line, col) moving up/down doesn't keep the same column.
582
583Win32: Borland C before 5.5 requires using ".u." for LowPart and HighPart
584fields. (Walter Briscoe)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000585
Bram Moolenaar843ee412004-06-30 16:16:41 +0000586On Sinix SYS_NMLN isn't always defined. Define it ourselves. (Cristiano De
587Michele)
588
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000589Printing with PostScript may keep the printer waiting for more. Append a
590CTRL-D to the printer output. (Mike Williams)
591
Bram Moolenaar2df6dcc2004-07-12 15:53:54 +0000592When converting a string with a hex or octal number the leading '-' was
593ignored. ":echo '-05' + 0" resulted in 5 instead of -5.
594
595Using "@:" to repeat a command line didn't work when it contains control
596characters.
597
Bram Moolenaar21cf8232004-07-16 20:18:37 +0000598When using file completion for a user command, it would not expand environment
599variables like for a regular command with a file argument.
600
601'cindent': When the argument of a #define looks like a C++ class the next line
602is indented too much.
603
604When 'comments' includes multi-byte characters inserting the middle part and
605alignment may go wrong. 'cindent' also suffers from this for right-aligned
606items.
607
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000608The default for 'helplang' was "zh" for both "zh_cn" and "zh_tw". Now use
609"cn" or "tw" as intended.
610
Bram Moolenaar5eb86f92004-07-26 12:53:41 +0000611When 'bin' is set and 'eol' is not set then line2byte() added the line break
612after the last line while it's not there.
613
614Using foldlevel() in a WinEnter autocommand may not work. Noticed when
615resizing the GUI shell upon startup.
616
617Python: Using buffer.append(f.readlines()) didn't work. Allow appending a
618string with a trailing newline. The newline is ignored.
619
Bram Moolenaar269ec652004-07-29 08:43:53 +0000620When using the ":saveas f2" command for buffer "f1", the Buffers menu would
621contain "f2" twice, one of them leading to "f1". Also trigger the BufFilePre
622and BufFilePost events for the alternate buffer that gets the old name.
623
Bram Moolenaard4755bb2004-09-02 19:12:26 +0000624strridx() did not work well when the needle is empty. (Ciaran McCreesh)
625
626GTK: Avoid a potential hang in gui_mch_wait_for_chars() when input arrives
627just before it is invoked
628
629VMS: Occasionally CR characters were inserted in the file. Expansion of
630environment variables was not correct. (Zoltan Arpadffy)
631
632UTF-8: When 'delcombine' is set "dw" only deleted the last combining character
633from the first character of the word.
634
635When using ":sball" in an autocommand only the filetype in one buffer was
636detected. Reset did_filetype in enter_buffer().
637
638When using ":argdo" and the window already was at the first argument index,
639but not actually editing it, the current buffer would be used instead.
640
Bram Moolenaar15d0a8c2004-09-06 17:44:46 +0000641When ":next dir/*" includes many matches, adding the names to the argument
642list may take an awful lot of time and can't be interrupted. Allow
643interrupting this.
644
645When editing a file that was already loaded in a buffer, modelines were not
646used. Now window-local options in the modeline are set. Buffer-local options
647and global options remain unmodified.
648
649Win32: When 'encoding' is set to "utf-8" in the vimrc file, files from the
650command line with non-ASCII characters are not used correctly. Recode the
651file names when 'encoding' is set, using the Unicode command line.
652
Bram Moolenaarc0197e22004-09-13 20:26:32 +0000653Win32 console: When the default for 'encoding' ends up to be "latin1", the
654default value of 'isprint' was wrong.
655
656When an error message is given while waiting for a character (e.g., when an
657xterm reports the number of colors), the hit-enter prompt overwrote the last
658line. Don't reset msg_didout in normal_cmd() for K_IGNORE.
659
Bram Moolenaar3fdfa4a2004-10-07 21:02:47 +0000660Mac GUI: Shift-Tab didn't work.
661
662When defining tooltip text, don't translate terminal codes, since it's not
663going to be used like a command.
664
665GTK 2: Check the tooltip text for valid utf-8 characters to avoid getting a
666GTK error. Invalid characters may appear when 'encoding' is changed.
667
668GTK 2: Add a safety check for invalid utf-8 sequences, they can crash pango.
669
670Win32: When 'encoding' is changed while starting up, use the Unicode command
671line to convert the file arguments to 'encoding'. Both for the GUI and the
672console version.
673
674Win32 GUI: latin9 text (iso-8859-15) was not displayed correctly, because
675there is no codepage for latin9. Do our own conversion from latin9 to UCS2.
676
Bram Moolenaar7b0294c2004-10-11 10:16:09 +0000677When two versions of GTK+ 2 are installed it was possible to use the header
678files from one and the library from the other. Use GTK_LIBDIR to put the
679directory for the library early in the link flags.
680
681With the GUI find/replace dialog a replace only worked if the pattern was
682literal text. Now it works for any pattern.
683
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000684When 'equalalways' is set and 'eadirection' is "hor", ":quit" would still
685cause equalizing window heights in the vertical direction.
686
687When ":emenu" is used in a startup script the command was put in the typeahead
688buffer, causing a prompt for the crypt key to be messed up.
689
690Mac OS/X: The default for 'isprint' included characters 128-160, causes
691problems for Terminal.app.
692
693When a syntax item with "containedin" is used, it may match in the start or
694end of a region with a matchgroup, while this doesn't happen for a "contains"
695argument.
696
697When a transparent syntax items matches in another item where the highlighting
698has already stopped (because of a he= argument), the highlighting would come
699back.
700
701When cscope is used to set the quickfix error list, it didn't get set if there
702was only one match. (Sergey Khorev)
703
704When 'confirm' is set and using ":bdel" in a modified buffer, then selecting
705"cancel", would still give an error message.
706
707The PopUp menu items that started Visual mode didn't work when not in Normal
708mode. Switching between selecting a word and a line was not possible.
709
710Win32: The keypad decimal point always resulted in a '.', while on some
711keyboards it's a ','. Use MapVirtualKey(VK_DECIMAL, 2).
712
713Removed unused function DisplayCompStringOpaque() from gui_w32.c
714
715In Visual mode there is not always an indication whether the line break is
716selected or not. Highlight the character after the line when the line break
717is included, e.g., after "v$o".
718
719GTK: The <F10> key can't be mapped, it selects the menu. Disable that with a
720GTK setting and do select the menu when <F10> isn't mapped. (David Necas)
721
722After "Y" '[ and '] were not at start/end of the yanked text.
723
724When a telnet connection is dropped Vim preserves files and exits. While
725doing that a SIGHUP may arrive and disturbe us, thus ignore it. (Scott
Bram Moolenaar46c9c732004-12-12 11:37:09 +0000726Anderson) Also postpone SIGHUP, SIGQUIT and SIGTERM until it's safe to
727handle. Added handle_signal().
728
729When using "set laststatus=2 cmdheight=2" in the .gvimrc you may only get one
730line for the cmdline. (Christian Robinson) Invoke command_height() after the
731GUI has started up.
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000732
Bram Moolenaar1cd871b2004-12-19 22:46:22 +0000733When completing a file name on the command line backslashes are required for
734white space. Was only done for a space, not for a Tab.
735
736When configure could not find a terminal library, compiling continued for a
737long time before reporting the problem. Added a configure check for tgetent()
738being found in a library.
739
740When the cursor is on the first char of the last line a ":g/pat/s///" command
741may cause the cursor to be displayed below the text.
742
743Win32: Editing a file with non-ASCII characters doesn't work when 'encoding'
744is "utf-8". use _wfullpath() instead of _fullpath(). (Yu-sung Moon)
745
746When recovering the 'fileformat' and 'fileencoding' were taken from the
747original file instead of from the swapfile. When the file didn't exist, was
748empty or the option was changed (e.g., with ":e ++fenc=cp123 file") it could
749be wrong. Now store 'fileformat' and 'fileencoding' in the swapfile and use
750the values when recovering.
751
752":bufdo g/something/p" overwrites each last printed text line with the file
753message for the next buffer. Temporarily clear 'shortmess' to avoid that.
754
Bram Moolenaarb5bf5b82004-12-24 14:35:23 +0000755Win32: Cannot edit a file starting with # with --remote. Do escape % and #
756when building the ":drop" command.
757
Bram Moolenaar86b68352004-12-27 21:59:20 +0000758A comment or | just after a expresion-backtick argument was not recognized.
759E.g. in :e `="foo"`"comment.
760
Bram Moolenaar567e4de2004-12-31 21:01:02 +0000761"(" does not stop at an empty sentence (single dot and white space) while ")"
762does. Also breaks "das" on that dot.
763
764When doing "yy" with the cursor on a TAB the ruler could be wrong and "k"
765moved the cursor to another column.
766
767When 'commentstring' is '"%s' and there is a double quote in the line a double
768quote before the fold marker isn't removed in the text displayed for a closed
769fold.
770
771In Visual mode, when 'bin' and 'eol' set, g CTRL-G counted the last line
772break, resulting in "selected 202 of 201 bytes".
773
Bram Moolenaar2079a602005-01-04 21:43:22 +0000774Motif: fonts were not used for dialog components. (Marcin Dalecki)
Bram Moolenaar567e4de2004-12-31 21:01:02 +0000775
Bram Moolenaar49cd9572005-01-03 21:06:01 +0000776Motif: After using a toolbar button the keyboard focus would be on the toolbar
Bram Moolenaar2079a602005-01-04 21:43:22 +0000777(Lesstif problem). (Marcin Dalecki)
Bram Moolenaar49cd9572005-01-03 21:06:01 +0000778
Bram Moolenaar1c2fda22005-01-02 11:43:19 +0000779When using "y<C-V>`x" where mark x is in the first column, the last line was
780not included.
781
782Not all test scripts work properly on MS-Windows when checked out from CVS.
783Use a Vim command to fix all fileformats to dos before executing the tests.
784
785When using ":new" and the file fits in the window, lines could still be above
786the window. Now remove empty lines instead of keeping the relative position.
787
Bram Moolenaar3d60ec22005-01-05 22:19:46 +0000788Cmdline completion didn't work after ":let var1 var<Tab>".
789
Bram Moolenaarb7d6e722005-01-09 21:22:45 +0000790When using ":startinsert" or ":startreplace" when already in Insert mode
791(possible when using CTRL-R =), pressing Esc would directly restart Insert
792mode. (Peter Winters)
793
Bram Moolenaar31c67ef2005-01-11 21:34:41 +0000794"2daw" didn't work at end of file if the last word is a single character.
795
Bram Moolenaar8c711452005-01-14 21:53:12 +0000796Completion for ":next a'<Tab>" put a backslash before single quote, but it was
797not removed when editing a file. Now halve backslashes in save_patterns().
Bram Moolenaar798c5a72005-01-16 22:06:30 +0000798Also fix expanding a file name with the shell that contains "\'".
Bram Moolenaar8c711452005-01-14 21:53:12 +0000799
Bram Moolenaarb71ec9f2005-01-25 22:22:02 +0000800When doing "1,6d|put" only "fewer lines" was reported. Now a following "more
801lines" overwrites the message.
802
803Configure could not handle "-Dfoo=long\ long" in the TCL config output.
804
Bram Moolenaarb2956cd2005-01-27 14:42:53 +0000805When searching backwards, using a pattern that matches a newline and uses \zs
806after that, didn't find a match. Could also get a hang or end up in the right
807column in the wrong line.
808
Bram Moolenaard438e912005-01-31 19:21:46 +0000809When $LANG is "sl" for slovenian, the slovak menu was used, since "slovak"
810starts with "sl".
811
812When 'paste' is set in the GUI the Paste toolbar button doesn't work. Clear
813'paste' when starting the GUI.
814
Bram Moolenaarf5836682005-02-02 23:09:45 +0000815A message about a wrong viminfo line included the trailing NL.
816
Bram Moolenaar2a8d1f82005-02-05 21:43:56 +0000817When 'paste' is set in the GUI the toolbar button doesn't work in Insert mode.
818Use ":exe" in menu.vim to avoid duplicating the commands, instead of using a
819mapping.
820
821Treat "mlterm" as an xterm-like terminal. (Seiichi Sato)
822
823":z.4" and ":z=4" didn't work Vi compatible.
824
Bram Moolenaarbee0c5b2005-02-07 22:03:36 +0000825When sourcing a file, editing it and sourcing it again, it could appear twice
826in ":scriptnames" and get a new <SID>, because the inode has changed.
827
828When $SHELL is set but empty the 'shell' option would be empty. Don't use an
829empty $SHELL value.
830
831A command "w! file" in .vimrc or $EXINIT didn't work. Now it writes an empty
832file.
833
834When a CTRL-F command at the end of the file failed, the cursor was still
835moved to the start of the line. Now it remains where it is.
836
837When using ":s" or "&" to repeat the last substitute and "$" was used to put
838the cursor in the last column, put the cursor in the last column again. This
839is Vi compatible.
840
Bram Moolenaar4399ef42005-02-12 14:29:27 +0000841Vim is not fully POSIX compliant but sticks with traditional Vi behavior.
842Added a few flags in 'cpoptions' to behave the POSIX way when wanted. The
843$VIM_POSIX environment variable is checked to set the default.
844
845Appending to a register didn't insert a line break like Vi. Added the '>'
846flag to 'cpoptions' for this.
847
848Using "I" in a line with only blanks appended to the line. This is not Vi
849compatible. Added the 'H' flag in 'coptions' for this.
850
851When joining multiple lines the cursor would be at the last joint, but Vi
852leaves it at the position where "J" would put it. Added the 'q' flag in
853'cpoptions' for this.
854
855Autoindent didn't work for ":insert" and ":append".
856
857Using ":append" in an empty buffer kept the dummy line. Now it's deleted to
858be Vi compatible.
859
860When reading commands from a file and stdout goes to a terminal, would still
861request the xterm version. Vim can't read it, thus the output went to the
862shell and caused trouble there.
863
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000864When redirecting to a register with an invalid name the redirection would
865still be done (after an error message). Now reset "redir_reg". (Yegappan
866Lakshmanan)
867
868It was not possible to use a NL after a backslash in Ex mode. This is
869sometimes used to feed multiple lines to a shell command.
870
Bram Moolenaar071d4272004-06-13 20:20:40 +0000871 vim:tw=78:ts=8:ft=help:norl: