News
Nvim :help
pages, generated
from source
using the tree-sitter-vimdoc parser.
Notable changes in Nvim 0.10 from 0.9
The following changes may require adaptations in user config or plugins.
vim.tbl_islist() now checks whether a table is actually list-like (i.e.,
has integer keys without gaps and starting from 1). For the previous
behavior (only check for integer keys, allow gaps or not starting with 1),
use
vim.tbl_isarray().
"#" followed by a digit no longer stands for a function key at the start of
the lhs of a mapping.
:behave
was removed.
If you used
:behave xterm
, the following is equivalent:
set mousemodel=extend
If you used
:behave mswin
, the following is equivalent:
set selection=exclusive
set selectmode=mouse,key
set mousemodel=popup
set keymodel=startsel,stopsel
When switching windows,
CursorMoved autocommands trigger when Nvim is back
in the main loop rather than immediately. This is more compatible with Vim.
-l ensures output ends with a newline if the script prints messages and
doesn't cause Nvim to exit.
Renamed vim.treesitter.playground
to vim.treesitter.dev
.
Removed functions from the
vim.json module:
Unnecessary, undocumented functions which caused global side-effects.
vim.json.null
is redundant with vim.NIL
.
vim.json.array_mt
(and related) is redundant with vim.empty_dict()
.
Removed some Vim 5.0<= option compatibilities:
for backspace=0
set backspace=
(empty)
for backspace=1
set backspace=indent,eol
for backspace=2
set backspace=indent,eol,start
(default behavior in Nvim)
for backspace=3
set backspace=indent,eol,nostop
paths in
'backupdir',
'path' and
'cdpath' can no longer be separated with
spaces (but paths themselves may contain spaces now).
'directory' will no longer remove a
>
at the start of the option.
LanguageTree:parse() will no longer parse injections by default and
now requires an explicit range argument to be passed. If injections are
required, provide an explicit range via
parser:parse({ start_row, end_row })
.
The following new APIs and features were added.
Performance:
Treesitter highlighting now parses injections incrementally during
screen redraws only for the line range being rendered. This significantly
improves performance in large files with many injections.
vim.iter() provides a generic iterator interface for tables and Lua
iterators
for-in.
The terminal buffer now supports reflow (wrapped lines adapt when the buffer
is resized horizontally). Note: Lines that are not visible and kept in
'scrollback' are not reflown.
Added
nvim_win_text_height() to compute the number of screen lines occupied
by a range of text in a given window.
Builtin TUI can now recognize "super" (
<D-) and "meta" (
<T-) modifiers in a
terminal emulator that supports
tui-csiu.
LSP
LSP client now always saves and restores named buffer marks when applying
text edits.
LSP client now supports the positionEncoding
server capability. If a server
responds with the positionEncoding
capability in its initialization
response, Nvim automatically sets the client's offset_encoding
field.
Dynamic registration of LSP capabilities. An implication of this change is
that checking a client's server_capabilities
is no longer a sufficient
indicator to see if a server supports a feature. Instead use
client.supports_method(<method>)
. It considers both the dynamic
capabilities and static server_capabilities
.
Added a new
anchor_bias
option to
lsp-handlers to aid in positioning of
floating windows.
Treesitter
Bundled parsers and queries (highlight, folds) for Markdown, Python, and
Bash.
@injection.language
now has smarter resolution and will now fallback to language aliases and/or attempt lower case variants of the text.
language via aliases (e.g., filetype) registered via
vim.treesitter.language.register
.
The #set!
directive now supports injection.self
and injection.parent
for injecting either the current node's language
or the parent LanguageTree's language, respectively.
Added vim.treesitter.query.edit()
, for live editing of treesitter
queries.
Improved error messages for query parsing.
vim.ui.open() opens URIs using the system default handler (macOS
open
,
Windows
explorer
, Linux
xdg-open
, etc.)
vim.wo can now be double indexed for
:setlocal behaviour. Currently only
0
for the buffer index is currently supported.
Lua type annotations for:
vim.*
vim.fn.*
vim.api.*
Improved messages for type errors in vim.api.*
calls (including opts
params)
New RPC client type msgpack-rpc
is added for nvim_set_client_info
to
support fully MessagePack-RPC compliant clients.
Floating windows can now show footer with new
footer
and
footer_pos
config fields. Uses
hl-FloatFooter by default.
The following changes to existing APIs or features add new behavior.
vim.tbl_contains() now works for general tables and allows specifying a
predicate function that is checked for each value. (Use
vim.list_contains()
for checking list-like tables (integer keys without gaps) for literal values.)
vim.diagnostic.config() now accepts a function for the virtual_text.prefix
option, which allows for rendering e.g., diagnostic severities differently.
Defaults:
Automatic linting of treesitter query files (see
ft-query-plugin).
Can be disabled via:
vim.g.query_lint_on = {}
Enabled treesitter highlighting for treesitter query files.
The workspace/didChangeWatchedFiles
LSP client capability is now enabled
by default.
LspRequest autocmd callbacks now contain additional information about the LSP
request status update that occurred.
:source
without arguments treats a buffer with its
'filetype' set to "lua"
as Lua code regardless of its extension.
gx now uses
vim.ui.open() and not netrw. To customize, you can redefine
vim.ui.open
or remap
gx
. To continue using netrw (deprecated):
:call netrw#BrowseX(expand(exists("g:netrw_gx")? g:netrw_gx : '<cfile>'), netrw#CheckIfRemote())<CR>
Terminal buffers started with no arguments (and use
'shell') close
automatically if the job exited without error, eliminating the (often
unwanted) "[Process exited 0]" message.
vim.diagnostic.config() now accepts virtual text relevant options to
nvim_buf_set_extmark() (e.g. "virt_text_pos" and "hl_mode") in its
"virtual_text" table, which gives users more control over how diagnostic
virtual text is displayed.
Extmarks now fully support multi-line ranges, and a single extmark can be
used to highlight a range of arbitrary length. The
nvim_buf_set_extmark()
API function already allowed you to define such ranges, but highlight regions
were not rendered consistently for a range that covers more than one line break.
This has now been fixed. Signs defined as part of a multi-line extmark also
apply to every line in the range, not just the first.
In addition,
nvim_buf_get_extmarks() has gained an "overlap" option to
return such ranges even if they started before the specified position.
LSP hover and signature help now use Treesitter for highlighting of Markdown
content.
Note that syntax highlighting of code examples requires a matching parser
and may be affected by custom queries.
The following deprecated functions or APIs were removed.
Vimball support is removed.
:Vimuntar command removed.
Support for legacy treesitter injection queries is removed.
The following functions are now deprecated and will be removed in a future
release.
vim.loop
has been renamed to vim.uv
.
vim.treesitter.languagetree functions: