News
Nvim :help pages, generated
from source
using the tree-sitter-vimdoc parser.
Notable changes since Nvim 0.11
For changes in the previous release, see
news-0.11.
====== Remove this section before release. ======
The following changes to UNRELEASED features were made during the development
cycle (Nvim HEAD, the "master" branch).
EVENTS
EXPERIMENTS
LSP
OPTIONS
TREESITTER
These changes may require adaptations in your config or plugins.
API
BUILD
DIAGNOSTICS
EDITOR
EVENTS
ui-messages no longer emits the
msg_show.return_prompt, and
msg_history_clear events. The
msg_clear event was repurposed and is now
emitted after the screen is cleared. These events arbitrarily assumed a
message UI that mimicks the legacy message grid. Benefit: reduced UI event
traffic and more flexibility for UIs.
The
msg_history_show event has an additional "prev_cmd" argument.
A new empty message kind is emitted for an empty (e.g. :echo "") message.
HIGHLIGHTS
LSP
vim.lsp.semantic_tokens.start/stop now renamed to
vim.lsp.semantic_tokens.enable
LUA
Renamed vim.diff to vim.text.diff.
OPTIONS
PLUGINS
TREESITTER
treesitter-directive-offset! can now be applied to quantified captures. It
no longer sets
metadata[capture_id].range; it instead sets
metadata[capture_id].offset. The offset will be applied in
vim.treesitter.get_range(), which should be preferred over reading
metadata directly for retrieving node ranges.
TUI
VIMSCRIPT
The following new features were added.
API
api-contract allows existing functions to change return-type fromvoid =>
non-void`.
nvim_win_text_height() can limit the lines checked when a certain
max_height is reached, and returns the
end_row and
end_vcol for which
max_height or the calculated height is reached.
vim.secure.read() now returns
true for trusted directories. Previously
it would return
nil, which made it impossible to tell if the directory was
actually trusted.
BUILD
A Zig-based build system has been added as an alternative to CMake. It is
currently limited in functionality, and CMake remains the recommended option
for the time being.
DEFAULTS
'statusline' default is exposed as a statusline expression (previously it
was implemented as an internal C routine).
Project-local configuration (
'exrc') is also loaded from parent directories.
Unset
'exrc' to stop further search.
Mappings:
DIAGNOSTICS
EDITOR
:retab accepts new optional parameter -indentonly to only change leading
whitespace in indented lines.
:uniq deduplicates text in the current buffer.
Setting "'0" in
'shada' prevents storing the jumplist in the shada file.
'shada' now correctly respects "/0" and "f0".
prompt-buffer supports multiline input/paste, undo/redo, and o/O normal
commands.
EVENTS
HIGHLIGHTS
LSP
The textDocument/diagnostic request now includes the previous id in its
parameters.
vim.lsp.enable() start/stops clients as necessary. And detaches
non-applicable LSP clients.
Incremental selection is now supported via textDocument/selectionRange.
an selects outwards and in selects inwards.
Support for multiline semantic tokens.
Support for the disabled field on code actions.
The function form of cmd in a vim.lsp.Config or vim.lsp.ClientConfig
receives the resolved config as the second arg: cmd(dispatchers, config).
Support for annotated text edits.
:checkhealth vim.lsp is now available to check which buffers the active LSP features are attached to.
LSP
DiagnosticRelatedInformation is now shown in
vim.diagnostic.open_float(). It is read from the LSP diagnostic object
stored in the
user_data field.
When inside the float created by
vim.diagnostic.open_float() and the
cursor is on a line with
DiagnosticRelatedInformation,
gf can be used to
jump to the problematic location.
LUA
Lua type annotations for vim.uv.
OPTIONS
'autowriteall' writes all buffers upon receiving
SIGHUP,
SIGQUIT or
SIGTSTP.
"F{func}" complete using given function
'complete' allows limiting matches for sources using "{flag}^<limit>".
'completeopt' flag "nearset" sorts completion results by distance to cursor.
'diffopt' inline: configures diff highlighting for changes within a line.
g:clipboard accepts a string name to force any builtin clipboard tool.
'busy' sets a buffer "busy" status. Indicated in the default statusline.
vim.glob.to_lpeg() uses a new LPeg-based implementation (Peglob) that
provides ~50% speedup for complex patterns. The implementation restores
support for nested braces and follows LSP 3.17 specification with
additional constraints for improved correctness and resistance to
backtracking edge cases.
PLUGINS
Customize :checkhealth by handling a
FileType checkhealth event.
health-usage
STARTUP
TERMINAL
nvim_open_term() can be called with a non-empty buffer. The buffer
contents are piped to the PTY and displayed as terminal output.
TREESITTER
TUI
UI
:restart restarts Nvim and reattaches the current UI.
:checkhealth shows a summary in the header for every healthcheck.
ui-multigrid provides composition information and absolute coordinates.
vim._extui provides an experimental commandline and message UI intended to
replace the message grid in the TUI.
Error messages are more concise:
"Error detected while processing:" changed to "Error in:".
"Error executing Lua:" changed to "Lua:".
'busy' status is shown in default statusline with symbol ◐
VIMSCRIPT
These existing features changed their behavior.
gv works in operator pending mode and does not abort.
'spellfile' location defaults to
stdpath("data").."/site/spell/" instead of
the first writable directory in
'runtimepath'.
These deprecated features were removed.