blob: 71191295652a406d53bf6d09a7f36d3973c74085 [file] [log] [blame]
Bram Moolenaar572cb562005-08-05 21:35:02 +00001*version7.txt* For Vim version 7.0aa. Last change: 2005 Aug 05
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 Moolenaar60c78922005-03-20 22:40:14 +000022Spell checking |new-spell|
Bram Moolenaar325b7a22004-07-05 15:58:32 +000023KDE support |new-KDE|
Bram Moolenaarfb670262005-06-05 22:06:27 +000024MzScheme interface |new-MzScheme|
25Printing multi-byte text |new-print-multi-byte|
Bram Moolenaar293ee4d2004-12-09 21:34:53 +000026Translated manual pages |new-manpage-trans|
Bram Moolenaar8fc061c2004-12-29 21:03:02 +000027Internal grep |new-vimgrep|
Bram Moolenaar87e25fd2005-07-27 21:13:01 +000028Scroll back in messages |new-scroll-back|
Bram Moolenaar4399ef42005-02-12 14:29:27 +000029POSIX compatibility |new-posix|
Bram Moolenaare2ac10d2005-03-07 23:26:06 +000030Debugger support |new-debug-support|
Bram Moolenaar0be6e642005-08-04 21:32:22 +000031Remote file explorer |new-netrw-explore|
Bram Moolenaar071d4272004-06-13 20:20:40 +000032Various new items |new-items-7|
33
34IMPROVEMENTS |improvements-7|
35
36COMPILE TIME CHANGES |compile-changes-7|
37
38BUG FIXES |bug-fixes-7|
39
40==============================================================================
41INCOMPATIBLE CHANGES *incompatible-7*
42
43These changes are incompatible with previous releases. Check this list if you
Bram Moolenaarb2956cd2005-01-27 14:42:53 +000044run into a problem when upgrading from Vim 6.x to 7.0.
45
46A ":write file" command no longer resets the 'modified' flag of the buffer,
47unless the '+' flag is in 'cpoptions' |cpo-+|. This was illogical, since the
48buffer is still modified compared to the original file. And when undoing
49all changes the file would actually be marked modified. It does mean that
50":quit" fails now.
Bram Moolenaar071d4272004-06-13 20:20:40 +000051
Bram Moolenaarf4b8e572004-06-24 15:53:16 +000052":helpgrep" now uses a help window to display a match.
53
Bram Moolenaar1cd871b2004-12-19 22:46:22 +000054In an argument list double quotes could be used to include spaces in a file
55name. This caused a difference between ":edit" and ":next" for escaping
56double quotes and it is incompatible with some versions of Vi.
57 Command Vim 6.x file name Vim 7.x file name ~
58 :edit foo\"888 'foo"888' 'foo"888'
59 :next foo\"888 'foo888' 'foo"888'
60 :next a\"b c\"d 'ab cd' 'a"b' and 'c"d'
61
Bram Moolenaar8c711452005-01-14 21:53:12 +000062In a |literal-string| a single quote can be doubled to get one.
63":echo 'a''b'" would result in "a b", but now that two quotes stand for one it
64results in "a'b".
65
Bram Moolenaar04a09c12005-08-01 22:02:32 +000066When overwriting a file with ":w! fname" there was no warning for when "fname"
67was being edited by another Vim. Vim now gives an error message |E768|.
68
Bram Moolenaarf4b8e572004-06-24 15:53:16 +000069
70Minor incompatibilities:
71
72For filetype detection: For many types, instead of ~/.dir/filename use
73*/.dir/filename, so that it also works for other user's files.
74
75":0verbose" now sets 'verbose' to zero instead of one.
76
77Removed the old and incomplete "VimBuddy" code.
78
79Buffers without a name report "No Name" instead of "No File". It was
80confusing for buffers with a name and 'buftype' set to "nofile".
Bram Moolenaar071d4272004-06-13 20:20:40 +000081
Bram Moolenaar7b0294c2004-10-11 10:16:09 +000082When ":file xxx" is used in a buffer without a name, the alternate file name
83isn't set. This avoids creating buffers without a name that are not useful.
84
85The "2html.vim" script now converts closed folds to HTML. This means the HTML
Bram Moolenaarf4630b62005-05-20 21:31:17 +000086looks like its displayed, with the same folds open and closed. Use "zR", or
87"let html_ignore_folding=1", if no folds should appear in the HTML. (partly by
88Carl Osterwisch)
Bram Moolenaar47136d72004-10-12 20:02:24 +000089Diff mode now is also converted as it is displayed.
Bram Moolenaar7b0294c2004-10-11 10:16:09 +000090
Bram Moolenaar293ee4d2004-12-09 21:34:53 +000091Win32: The effect of the <F10> key depended on 'winaltkeys'. Now it depends
92on whether <F10> has been mapped or not. This allows mapping <F10> without
93changing 'winaltkeys'.
94
Bram Moolenaar8c711452005-01-14 21:53:12 +000095When 'octal' is in 'nrformats' and using CTRL-A on "08" it became "018", which
96is illogical. Now it becomes "9". The leading zero(s) is(are) removed to
97avoid the number becoming octal after incrementing "009" to "010".
Bram Moolenaar1cd871b2004-12-19 22:46:22 +000098
99When 'encoding' is set to a Unicode encoding, the value for 'fileencodings'
100now includes "default" before "latin1". This means that for files with 8-bit
101encodings the default is to use the encoding specified by the environment, if
102possible. Previously latin1 would always be used, which is wrong in a
103non-latin1 environment, such as Russian.
104
Bram Moolenaard438e912005-01-31 19:21:46 +0000105Previously Vim would exit when there are two windows, both of them displaying
106a help file, and using ":quit". Now only the window is closed.
107
Bram Moolenaar4399ef42005-02-12 14:29:27 +0000108"-w {scriptout}" only works when {scriptout} doesn't start with a digit.
109Otherwise it's used to set the 'window' option.
110
Bram Moolenaar8bf59b92005-03-06 23:40:56 +0000111Previously <Home> and <xHome> could be mapped separately. This had the
112disadvantage that all mappings (with modifiers) had to be duplicated, since
113you can't be sure what the keyboard generates. Now all <xHome> are internally
114translated to <Home>, both for the keys and for mappings. Also for <xEnd>,
115<xF1>, etc.
116
Bram Moolenaar13fcaaf2005-04-15 21:13:42 +0000117":put" now leaves the cursor on the last inserted line.
118
Bram Moolenaar7fae6362005-06-30 22:06:41 +0000119When a .gvimrc file exists then 'compatible' is off, just like when a ".vimrc"
120file exists.
121
Bram Moolenaar071d4272004-06-13 20:20:40 +0000122==============================================================================
123NEW FEATURES *new-7*
124
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000125Vim script enhancements *new-vim-script*
126-----------------------
Bram Moolenaar071d4272004-06-13 20:20:40 +0000127
128In Vim scripts the following types have been added:
129
Bram Moolenaar31c67ef2005-01-11 21:34:41 +0000130 List ordered list of items |List|
131 Dictionary associative array of items |Dictionary|
132 Funcref reference to a function |Funcref|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000133
134Many functions and commands have been added to support the new types.
135
Bram Moolenaar31c67ef2005-01-11 21:34:41 +0000136The |string()| function can be used to get a string representation of a
137variable. Works for Numbers, Strings and composites of them. Then |eval()|
138can be used to turn the string back into the variable value.
139
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000140The |:let| command can now use ":let var += expr" like using ":let var = var +
141expr". "-=" and ".=" works in a similar way.
142
Bram Moolenaar038eb0e2005-02-27 22:43:26 +0000143With the |:profile| command you can find out where your function or script
144wastes its time.
145
Bram Moolenaar843ee412004-06-30 16:16:41 +0000146
Bram Moolenaar60c78922005-03-20 22:40:14 +0000147Spell checking *new-spell*
148--------------
149
150Spell checking has been integrated in Vim. There were a few implementations
151with scripts, but they were slow and/or required an external program.
152
153The 'spell' option is used to switch spell checking on or off.
154The 'spelllang' option is used to specify the languages that are accepted.
Bram Moolenaar9ba0eb82005-06-13 22:28:56 +0000155The 'spellfile' option specifies where new words are added.
Bram Moolenaar7fae6362005-06-30 22:06:41 +0000156The 'spellsuggest' option specifies the methods used for making suggestions
Bram Moolenaar9ba0eb82005-06-13 22:28:56 +0000157
158The |[s| and |]s| commands can be used to move to the next or previous error.
159The |zg| and |zw| commands can be used to add good and wrong words.
160The |z?| command can be used to correct the word.
Bram Moolenaar7fae6362005-06-30 22:06:41 +0000161The |:mkspell| command is used to generate a Vim spell file from word lists.
Bram Moolenaar60c78922005-03-20 22:40:14 +0000162
163The "undercurl" highlighting attribute was added to nicely point out spelling
164mistakes in the GUI (based on patch from Marcin Dalecki).
165The "guisp" color can be used to give it a color different from foreground and
166background.
167The number of possible different highlight attributes was raised from about
168220 to over 30000. This allows for the attributes of spelling to be combined
Bram Moolenaar75c50c42005-06-04 22:06:24 +0000169with syntax highlighting attributes. This is also used for syntax
170highlighting.
Bram Moolenaar60c78922005-03-20 22:40:14 +0000171
172Much more info here: |spell|.
173
174
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000175KDE support *new-KDE*
Bram Moolenaar843ee412004-06-30 16:16:41 +0000176-----------
177
178Kvim is the KDE version of Vim. It uses the Qt toolkit. See |KVim|.
179(Thomas Capricelli, Philippe Fremy, Mickael Marchand, Mark Westcott, et al.)
180
Bram Moolenaar071d4272004-06-13 20:20:40 +0000181
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000182MzScheme interface *new-MzScheme*
183------------------
184
185The MzScheme interpreter is supported. |MzScheme|
186The |:mzscheme| command can be used to execute MzScheme commands.
187The |:mzfile| command can be used to execute an MzScheme script file.
188
Bram Moolenaar31c67ef2005-01-11 21:34:41 +0000189
Bram Moolenaar8299df92004-07-10 09:47:34 +0000190Printing multi-byte text *new-print-multi-byte*
191------------------
192
193The |:hardcopy| command now supports printing multi-byte characters.
194The 'printmbcharset' and 'printmbfont' options are used for this.
195Also see |postscript-cjk-printing|. (Mike Williams)
196
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000197
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000198Translated manual pages *new-manpage-trans*
199-----------------------
200
201The manual page of Vim and associated programs is now also available in
Bram Moolenaar4ad237d2005-03-11 22:49:40 +0000202several other languages.
203
Bram Moolenaar13fcaaf2005-04-15 21:13:42 +0000204French - translated by David Blanchet
Bram Moolenaar4ad237d2005-03-11 22:49:40 +0000205Italian - translated by Antonio Colombo
206Russian - translated by Vassily Ragosin
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000207
Bram Moolenaar13fcaaf2005-04-15 21:13:42 +0000208The Unix Makefile installs the Italian manual pages in .../man/it/man1/,
209.../man/it.ISO8859-1/man1/ and .../man/it.UTF-8/man1/. There appears to be no
210standard for what encoding goes in the "it" directory, the 8-bit encoded file
211is used there as a best guess.
212Other languages are installed in similar places.
Bram Moolenaar67fe1a12005-05-22 22:12:58 +0000213The translated pages are not automatically installed when Vim was configured
214with "--disable-nls", but "make install-languages install-tool-languages" will
215do it anyway.
Bram Moolenaarb5bf5b82004-12-24 14:35:23 +0000216
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000217
Bram Moolenaar8fc061c2004-12-29 21:03:02 +0000218Internal grep *new-vimgrep*
219-------------
220
221The ":vimgrep" command can be used to search for a pattern in a list of files.
222This is like the ":grep" command, but no external program is used. Besides
223better portability, handling of different file encodings and using multi-line
224patterns, this also allows grepping in compressed and remote files.
225|:vimgrep|.
226
Bram Moolenaar05159a02005-02-26 23:04:13 +0000227If you want to use the search results in a script you can use the
Bram Moolenaar2641f772005-03-25 21:58:17 +0000228|getqflist()| function.
Bram Moolenaar05159a02005-02-26 23:04:13 +0000229
Bram Moolenaar231334e2005-07-25 20:46:57 +0000230To search in files in various directories the "**" pattern can be used. It
231expands into an arbitrary depth of directories. "**" can be used in all
232places where file names are expanded, thus also with |:next| and |:args|.
233
Bram Moolenaar8fc061c2004-12-29 21:03:02 +0000234
Bram Moolenaar87e25fd2005-07-27 21:13:01 +0000235Scroll back in messages *new-scroll-back*
236-----------------------
237
238When displaying messages, at the |more-prompt| and the |hit-enter-prompt|, The
239'k', 'u' and 'b' keys can be used to scroll back to previous messages. This
240is especially useful for commands such as ":syntax", ":autocommand" and
241":highlight". This is implemented in a generic way thus it works for all
242commands and highlighting is kept. Only works when the 'more' option is set.
243Previously it only partly worked for ":clist".
244
Bram Moolenaar661b1822005-07-28 22:36:45 +0000245The |g<| command can be used to see the last page of messages after you have
246hit <Enter> at the |hit-enter-prompt|. Then you can scroll further back.
247
Bram Moolenaar87e25fd2005-07-27 21:13:01 +0000248
Bram Moolenaar4399ef42005-02-12 14:29:27 +0000249POSIX compatibility *new-posix*
250-------------------
251
252The POSIX test suite was used to verify POSIX compatibility. A number of
253problems have been fixed to make Vim more POSIX compatible. Some of them
254conflict with traditional Vi or expected behavior. The $VIM_POSIX environment
255variable can be set to get POSIX compatibility. See |posix|.
256
257Items that were fixed for both Vi and POSIX compatibilty:
258- repeating "R" with a count only overwrites text once; added the 'X' flag to
259 'cpoptions' |cpo-X|
260- a vertical movement command that moves to a non-existing line fails; added
261 the '-' flag to 'cpoptions' |cpo--|
262- when preserving a file and doing ":q!" the file can be recovered; added the
263 '&' flag to 'cpoptions' |cpo-&|
264- The 'window' option is partly implemented. It specifies how much CTRL-F and
265 CTRL-B scroll when there is one window. The "-w {number}" argument is now
266 accepted. "-w {scriptout}" only works when {scriptout} doesn't start with a
267 digit.
268- Allow "-c{command}" argument, no space between "-c" and {command}.
269- When writing a file with ":w!" don't reset 'readonly' when 'Z' is present in
270 'cpoptions'.
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000271- Allow 'l' and '#' flags for ":list", ":print" and ":number".
272- Added the '.' flag to 'cpoptions': ":cd" fails when the buffer is modified.
273- In Ex mode with an empty buffer ":read file" doesn't keep an empty line
274 above or below the new lines.
275- Remove a backslash before a NL for the ":global" command.
276- When ":append", ":insert" or ":change" is used with ":global", get the
277 inserted lines from the command. Can use backslash-NL to separate lines.
278- Can use ":global /pat/ visual" to execute Normal mode commands at each
279 matched line. Use "Q" to continue and go to the next line.
280- The |:open| command has been partially implemented. It stops Ex mode, but
281 redraws the whole screen, not just one line as open mode is supposed to do.
282- Support using a pipe to read the output from and write input to an external
283 command. Added the 'shelltemp' option and has("filterpipe").
284- In ex silent mode the ":set" command output is displayed.
285- The ":@@" and ":**" give an error message when no register was used before.
286- The search pattern "[]-`]" matches ']', '^', '_' and '`'.
287- Autoindent for ":insert" is using the line below the insert.
288- Autoindent for ":change" is using the first changed line.
289- Editing Ex command lines is not done in cooked mode, because CTRL-D and
290 CTRL-T cannot be handled then.
Bram Moolenaar45eeb132005-06-06 21:59:07 +0000291- In Ex mode, "1,3" prints three lines. "%" prints all lines.
292- In Ex mode "undo" would undo all changes since Ex mode was started.
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000293- Implemented the 'prompt' option.
Bram Moolenaar4399ef42005-02-12 14:29:27 +0000294
295
Bram Moolenaare2ac10d2005-03-07 23:26:06 +0000296Debugger support *new-debug-support*
297----------------
298
299The 'balloonexpr' option has been added. This is a generic way to implement
300balloon functionality. You can use it to show info for the word under the
301mouse pointer.
302
303
Bram Moolenaar0be6e642005-08-04 21:32:22 +0000304Remote file explorer *new-netrw-explore*
305--------------------
306
307The netrw plugin now also supports viewing a directory, when "scp://" is used.
308Deleting and renaming files is possible.
309
310To avoid duplicating a lot of code, the previous file explorer plugin has been
311integrated in the netrw plugin. This means browsing local and remote files
312works the same way.
313
314":browse edit" and ":browse split" use the netrw plugin when it's available
315and a GUI dialog is not possible.
316
317The netrw plugin is maintained by Charles Campbell.
318
319
Bram Moolenaar071d4272004-06-13 20:20:40 +0000320Various new items *new-items-7*
321-----------------
322
323Normal mode commands: ~
324
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +0000325a", a' and a` New text objects to select quoted strings. |a'|
326i", i' and i' (Taro Muraoka)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000327
Bram Moolenaar05159a02005-02-26 23:04:13 +0000328CTRL-W <Enter> In the quickfix window: opens a new window to show the
329 location of the error under the cursor.
330
Bram Moolenaarff6f0612005-07-19 22:21:12 +0000331|at| and |it| text objects select a block of text between HTML or XML tags.
332
333
Bram Moolenaar071d4272004-06-13 20:20:40 +0000334Options: ~
335
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +0000336'completefunc' The name of a function used for user-specified Insert
337 mode completion. CTRL-X CTRL-U can be used in Insert
338 mode to do any kind of completion. (Taro Muraoka)
339'quoteescape' Characters used to escape quotes inside a string.
340 Used for the a", a' and a` text objects. |a'|
Bram Moolenaar592e0a22004-07-03 16:05:59 +0000341'numberwidth' Minimal width of the space used for the 'number'
342 option. (Emmanuel Renieris)
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000343'mzquantum' Time in msec to schedule MzScheme threads.
Bram Moolenaar8299df92004-07-10 09:47:34 +0000344'printmbcharset' CJK character set to be used for :hardcopy
345'printmbfont' font names to be used for CJK output of :hardcopy
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000346'fsync' Whether fsync() is called after writing a file.
347 (Ciaran McCreesh)
Bram Moolenaarb5bf5b82004-12-24 14:35:23 +0000348'wildoptions' "tagfile" value enables listing the file name of
349 matching tags for CTRL-D command line completion.
350 (based on an idea from Yegappan Lakshmanan)
Bram Moolenaar86b68352004-12-27 21:59:20 +0000351'formatlistpat' pattern to recognize a numbered list for formatting.
352 (idea by Hugo Haas)
Bram Moolenaar60c78922005-03-20 22:40:14 +0000353'spell' switch spell checking on/off
354'spelllang' languages to check spelling for
Bram Moolenaar42eeac32005-06-29 22:40:58 +0000355'spellsuggest' methods for spell suggestions
Bram Moolenaar3b56eb32005-07-11 22:40:32 +0000356'synmaxcol' maximum column to look for syntax items; avoids very
357 slow redrawing when there are very long lines
Bram Moolenaar54ee7752005-05-31 22:22:17 +0000358'verbosefile' Log messages in a file.
Bram Moolenaar86b68352004-12-27 21:59:20 +0000359
Bram Moolenaar071d4272004-06-13 20:20:40 +0000360
361Ex commands: ~
362
Bram Moolenaar843ee412004-06-30 16:16:41 +0000363Win32: The ":winpos" command now also works in the console. (Vipin Aravind)
364
Bram Moolenaar8299df92004-07-10 09:47:34 +0000365|:startreplace| Start Replace mode. (Charles Campbell)
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000366
Bram Moolenaar8299df92004-07-10 09:47:34 +0000367|:0file| Removes the name of the buffer. (Charles Campbell)
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000368
Bram Moolenaar2df6dcc2004-07-12 15:53:54 +0000369|:diffoff| Switch off diff mode in the current window or in all
370 windows.
371
Bram Moolenaard4755bb2004-09-02 19:12:26 +0000372|:keepalt| Do not change the alternate file.
373
Bram Moolenaarc0197e22004-09-13 20:26:32 +0000374|:delmarks| Delete marks.
375
Bram Moolenaar7b0294c2004-10-11 10:16:09 +0000376|:sandbox| Command modifier: execute the argument in the sandbox.
377
Bram Moolenaarb5bf5b82004-12-24 14:35:23 +0000378|:exusage| Help for Ex commands (Nvi command).
379
380|:viusage| Help for Vi commands (Nvi command).
381
Bram Moolenaar86b68352004-12-27 21:59:20 +0000382|:cbuffer| Read error lines from a buffer. (partly by Yegappan
383 Lakshmanan)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000384
Bram Moolenaar67fe1a12005-05-22 22:12:58 +0000385|:sort| Sort lines in the buffer without depending on an
386 external command.
387
Bram Moolenaar87e25fd2005-07-27 21:13:01 +0000388|:caddfile| Add error messages to an existing quickfix list
389 (Yegappan Lakshmanan).
390
391|:cexpr| Read error messages from a Vim expression (Yegappan
392 Lakshmanan).
393
Bram Moolenaar67fe1a12005-05-22 22:12:58 +0000394
Bram Moolenaar071d4272004-06-13 20:20:40 +0000395New functions: ~
396
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000397|add()| append an item to a List
398|append()| append List of lines to the buffer
Bram Moolenaar87b774d2005-07-20 22:04:36 +0000399|browsedir()| dialog to select a directory
400|byteidx()| index of a character (Ilya Sher)
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000401|call()| call a function with List as arguments
Bram Moolenaar572cb562005-08-05 21:35:02 +0000402|complete_add()| add match for 'completefunc'
403|complete_check()| check for key pressed, for 'completefunc'
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000404|copy()| make a shallow copy of a List or Dictionary
405|count()| count nr of times a value is in a List or Dictionary
406|deepcopy()| make a full copy of a List or Dictionary
407|empty()| check if List or Dictionary is empty
Bram Moolenaarb982ca52005-03-28 21:02:15 +0000408|getqflist()| list of quickfix errors (Yegappan Lakshmanan)
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000409|extend()| append one List to another or add items from one
410 Dictionary to another
411|filter()| remove selected items from a List or Dictionary
Bram Moolenaar87b774d2005-07-20 22:04:36 +0000412|finddir()| find a directory in 'path'
413|findfile()| find a file in 'path' (Johannes Zellner)
414|foldtextresult()| the text displayed for a closed fold at line "lnum"
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000415|function()| make a Funcref out of a function name
416|get()| get an item from a List or Dictionary
Bram Moolenaar342337a2005-07-21 21:11:17 +0000417|getbufline()| get a list of lines from a specified buffer
Bram Moolenaar87b774d2005-07-20 22:04:36 +0000418 (Yegappan Lakshmanan)
419|getfontname()| get actual font name being used
420|getfperm()| get file permission string (Nikolai Weibull)
421|getftype()| get type of file (Nikolai Weibull)
422|getline()| with second argument: get List with buffer lines
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000423|has_key()| check whether a key appears in a Dictionary
424|insert()| insert an item somewhere in a List
425|items()| get List of Dictionary key-value pairs
426|join()| join List items into a String
427|keys()| get List of Dictionary keys
428|len()| number of items in a List or Dictionary
429|map()| change each List or Dictionary item
Bram Moolenaar2a8d1f82005-02-05 21:43:56 +0000430|matchlist()| list with match and submatches of a pattern in a string
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000431|max()| maximum value in a List or Dictionary
432|min()| minimum value in a List or Dictionary
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000433|mkdir()| create a directory
Bram Moolenaar4be06f92005-07-29 22:36:03 +0000434|printf()| format text
Bram Moolenaar2a8d1f82005-02-05 21:43:56 +0000435|readfile()| read a file into a list of lines
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000436|remove()| remove one or more items from a List or Dictionary
Bram Moolenaar87b774d2005-07-20 22:04:36 +0000437|repeat()| repeat "expr" "count" times (Christophe Poucet)
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000438|reverse()| reverse the order of a List
Bram Moolenaarb982ca52005-03-28 21:02:15 +0000439|setqflist()| create a quickfix list (Yegappan Lakshmanan)
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000440|sort()| sort a List
Bram Moolenaar42eeac32005-06-29 22:40:58 +0000441|soundfold()| get the sound-a-like equivalent of a word
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000442|split()| split a String into a List
Bram Moolenaar42eeac32005-06-29 22:40:58 +0000443|spellbadword()| get a badly spelled word
444|spellsuggest()| get suggestions for correct spelling
Bram Moolenaar87b774d2005-07-20 22:04:36 +0000445|string()| string representation of a List or Dictionary
446|system()| filters {input} through a shell command
447|taglist()| get list of matching tags (Yegappan Lakshmanan)
448|tr()| translate characters (Ron Aaron)
Bram Moolenaarbac234e2005-01-17 22:21:07 +0000449|values()| get List of Dictionary values
Bram Moolenaar2a8d1f82005-02-05 21:43:56 +0000450|writefile()| write a list of lines into a file
Bram Moolenaar8299df92004-07-10 09:47:34 +0000451
Bram Moolenaarbee0c5b2005-02-07 22:03:36 +0000452User defined functions can now be loaded automatically from the "autoload"
453directory in 'runtimepath'. See |autoload-functions|.
454
Bram Moolenaar071d4272004-06-13 20:20:40 +0000455
456New autocommand events: ~
457
Bram Moolenaar8299df92004-07-10 09:47:34 +0000458|InsertEnter| starting Insert or Replace mode
459|InsertChange| going from Insert to Replace mode or back
460|InsertLeave| leaving Insert or Replace mode
Bram Moolenaar843ee412004-06-30 16:16:41 +0000461
Bram Moolenaar8299df92004-07-10 09:47:34 +0000462|ColorScheme| after loading a color scheme
Bram Moolenaarbee0c5b2005-02-07 22:03:36 +0000463|QuickFixCmdPre| before :make, :grep et al. (Ciaran McCreesh)
464|QuickFixCmdPost| after :make, :grep et al. (Ciaran McCreesh)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000465
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +0000466
Bram Moolenaarc0197e22004-09-13 20:26:32 +0000467New items in search patterns: ~
468|/\%d| \%d123 search for character with decimal number
469|/\]| [\d123] idem, in a colletion
470|/\%o| \%o103 search for character with octal number
471|/\]| [\o1o3] idem, in a colletion
472|/\%x| \%x1a search for character with 2 pos. hex number
473|/\]| [\x1a] idem, in a colletion
474|/\%u| \%u12ab search for character with 4 pos. hex number
475|/\]| [\u12ab] idem, in a colletion
476|/\%U| \%U1234abcd search for character with 8 pos. hex number
477|/\]| [\U1234abcd] idem, in a colletion
478 (The above partly by Ciaran McCreesh)
Bram Moolenaar13fcaaf2005-04-15 21:13:42 +0000479|/[[=| [[=a=]] an equivalence class (only for latin1 characters)
480|/[[.| [[.a.]] a collation element (only works with single char)
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000481
482Nesting |/multi| items no longer is an error when an empty match is possible.
483
484It is now possible to use \{0}, it matches the preceding atom zero times. Not
485useful, just for compatibility.
Bram Moolenaarc0197e22004-09-13 20:26:32 +0000486
487
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +0000488New Syntax/Indent/FTplugin files: ~
489
490MuPAD source syntax, indent and ftplugin. (Dave Silvia)
491
Bram Moolenaard4755bb2004-09-02 19:12:26 +0000492ABAB/4 syntax file. (Marius van Wyk)
493
494SQL-Informix syntax file. (Dean L Hill)
495
Bram Moolenaar15d0a8c2004-09-06 17:44:46 +0000496PHP compiler plugin. (Doug Kearns)
497
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000498Sive syntax file. (Nikolai Weibull)
499
Bram Moolenaar0e4d8772005-06-07 21:12:49 +0000500Pascal indent file. (Neil Carter)
501
Bram Moolenaar42eeac32005-06-29 22:40:58 +0000502Many filetype plugins and others from Nikolai Weibull.
503
Bram Moolenaarce0842a2005-07-18 21:58:11 +0000504Xquery syntax file. (Jean-Marc Vanel)
505
Bram Moolenaarb982ca52005-03-28 21:02:15 +0000506Moved all the indent settings from the filetype plugin to the indent file.
507Implemented b:undo_indent to undo indent settings when setting 'filetype' to a
508different value.
509
Bram Moolenaar15d0a8c2004-09-06 17:44:46 +0000510
Bram Moolenaar47136d72004-10-12 20:02:24 +0000511New Keymaps: ~
512
513Sinhala (Sri Lanka) (Harshula Jayasuriya)
514
515
Bram Moolenaar15d0a8c2004-09-06 17:44:46 +0000516New message translations: ~
517
518The Ukranian messages are now also available in cp1251.
519
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000520Irish message translations. (Kevin Patrick Scannell)
521
Bram Moolenaar05159a02005-02-26 23:04:13 +0000522Vietnamese message translations and menu. (Phan Vinh Thinh)
523
Bram Moolenaar071d4272004-06-13 20:20:40 +0000524
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000525Others: ~
526
527Mac: Add the selection type to the clipboard, so that Block, line and
528character selections can be used between two Vims. (Eckehard Berns)
529Also fixes the problem that setting 'clipboard' to "unnamed" breaks using
530"yyp".
Bram Moolenaar071d4272004-06-13 20:20:40 +0000531
Bram Moolenaar592e0a22004-07-03 16:05:59 +0000532Mac: GUI font selector. (Peter "Rain Dog" Cucka)
533
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000534Mac: support for multi-byte characters. (Da Woon Jung)
535
Bram Moolenaar2079a602005-01-04 21:43:22 +0000536GUI font selector for Motif. (Marcin Dalecki)
Bram Moolenaar567e4de2004-12-31 21:01:02 +0000537
Bram Moolenaarbee0c5b2005-02-07 22:03:36 +0000538Nicer toolbar buttons for Motif. (Marcin Dalecki)
539
Bram Moolenaar2079a602005-01-04 21:43:22 +0000540Mnemonics for the Motif find/replace dialog. (Marcin Dalecki)
Bram Moolenaar567e4de2004-12-31 21:01:02 +0000541
Bram Moolenaar46c9c732004-12-12 11:37:09 +0000542Mac: better integration with Xcode. Post a fake mouse-up event after the odoc
543event and the drag receive handler to work around a stall after Vim loads a
544file. Fixed an off-by-one line number error. (Da Woon Jung)
545
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000546Added the t_SI and t_EI escape sequences for starting and ending Insert mode.
547To be used to set the cursor shape to a bar or a block. No default values,
548they are not supported by termcap/terminfo.
549
Bram Moolenaarb5bf5b82004-12-24 14:35:23 +0000550Autocommands can be defined local to a buffer. This means they will also work
551when the buffer does not have a name or no specific name. See
552|autocmd-buflocal|. (Yakov Lerner)
553
Bram Moolenaar19a09a12005-03-04 23:39:37 +0000554For xterm most combinations of modifiers with function keys are recognized.
555|xterm-modifier-keys|
556
Bram Moolenaar071d4272004-06-13 20:20:40 +0000557==============================================================================
558IMPROVEMENTS *improvements-7*
559
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000560":helpgrep" accepts a language specifier after the pattern: "pat@it".
561
Bram Moolenaar8299df92004-07-10 09:47:34 +0000562Move the help for printing to a separate help file. It's quite a lot now.
563
Bram Moolenaar8bf59b92005-03-06 23:40:56 +0000564The pattern matching code was changed from a recursive function to an
565iterative mechanism. This avoids out-of-stack errors. State is stored in
566allocated memory, running out of memory can always be detected. Allows
567matching more complex things, but Vim may seem to hang while doing that.
568
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000569":breakadd here" and ":breakdel here" can be used to set or delete a
570breakpoint at the cursor.
571
Bram Moolenaar843ee412004-06-30 16:16:41 +0000572The tutor was updated to make it simpler to use and added text to explain a
573few more important commands. Used ideas from Gabriel Zachmann.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000574
Bram Moolenaarcfbc5ee2004-07-02 15:38:35 +0000575Unix: When libcall() fails obtain an error message with dlerror() and display
576it. (Johannes Zellner)
577
Bram Moolenaar592e0a22004-07-03 16:05:59 +0000578Added "nbsp" in 'listchars'. (David Blanchet)
579
Bram Moolenaar21cf8232004-07-16 20:18:37 +0000580Added the "acwrite" value for the 'buftype' option. This is for a buffer that
581doesn not have a name that refers to a file and is written with BufWriteCmd
582autocommands.
583
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000584For lisp indenting and matching parenthesis: (Sergey Khorev)
585- square brackets are recognized properly
586- #\(, #\), #\[ and #\] are recognized as character literals
587- Lisp line comments (delimited by semicolon) are recognized
588
Bram Moolenaar89cb5e02004-07-19 20:55:54 +0000589Added the "count" argument to match(), matchend() and matchstr(). (Ilya Sher)
590
Bram Moolenaar5eb86f92004-07-26 12:53:41 +0000591winnr() takes an optional "$" and "#" arguments. (Nikolai Weibull, Yegappan
592Lakshmanan)
593
594Added 'n' flag to search(): don't move the cursor. (Nikolai Weibull)
595
Bram Moolenaard4755bb2004-09-02 19:12:26 +0000596When uncompressing fails in the gzip plugin, give an error message but don't
597delete the raw text. Helps if the file has a .gz extension but is not
598actually compressed. (Andrew Pimlott)
599
600When C, C++ or IDL syntax is used, may additionally load doxygen syntax.
601Also support setting the filetype to "cdoxygen" for C plus doxygen syntax.
602(Michael Geddes)
603
604The ":registers" command now displays multi-byte characters properly.
605
606VMS: In the usage message mention that a slash can be used to make a flag
607upper case. Add color support to the builtin vt320 terminal codes.
608(Zoltan Arpadffy)
609
Bram Moolenaar15d0a8c2004-09-06 17:44:46 +0000610For the '%' item in 'viminfo', allow a number to set a maximum for the number
611of buffers.
612
Bram Moolenaarb5bf5b82004-12-24 14:35:23 +0000613The 'statusline' option can be local to the window, so that each window can
614have a different value. (partly by Yegappan Lakshmanan)
615
Bram Moolenaar3fdfa4a2004-10-07 21:02:47 +0000616When a file looks like a shell script, check for an "exec" command that starts
617the tcl interpreter. (suggested by Alexios Zavras)
618
619Support conversion between utf-8 and latin9 (iso-8859-15) internally, so that
620digraphs still work when iconv is not available.
621
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000622When a session file is loaded while editing an unnamed, empty buffer that
623buffer is wiped out. Avoids that there is an unused buffer in the buffer
624list.
625
626Win32: When libintl.dll supports bind_textdomain_codeset(), use it.
627(NAKADAIRA Yukihiro)
628
629When foldtext() finds no text after removing the comment leader, use the
630second line of the fold. Helps for C-style /* */ comments where the first
631line is just "/*".
632
Bram Moolenaar1cd871b2004-12-19 22:46:22 +0000633When editing the same file from two systems (e.g., Unix and MS-Windows) there
634mostly was no warning for an existing swap file, because the name of the
635edited file differs (e.g., y:\dir\file vs /home/me/dir/file). Added a flag to
636the swap file to indicate it is in the same directory as the edited file. The
637used path then doesn't matter and the check for editing the same file is much
638more reliable.
639
640Client-server communication now supports 'encoding'. When setting 'encoding'
641in a Vim server to "utf-8", and using "vim --remote fname" in a console,
642"fname" is converted from the console encoding to utf-8. Also allows Vims
643with different 'encoding' settings to exchange messages.
644
Bram Moolenaar86b68352004-12-27 21:59:20 +0000645Internal: Changed ga_room into ga_maxlen, so that it doesn't need to be
646incremented/decremented each time.
647
Bram Moolenaar2079a602005-01-04 21:43:22 +0000648Included a few improvements for Motif from Marcin Dalecki. Draw label
Bram Moolenaar567e4de2004-12-31 21:01:02 +0000649contents ourselves to make them handle fonts in a way configurable by Vim and
650a bit less dependent on the X11 font management.
651
Bram Moolenaar49cd9572005-01-03 21:06:01 +0000652When a register is empty it is not stored in the viminfo file.
653
Bram Moolenaar8c711452005-01-14 21:53:12 +0000654Removed the tcltags script, it's obsolete.
655
Bram Moolenaar67fe1a12005-05-22 22:12:58 +0000656":redir @*>>" and ":redir @+>>" append to the clipboard. Better check for
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000657invalid characters after the register name. |:redir|
658
659":redir => variable" and ":redir =>> variable" write or append to a variable.
660(Yegappan Lakshmanan) |:redir|
Bram Moolenaardcaf10e2005-01-21 11:55:25 +0000661
Bram Moolenaar231334e2005-07-25 20:46:57 +0000662":redir @{a-z}>>" appends to register a to z. (Yegappan Lakshmanan)
Bram Moolenaar67fe1a12005-05-22 22:12:58 +0000663
Bram Moolenaar54ee7752005-05-31 22:22:17 +0000664The 'verbosefile' option can be used to log messages in a file. Verbose
665messages are not displayed then. The "-V{filename}" argument can be used to
666log startup messages.
667
Bram Moolenaardcaf10e2005-01-21 11:55:25 +0000668":let g:" lists global variables.
669":let b:" lists buffer-local variables.
670":let w:" lists window-local variables.
671":let v:" lists Vim variables.
672
Bram Moolenaard438e912005-01-31 19:21:46 +0000673The stridx() and strridx() functions take a third argument, where to start
674searching. (Yegappan Lakshmanan)
Bram Moolenaarb71ec9f2005-01-25 22:22:02 +0000675
Bram Moolenaar67fe1a12005-05-22 22:12:58 +0000676The getreg() function takes an extra argument to be able to get the expression
677for the '=' register instead of the result of evaluating it.
678
679The setline() function can take a List argument to set multiple lines. When
680the line number is just below the last line the line is appended.
681
Bram Moolenaarbee0c5b2005-02-07 22:03:36 +0000682g CTRL-G also shows the number of characters if it differs from the number of
683bytes.
684
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000685Completion for ":debug" and entering an expression for the '=' register. Skip
686":" between range and command name. (Peter winters)
687
688CTRL-Q in Insert mode now works like CTRL-V by default. Previously it was
689ignored.
690
691When "beep" is included in 'debug' a function or script that causes a beep
692will result in a message with the source of the error.
693
Bram Moolenaar05159a02005-02-26 23:04:13 +0000694When completing buffer names, match with "\(^\|[\/]\)" instead of "^", so that
695":buf stor<Tab>" finds both "include/storage.h" and "storage/main.c".
696
697To count items (pattern matches) without changing the buffer the 'n' flag has
698been added to |:substitute|. See |count-items|.
699
Bram Moolenaar038eb0e2005-02-27 22:43:26 +0000700The "screen.linux" $TERM name is recognized to set the default for
Bram Moolenaar19a09a12005-03-04 23:39:37 +0000701'background' to "dark". (Ciaran McCreesh) Also for "cygwin".
702
703The |FileChangedShell| autocommand event can now use the |v:fcs_reason|
704variable that specifies what triggered the event. |v:fcs_choice| can be used
705to reload the buffer or ask the user what to do.
Bram Moolenaar038eb0e2005-02-27 22:43:26 +0000706
Bram Moolenaar8bf59b92005-03-06 23:40:56 +0000707Not all modifiers were recognized for xterm function keys. Added the
708possibility in term codes to end in ";*X" or "O*X", where X is any character
709and the * stands for the modifier code.
710Added the <xUp>, <xDown>, <xLeft> and <xRight> keys, to be able to recognize
711the two forms that xterm can send their codes in and still handle all possible
712modifiers.
713
Bram Moolenaarc0761132005-03-18 20:30:32 +0000714getwinvar() now also works to obtain a buffer-local option from the specified
715window.
716
Bram Moolenaarb982ca52005-03-28 21:02:15 +0000717Added the "%s" item to 'errorformat'. (Yegappan Lakshmanan)
718
Bram Moolenaar34cdc3e2005-05-18 22:24:46 +0000719GTK GUI: use the GTK file dialog when it's available. Mix from patches by
720Grahame Bowland and Evan Webb.
721
Bram Moolenaar9ba0eb82005-06-13 22:28:56 +0000722Added ":scriptnames" to bugreport.vim, so that we can see what plugins were
723used.
724
Bram Moolenaar520470a2005-06-16 21:59:56 +0000725Win32: If the user changes the setting for the number of lines a scroll wheel
726click scrolls it is now used immediately. Previously Vim would need to be
727restarted.
728
Bram Moolenaarb2ec3072005-06-17 22:02:20 +0000729When using @= in an expression the value is expression @= contains. ":let @=
730= value" can be used to set the register contents.
731
Bram Moolenaar51bab742005-07-08 22:31:03 +0000732A ! can be added to ":popup" to have the popup menu appear at the mouse
733pointer position instead of the text cursor.
734
Bram Moolenaard8e9bb22005-07-09 21:14:46 +0000735The table with encodings has been expanded with many MS-Windows codepages,
736such as cp1250 and cp737, so that these can also be used on Unix without
737prepending "8bit-".
738
739Added the "customlist" completion argument to a user-defined command. The
740user-defined completion function should return the completion candidates as a
Bram Moolenaar231334e2005-07-25 20:46:57 +0000741Vim List and the returned results are not filtered by Vim. (Yegappan
742Lakshmanan)
Bram Moolenaard8e9bb22005-07-09 21:14:46 +0000743
Bram Moolenaar342337a2005-07-21 21:11:17 +0000744Win32: Balloons can have multiple lines if common controls supports it.
745(Sergey Khorev)
746
Bram Moolenaar231334e2005-07-25 20:46:57 +0000747The 's' flag is added to the search() and searchpair() function to set the
748' mark if the cursor is moved. (Yegappan Lakshmanan)
749
Bram Moolenaar661b1822005-07-28 22:36:45 +0000750When 'verbose' is set the output of ":highlight" will show where a highlight
751item was last set.
752
Bram Moolenaar0be6e642005-08-04 21:32:22 +0000753For 'errorformat' it was not possible to have a file name that contains the
754character that follows after "%f". For example, in "%f:%l:%m" the file name
755could not contain ":". Now include the first ":" where the rest of the
756pattern matches. In the example a ":" not followed by a line number is
757included in the file name. (suggested by Emanuele Giaquinta)
758
Bram Moolenaar071d4272004-06-13 20:20:40 +0000759==============================================================================
760COMPILE TIME CHANGES *compile-changes-7*
761
Bram Moolenaar2079a602005-01-04 21:43:22 +0000762Dropped the support for the BeOS and Amiga GUI. They were not maintained and
763probably didn't work. If you want to work on this: get the Vim 6.x version
764and merge it back in.
765
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000766Mac: "make" now creates the Vim.app directory and "make install" copies it to
767its final destination. (Raf)
768
769Mac: Made it possible to compile with Motif, Athena or GTK without tricks and
770still being able to use the MacRoman conversion. Added the os_mac_conv.c
771file.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000772
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000773When running the tests and one of them fails to produce "test.out" the
774following tests are still executed. This helps when running out of memory.
775
Bram Moolenaarf461c8e2005-06-25 23:04:51 +0000776When compiling with EXITFREE defined and the ccmalloc library it is possible
777to detect memory leaks. Some memory will always reported as leaked, such as
778allocated by X11 library functions and the memory allocated in alloc_cmdbuff()
779to store the ":quit" command.
780
Bram Moolenaar231334e2005-07-25 20:46:57 +0000781Moved the code for printing to src/hardcopy.c.
782
783Moved some code from main() to separate functions to make it easier to see
784what is being done. Use a structure to avoid a lot of arguments to the
785functions.
786
787Moved unix_expandpath() to misc1.c, so that it can also be used by os_mac.c
788without copying the code.
789
Bram Moolenaar071d4272004-06-13 20:20:40 +0000790==============================================================================
791BUG FIXES *bug-fixes-7*
792
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000793When using PostScript printing on MS-DOS the default 'printexpr' used "lpr"
794instead of "copy". When 'printdevice' was empty the copy command did not
795work. Use "LPT1" then.
796
797The GTK font dialog uses a font size zero when the font name doesn't include a
798size. Use a default size of 10.
799
800This example in the documentation didn't work:
801 :e `=foo . ".c" `
802Skip over the expression in `=expr` when looking for comments, |, % and #.
803
804When ":helpgrep" doesn't find anything there is no error message.
805
806"L" and "H" did not take closed folds into account.
807
808Win32: The "-P title" argument stopped at the first title that matched, even
809when it doesn't support MDI.
810
811Mac GUI: CTRL-^ and CTRL-@ did not work.
812
813"2daw" on "word." at the end of a line didn't include the preceding white
814space.
815
816Win32: Using FindExecutable() doesn't work to find a program. Use
817SearchPath() instead. For executable() use $PATHEXT when the program searched
818for doesn't have an extension.
819
820When 'virtualedit' is set, moving the cursor up after appending a character
821may move it to a different column. Was caused by auto-formatting moving the
822cursor and not putting it back where it was.
823
824When indent was added automatically and then moving the cursor, the indent was
825not deleted (like when pressing ESC). The "I" flag in 'cpoptions' can be used
826to make it work the old way.
827
Bram Moolenaarf4b8e572004-06-24 15:53:16 +0000828When opening a command-line window, 'textwidth' gets set to 78 by the Vim
829filetype plugin. Reset 'textwidth' to 0 to avoid lines are broken.
830
831After using cursor(line, col) moving up/down doesn't keep the same column.
832
833Win32: Borland C before 5.5 requires using ".u." for LowPart and HighPart
834fields. (Walter Briscoe)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000835
Bram Moolenaar843ee412004-06-30 16:16:41 +0000836On Sinix SYS_NMLN isn't always defined. Define it ourselves. (Cristiano De
837Michele)
838
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000839Printing with PostScript may keep the printer waiting for more. Append a
840CTRL-D to the printer output. (Mike Williams)
841
Bram Moolenaar2df6dcc2004-07-12 15:53:54 +0000842When converting a string with a hex or octal number the leading '-' was
843ignored. ":echo '-05' + 0" resulted in 5 instead of -5.
844
845Using "@:" to repeat a command line didn't work when it contains control
846characters.
847
Bram Moolenaar21cf8232004-07-16 20:18:37 +0000848When using file completion for a user command, it would not expand environment
849variables like for a regular command with a file argument.
850
851'cindent': When the argument of a #define looks like a C++ class the next line
852is indented too much.
853
854When 'comments' includes multi-byte characters inserting the middle part and
855alignment may go wrong. 'cindent' also suffers from this for right-aligned
856items.
857
Bram Moolenaar05159a02005-02-26 23:04:13 +0000858Win32: when 'encoding' is set to "utf-8" getenv() still returns strings in the
859active codepage. Convert to utf-8. Also for $HOME.
860
Bram Moolenaarab79bcb2004-07-18 21:34:53 +0000861The default for 'helplang' was "zh" for both "zh_cn" and "zh_tw". Now use
862"cn" or "tw" as intended.
863
Bram Moolenaar5eb86f92004-07-26 12:53:41 +0000864When 'bin' is set and 'eol' is not set then line2byte() added the line break
865after the last line while it's not there.
866
867Using foldlevel() in a WinEnter autocommand may not work. Noticed when
868resizing the GUI shell upon startup.
869
870Python: Using buffer.append(f.readlines()) didn't work. Allow appending a
871string with a trailing newline. The newline is ignored.
872
Bram Moolenaar269ec652004-07-29 08:43:53 +0000873When using the ":saveas f2" command for buffer "f1", the Buffers menu would
874contain "f2" twice, one of them leading to "f1". Also trigger the BufFilePre
875and BufFilePost events for the alternate buffer that gets the old name.
876
Bram Moolenaard4755bb2004-09-02 19:12:26 +0000877strridx() did not work well when the needle is empty. (Ciaran McCreesh)
878
879GTK: Avoid a potential hang in gui_mch_wait_for_chars() when input arrives
880just before it is invoked
881
882VMS: Occasionally CR characters were inserted in the file. Expansion of
883environment variables was not correct. (Zoltan Arpadffy)
884
885UTF-8: When 'delcombine' is set "dw" only deleted the last combining character
886from the first character of the word.
887
888When using ":sball" in an autocommand only the filetype in one buffer was
889detected. Reset did_filetype in enter_buffer().
890
891When using ":argdo" and the window already was at the first argument index,
892but not actually editing it, the current buffer would be used instead.
893
Bram Moolenaar15d0a8c2004-09-06 17:44:46 +0000894When ":next dir/*" includes many matches, adding the names to the argument
895list may take an awful lot of time and can't be interrupted. Allow
896interrupting this.
897
898When editing a file that was already loaded in a buffer, modelines were not
899used. Now window-local options in the modeline are set. Buffer-local options
900and global options remain unmodified.
901
902Win32: When 'encoding' is set to "utf-8" in the vimrc file, files from the
903command line with non-ASCII characters are not used correctly. Recode the
904file names when 'encoding' is set, using the Unicode command line.
905
Bram Moolenaarc0197e22004-09-13 20:26:32 +0000906Win32 console: When the default for 'encoding' ends up to be "latin1", the
907default value of 'isprint' was wrong.
908
909When an error message is given while waiting for a character (e.g., when an
910xterm reports the number of colors), the hit-enter prompt overwrote the last
911line. Don't reset msg_didout in normal_cmd() for K_IGNORE.
912
Bram Moolenaar3fdfa4a2004-10-07 21:02:47 +0000913Mac GUI: Shift-Tab didn't work.
914
915When defining tooltip text, don't translate terminal codes, since it's not
916going to be used like a command.
917
918GTK 2: Check the tooltip text for valid utf-8 characters to avoid getting a
919GTK error. Invalid characters may appear when 'encoding' is changed.
920
921GTK 2: Add a safety check for invalid utf-8 sequences, they can crash pango.
922
923Win32: When 'encoding' is changed while starting up, use the Unicode command
924line to convert the file arguments to 'encoding'. Both for the GUI and the
925console version.
926
927Win32 GUI: latin9 text (iso-8859-15) was not displayed correctly, because
928there is no codepage for latin9. Do our own conversion from latin9 to UCS2.
929
Bram Moolenaar7b0294c2004-10-11 10:16:09 +0000930When two versions of GTK+ 2 are installed it was possible to use the header
931files from one and the library from the other. Use GTK_LIBDIR to put the
932directory for the library early in the link flags.
933
934With the GUI find/replace dialog a replace only worked if the pattern was
935literal text. Now it works for any pattern.
936
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000937When 'equalalways' is set and 'eadirection' is "hor", ":quit" would still
938cause equalizing window heights in the vertical direction.
939
940When ":emenu" is used in a startup script the command was put in the typeahead
941buffer, causing a prompt for the crypt key to be messed up.
942
943Mac OS/X: The default for 'isprint' included characters 128-160, causes
944problems for Terminal.app.
945
946When a syntax item with "containedin" is used, it may match in the start or
947end of a region with a matchgroup, while this doesn't happen for a "contains"
948argument.
949
950When a transparent syntax items matches in another item where the highlighting
951has already stopped (because of a he= argument), the highlighting would come
952back.
953
954When cscope is used to set the quickfix error list, it didn't get set if there
955was only one match. (Sergey Khorev)
956
957When 'confirm' is set and using ":bdel" in a modified buffer, then selecting
958"cancel", would still give an error message.
959
960The PopUp menu items that started Visual mode didn't work when not in Normal
961mode. Switching between selecting a word and a line was not possible.
962
963Win32: The keypad decimal point always resulted in a '.', while on some
964keyboards it's a ','. Use MapVirtualKey(VK_DECIMAL, 2).
965
966Removed unused function DisplayCompStringOpaque() from gui_w32.c
967
968In Visual mode there is not always an indication whether the line break is
969selected or not. Highlight the character after the line when the line break
970is included, e.g., after "v$o".
971
972GTK: The <F10> key can't be mapped, it selects the menu. Disable that with a
973GTK setting and do select the menu when <F10> isn't mapped. (David Necas)
974
975After "Y" '[ and '] were not at start/end of the yanked text.
976
977When a telnet connection is dropped Vim preserves files and exits. While
978doing that a SIGHUP may arrive and disturbe us, thus ignore it. (Scott
Bram Moolenaar46c9c732004-12-12 11:37:09 +0000979Anderson) Also postpone SIGHUP, SIGQUIT and SIGTERM until it's safe to
980handle. Added handle_signal().
981
982When using "set laststatus=2 cmdheight=2" in the .gvimrc you may only get one
983line for the cmdline. (Christian Robinson) Invoke command_height() after the
984GUI has started up.
Bram Moolenaar293ee4d2004-12-09 21:34:53 +0000985
Bram Moolenaar1cd871b2004-12-19 22:46:22 +0000986When completing a file name on the command line backslashes are required for
987white space. Was only done for a space, not for a Tab.
988
989When configure could not find a terminal library, compiling continued for a
990long time before reporting the problem. Added a configure check for tgetent()
991being found in a library.
992
993When the cursor is on the first char of the last line a ":g/pat/s///" command
994may cause the cursor to be displayed below the text.
995
996Win32: Editing a file with non-ASCII characters doesn't work when 'encoding'
997is "utf-8". use _wfullpath() instead of _fullpath(). (Yu-sung Moon)
998
999When recovering the 'fileformat' and 'fileencoding' were taken from the
1000original file instead of from the swapfile. When the file didn't exist, was
1001empty or the option was changed (e.g., with ":e ++fenc=cp123 file") it could
1002be wrong. Now store 'fileformat' and 'fileencoding' in the swapfile and use
1003the values when recovering.
1004
1005":bufdo g/something/p" overwrites each last printed text line with the file
1006message for the next buffer. Temporarily clear 'shortmess' to avoid that.
1007
Bram Moolenaarb5bf5b82004-12-24 14:35:23 +00001008Win32: Cannot edit a file starting with # with --remote. Do escape % and #
1009when building the ":drop" command.
1010
Bram Moolenaar86b68352004-12-27 21:59:20 +00001011A comment or | just after a expresion-backtick argument was not recognized.
1012E.g. in :e `="foo"`"comment.
1013
Bram Moolenaar567e4de2004-12-31 21:01:02 +00001014"(" does not stop at an empty sentence (single dot and white space) while ")"
1015does. Also breaks "das" on that dot.
1016
1017When doing "yy" with the cursor on a TAB the ruler could be wrong and "k"
1018moved the cursor to another column.
1019
1020When 'commentstring' is '"%s' and there is a double quote in the line a double
1021quote before the fold marker isn't removed in the text displayed for a closed
1022fold.
1023
1024In Visual mode, when 'bin' and 'eol' set, g CTRL-G counted the last line
1025break, resulting in "selected 202 of 201 bytes".
1026
Bram Moolenaar2079a602005-01-04 21:43:22 +00001027Motif: fonts were not used for dialog components. (Marcin Dalecki)
Bram Moolenaar567e4de2004-12-31 21:01:02 +00001028
Bram Moolenaar49cd9572005-01-03 21:06:01 +00001029Motif: After using a toolbar button the keyboard focus would be on the toolbar
Bram Moolenaar2079a602005-01-04 21:43:22 +00001030(Lesstif problem). (Marcin Dalecki)
Bram Moolenaar49cd9572005-01-03 21:06:01 +00001031
Bram Moolenaar1c2fda22005-01-02 11:43:19 +00001032When using "y<C-V>`x" where mark x is in the first column, the last line was
1033not included.
1034
1035Not all test scripts work properly on MS-Windows when checked out from CVS.
1036Use a Vim command to fix all fileformats to dos before executing the tests.
1037
1038When using ":new" and the file fits in the window, lines could still be above
1039the window. Now remove empty lines instead of keeping the relative position.
1040
Bram Moolenaar3d60ec22005-01-05 22:19:46 +00001041Cmdline completion didn't work after ":let var1 var<Tab>".
1042
Bram Moolenaarb7d6e722005-01-09 21:22:45 +00001043When using ":startinsert" or ":startreplace" when already in Insert mode
1044(possible when using CTRL-R =), pressing Esc would directly restart Insert
1045mode. (Peter Winters)
1046
Bram Moolenaar31c67ef2005-01-11 21:34:41 +00001047"2daw" didn't work at end of file if the last word is a single character.
1048
Bram Moolenaar8c711452005-01-14 21:53:12 +00001049Completion for ":next a'<Tab>" put a backslash before single quote, but it was
1050not removed when editing a file. Now halve backslashes in save_patterns().
Bram Moolenaar798c5a72005-01-16 22:06:30 +00001051Also fix expanding a file name with the shell that contains "\'".
Bram Moolenaar8c711452005-01-14 21:53:12 +00001052
Bram Moolenaarb71ec9f2005-01-25 22:22:02 +00001053When doing "1,6d|put" only "fewer lines" was reported. Now a following "more
1054lines" overwrites the message.
1055
1056Configure could not handle "-Dfoo=long\ long" in the TCL config output.
1057
Bram Moolenaarb2956cd2005-01-27 14:42:53 +00001058When searching backwards, using a pattern that matches a newline and uses \zs
1059after that, didn't find a match. Could also get a hang or end up in the right
1060column in the wrong line.
1061
Bram Moolenaard438e912005-01-31 19:21:46 +00001062When $LANG is "sl" for slovenian, the slovak menu was used, since "slovak"
1063starts with "sl".
1064
1065When 'paste' is set in the GUI the Paste toolbar button doesn't work. Clear
1066'paste' when starting the GUI.
1067
Bram Moolenaarf5836682005-02-02 23:09:45 +00001068A message about a wrong viminfo line included the trailing NL.
1069
Bram Moolenaar2a8d1f82005-02-05 21:43:56 +00001070When 'paste' is set in the GUI the toolbar button doesn't work in Insert mode.
1071Use ":exe" in menu.vim to avoid duplicating the commands, instead of using a
1072mapping.
1073
1074Treat "mlterm" as an xterm-like terminal. (Seiichi Sato)
1075
1076":z.4" and ":z=4" didn't work Vi compatible.
1077
Bram Moolenaarbee0c5b2005-02-07 22:03:36 +00001078When sourcing a file, editing it and sourcing it again, it could appear twice
1079in ":scriptnames" and get a new <SID>, because the inode has changed.
1080
1081When $SHELL is set but empty the 'shell' option would be empty. Don't use an
1082empty $SHELL value.
1083
1084A command "w! file" in .vimrc or $EXINIT didn't work. Now it writes an empty
1085file.
1086
1087When a CTRL-F command at the end of the file failed, the cursor was still
1088moved to the start of the line. Now it remains where it is.
1089
1090When using ":s" or "&" to repeat the last substitute and "$" was used to put
1091the cursor in the last column, put the cursor in the last column again. This
1092is Vi compatible.
1093
Bram Moolenaar4399ef42005-02-12 14:29:27 +00001094Vim is not fully POSIX compliant but sticks with traditional Vi behavior.
1095Added a few flags in 'cpoptions' to behave the POSIX way when wanted. The
1096$VIM_POSIX environment variable is checked to set the default.
1097
1098Appending to a register didn't insert a line break like Vi. Added the '>'
1099flag to 'cpoptions' for this.
1100
1101Using "I" in a line with only blanks appended to the line. This is not Vi
1102compatible. Added the 'H' flag in 'coptions' for this.
1103
1104When joining multiple lines the cursor would be at the last joint, but Vi
1105leaves it at the position where "J" would put it. Added the 'q' flag in
1106'cpoptions' for this.
1107
1108Autoindent didn't work for ":insert" and ":append".
1109
1110Using ":append" in an empty buffer kept the dummy line. Now it's deleted to
1111be Vi compatible.
1112
1113When reading commands from a file and stdout goes to a terminal, would still
1114request the xterm version. Vim can't read it, thus the output went to the
1115shell and caused trouble there.
1116
Bram Moolenaar5313dcb2005-02-22 08:56:13 +00001117When redirecting to a register with an invalid name the redirection would
1118still be done (after an error message). Now reset "redir_reg". (Yegappan
1119Lakshmanan)
1120
1121It was not possible to use a NL after a backslash in Ex mode. This is
1122sometimes used to feed multiple lines to a shell command.
1123
Bram Moolenaar05159a02005-02-26 23:04:13 +00001124When 'cmdheight' is set to 2 in .vimrc and the GUI uses the number of lines
1125from the terminal we actually get 3 lines for the cmdline in gvim.
1126
1127When setting $HOME allocated memory would leak.
1128
Bram Moolenaar19a09a12005-03-04 23:39:37 +00001129Win32: bold characters may sometimes write in another character cell. Use
1130unicodepdy[] as for UTF-8. (Taro Muraoka)
1131
1132":w fname" didn't work for files with 'buftype' set to "nofile".
1133
Bram Moolenaare2ac10d2005-03-07 23:26:06 +00001134The method used to locate user commands for completion differed from when they
1135are executed. Abiguous command names were not completed properly.
1136
Bram Moolenaar9062a9d2005-03-08 22:46:26 +00001137Incremental search may cause a crash when there is a custom statusline that
1138indirectly invokes ":normal".
1139
1140Diff mode failed when $DIFF_OPTIONS was set in the environment. Unset it
1141before invoking "diff".
1142
Bram Moolenaar4ad237d2005-03-11 22:49:40 +00001143Completion didn't work after ":argdo", ":windo" and ":bufdo". Also for ":set
1144&l:opt" and ":set &g:opt". (Peter Winters)
1145
1146When setting 'ttymouse' to "dec" in an xterm that supports the DEC mouse
1147locator it doesn't work. Now switch off the mouse before selecting another
1148mouse model.
1149
Bram Moolenaarfb269802005-03-15 22:46:30 +00001150When the CursorHold event is triggered and the commands peek for typed
1151characters the typeahead buffer may be messed up, e.g., when a mouse-up event
1152is received. Avoid invoking the autocommands from the function waiting for a
1153character, let it put K_CURSORHOLD in the input buffer.
1154
1155Removed the "COUNT" flag from ":argadd", to avoid ":argadd 1*" to be used like
Bram Moolenaarc0761132005-03-18 20:30:32 +00001156":1argadd *". Same for ":argdelete" and ":argedit".
Bram Moolenaarfb269802005-03-15 22:46:30 +00001157
1158Avoid that $LANG is used for the menus when LC_MESSAGES is "en_US".
1159
Bram Moolenaarc0761132005-03-18 20:30:32 +00001160Added backslashes before dashes in the vim.1 manual page to make the appear as
1161real dashes. (Pierr Habouzit)
1162
1163Where "gq" left the cursor depended on the value of 'formatprg'. Now "gq"
1164always leaves the cursor at the last line of the formatted text.
1165
1166When editing a compressed file, such as "changelog.Debian.gz" file, filetype
1167detection may try to check the contents of the file while it's still
1168compressed. Skip setting 'filetype' for compressed files until they have been
1169decompressed. Required for patterns that end in a "*".
1170
1171Starting with an argument "+cmd" or "-S script" causes the cursor the be moved
1172to the first line. That breaks a BufReadPost autocommand that uses g`".
1173Don't move the cursor if it's somewhere past the first line.
1174
1175"gg=G" while 'modifiable' is off was uninterruptable.
1176
Bram Moolenaar60c78922005-03-20 22:40:14 +00001177When 'encoding' is "sjis" inserting CTRL-V u d800 a few times causes a crash.
1178Don't insert a DBCS character with a NUL second byte.
1179
Bram Moolenaar2641f772005-03-25 21:58:17 +00001180In Insert mode CTRL-O <Home> didn't move the cursor. Made "ins_at_eol" global
1181and reset it in nv_home().
1182
Bram Moolenaarb982ca52005-03-28 21:02:15 +00001183Wildcard expansion failed: ":w /tmp/$$.`echo test`". Don't put quotes around
1184spaces inside backticks.
1185
Bram Moolenaar13fcaaf2005-04-15 21:13:42 +00001186After this sequence of commands: Y V p gv: the wrong line is selected. Now
1187let "gv" select the text that was put, since the original text is deleted.
1188This should be the most useful thing to do.
1189
1190":sleep 100u" sleeps for 100 seconds, not 100 usec as one might expect. Give
1191an error message when the argument isn't recognized.
1192
1193In gui_mch_draw_string() in gui_w32.c "unibuflen" wasn't static, resulting in
1194reallocating the buffer every time. (Alexei Alexandrov)
1195
Bram Moolenaar0e21a3f2005-04-17 20:28:32 +00001196When using a Python "atexit" function it was not invoked when Vim exits. Now
1197call Py_Finalize() for that. (Ugo Di Girolamo)
Bram Moolenaar9ba0eb82005-06-13 22:28:56 +00001198This breaks the thread stuff though, fixed by Ugo.
Bram Moolenaar0e21a3f2005-04-17 20:28:32 +00001199
Bram Moolenaardba8a912005-04-24 22:08:39 +00001200GTK GUI: using a .vimrc with "set cmdheight=2 lines=43" and ":split" right
1201after startup, the window layout is messed up. (Michael Schaap) Added
1202win_new_shellsize() call in gui_init() to fix the topframe size.
1203
1204Trick to get ...MOUSE_NM not used when there are vertical splits. Now pass
1205column -1 for the left most window and add MOUSE_COLOFF for others. Limits
1206mouse column to 10000.
1207
1208searchpair() may hang when the end pattern has "\zs" at the end. Check that
1209we find the same position again and advance one character.
1210
1211When in diff mode and making a change that causes the "changed" highlighting
1212to disappear or reappear, it was still highlighted in another window.
1213
Bram Moolenaar34cdc3e2005-05-18 22:24:46 +00001214When a ":next" command fails because the user selects "Abort" at the ATTENTION
1215prompt the argument index was advanced anyway.
1216
1217When "~" is in 'iskeyword' the "gd" doesn't work, it's used for the previous
1218substitute pattern. Put "\V" in the pattern to avoid that.
1219
Bram Moolenaar555b2802005-05-19 21:08:39 +00001220Use of sprintf() sometimes didn't check properly for buffer overflow. Also
1221when using smsg(). Included code for snprintf() to avoid having to do size
1222checks where invoking them
1223
Bram Moolenaarf4630b62005-05-20 21:31:17 +00001224":help \=<Tab>" didn't find "sub-replace-\=". Wild menu for help tags didn't
1225show backslashes. ":he :s\=" didn't work.
1226
1227When reading an errorfile "~/" in a file name was not expanded.
1228
1229GTK GUI: When adding a scrollbar (e.g. when using ":vsplit") in a script or
1230removing it the window size may change. GTK sends us resize events when we
1231change the window size ourselves, but they may come at an unexpected moment.
1232Peek for a character to get any window resize events and fix 'columns' and
1233'lines' to undo this.
1234
Bram Moolenaar67fe1a12005-05-22 22:12:58 +00001235After deleting files from the argument list a session file generated with
1236":mksession" may contain invalid ":next" commands.
1237
1238When 'shortmess' is empty and 'keymap' set to accents, in Insert mode CTRL-N
1239may cause the hit-enter prompt. Typing 'a then didn't result in the accented
1240character. Put the character typed at the prompt back in the typeahead buffer
1241so that mapping is done in the right mode.
1242
Bram Moolenaarb2ec3072005-06-17 22:02:20 +00001243setbufvar() and setwinvar() did not give error messages.
1244
1245It was possible to set a variable with an illegal name, e.g. with setbufvar().
Bram Moolenaard857f0e2005-06-21 22:37:39 +00001246It was possible to define a function with illegal name, e.t. ":func F{-1}()"
1247
1248CTRL-W F and "gf" didn't use the same method to get the file name.
Bram Moolenaarb2ec3072005-06-17 22:02:20 +00001249
Bram Moolenaar42eeac32005-06-29 22:40:58 +00001250When reporting a conversion error the line number of the last error could be
1251given. Now report the first encountered error.
1252
1253When using ":e ++enc=name file" and iconv() was used for conversion an error
1254caused a fallback to no conversion. Now replace a character with '?' and
1255continue.
1256
Bram Moolenaar51bab742005-07-08 22:31:03 +00001257When opening a new buffer the local value of 'bomb' was not initialized from
1258the global value.
1259
Bram Moolenaare759a7a2005-07-12 22:50:18 +00001260Win32: When using the "Edit with Vim" entry the file name was limited to about
1261200 characters.
1262
Bram Moolenaar342337a2005-07-21 21:11:17 +00001263When using command line completion for ":e *foo" and the file "+foo" exists
1264the resulting command ":e +foo" doesn't work. Now insert a backslash: ":e
1265\+foo".
1266
Bram Moolenaar87e25fd2005-07-27 21:13:01 +00001267When the translation of "-- More --" was not 10 characters long the following
1268message would be in the wrong position.
1269
1270At the more-prompt the last character in the last line wasn't drawn.
1271
1272When deleting non-existing text while 'virtualedit' is set the '[ and '] marks
1273were not set.
1274
Bram Moolenaar0be6e642005-08-04 21:32:22 +00001275Win32: Could not use "**/" in 'path', it had to be "**\".
1276
Bram Moolenaar071d4272004-06-13 20:20:40 +00001277 vim:tw=78:ts=8:ft=help:norl: