*version8.txt* For Vim version 8.0. Last change: 2016 Jun 04 VIM REFERENCE MANUAL by Bram Moolenaar NOTE: THIS FILE IS STILL BEING WORKED ON *vim8* *vim-8* *version-8.0* *version8.0* Welcome to Vim 8! A large number of bugs have been fixed and several features have been added. This file mentions all the new items and changes to existing features since Vim 7.4. Bug fixes, the patches for Vim 7.4, can be found below |vim-7.4|. Use this command to see the version you are using: > :version See |vi_diff.txt| for an overview of differences between Vi and Vim 7.0. See |version4.txt|, |version5.txt|, |version6.txt| and |version7.txt| for differences between other versions. INCOMPATIBLE CHANGES |incompatible-8| NEW FEATURES |new-8| Vim script enhancements |new-vim-script-8| IMPROVEMENTS |improvements-8| COMPILE TIME CHANGES |compile-changes-8| PATCHES |patches-8| ============================================================================== INCOMPATIBLE CHANGES *incompatible-8* These changes are incompatible with previous releases. Check this list if you run into a problem when upgrading from Vim 7.4 to 8.0. The support for MS-DOS has been removed. It hasn't been working for a while and removing it cleans up the code quite a bit. The support for Windows 16 bit (Windows 95 and older) has been removed. Minor incompatibilities: For filetype detection: ... ============================================================================== NEW FEATURES *new-8* First a list of the bigger new features. A comprehensive list is below. Asynchronous I/O support, channels ~ Vim can now exchange messages with another process in the background. The messages are received and handled while Vim is waiting for a character. See |channel-demo| for an example, communicating with a Python server. Closely related to channels is JSON support. JSON is widely supported and can easily be used for inter-process communication, allowing for writing a server in any language. The functions to use are |json_encode()| and |json_decode()|. Jobs ~ Vim can now start a job, communicate with it and stop it. This is very useful to run a process for completion, syntax checking, etc. Channels are used to communicate with the job. Jobs can also read from or write to a buffer or a file. See |job_start()|. Timers ~ Also asynchronous are timers. They can fire once or repeatedly and invoke a function to do any work. For example: > let tempTimer = timer_start(4000, 'CheckTemp') This will make a call four seconds (4000 milli seconds) later, like: > call CheckTemp() Partials ~ Vim already had a Funcref, a reference to a function. A partial also refers to a function, and additionally binds arguments and/or a dictionary. This is especially useful for callbacks on channels and timers. E.g., for the timer example above, to pass an argument to the function: > let tempTimer = timer_start(4000, function('CheckTemp', ['out'])) This will a make call four seconds later, like: > call CheckTemp('out') Packages ~ Plugins keep growing and more of them are available than ever before. To keep the collection of plugins manageable package support has been added. This is a convenient way to get one or more plugins, drop them in a directory and possibly keep them updated. Vim will load them automatically, or only when desired. See |packages|. New style tests ~ This is for Vim developers. So far writing tests for Vim has not been easy. Vim 8 adds assert functions and a framework to run tests. This makes it a lot simpler to write tests and keep them updated. Also new are several functions that are added specifically for testing. These functions have been added: |assert_equal()| |assert_notequal()| |assert_exception()| |assert_fails()| |assert_false()| |assert_match()| |assert_notmatch()| |assert_true()| |test_alloc_fail()| |test_disable_char_avail()| |test_garbagecollect_now()| |test_null_channel()| |test_null_dict()| |test_null_job()| |test_null_list()| |test_null_partial()| |test_null_string()| Window IDs ~ Previously windows could only be accessed by their number. And every time a window would open, close or move that number changes. Each window now has a unique ID, so that they are easy to find. See |win_getid()| and |win_id2win()|. Wrapping lines with indent ~ The 'breakindent' option has been added to be able to wrap lines without changing the amount of indent. Windows: Direct-X support ~ This adds the 'renderoptions' option to allow for switching on Direct-X (DirectWrite) support on MS-Windows. GTK+ 3 support ~ GTK+ 2 is getting old, GTK+ 3 is here. Support has been added and it already works quite well, mostly just like GTK+ 2. Vim script enhancements *new-vim-script-8* ----------------------- In Vim script the following types have been added: |Special| |v:false|, |v:true|, |v:none| and |v:null| |Channel| connection to another process for asynchronous I/O |Job| process control Many functions and commands have been added to support the new types. Various new items *new-items-8* ----------------- Normal mode commands: ~ Insert mode commands: ~ Options: ~ Ex commands: ~ Ex command modifiers: ~ Ex command arguments: ~ New and extended functions: ~ New Vim variables: ~ |v:vim_did_enter| Set when VimEnter autocommands are triggered New autocommand events: ~ New highlight groups: ~ New items in search patterns: ~ New Syntax/Indent/FTplugin files: ~ New Keymaps: ~ New message translations: ~ Others: ~ ============================================================================== IMPROVEMENTS *improvements-8* The existing blowfish encryption turned out to be much weaker than it was supposed to be. The blowfish2 method has been added to fix that. Note that this still isn't a state-of-the-art encryption, but good enough for most usage. See 'cryptmethod'. ============================================================================== COMPILE TIME CHANGES *compile-changes-8* Dropped the support for MS-DOS. It was too big to fit in memory. ============================================================================== PATCHES *patches-8* *bug-fixes-8* The list of patches that got included since 7.4.0. This includes all the new features, but does not include runtime file changes (syntax, indent, help, etc.) TODO: INCLUDE PATCH LIST. vim:tw=78:ts=8:ft=help:norl: