mirror of
https://github.com/neovim/neovim.git
synced 2024-12-24 05:05:00 -07:00
docs: misc, help tags for neovim.io searches #31428
Problem: Various keywords are commonly searched-for on https://neovim.io, but don't have help tags. Solution: Add help tags. fix #31327
This commit is contained in:
parent
2495e7e22a
commit
ae93c7f369
@ -1114,7 +1114,7 @@ nvim_open_term({buffer}, {opts}) *nvim_open_term()*
|
|||||||
Open a terminal instance in a buffer
|
Open a terminal instance in a buffer
|
||||||
|
|
||||||
By default (and currently the only option) the terminal will not be
|
By default (and currently the only option) the terminal will not be
|
||||||
connected to an external process. Instead, input send on the channel will
|
connected to an external process. Instead, input sent on the channel will
|
||||||
be echoed directly by the terminal. This is useful to display ANSI
|
be echoed directly by the terminal. This is useful to display ANSI
|
||||||
terminal sequences returned as part of a rpc message, or similar.
|
terminal sequences returned as part of a rpc message, or similar.
|
||||||
|
|
||||||
@ -1125,6 +1125,17 @@ nvim_open_term({buffer}, {opts}) *nvim_open_term()*
|
|||||||
|nvim_chan_send()| can be called immediately to process sequences in a
|
|nvim_chan_send()| can be called immediately to process sequences in a
|
||||||
virtual terminal having the intended size.
|
virtual terminal having the intended size.
|
||||||
|
|
||||||
|
Example: this `TermHl` command can be used to display and highlight raw
|
||||||
|
ANSI termcodes, so you can use Nvim as a "scrollback pager" (for terminals
|
||||||
|
like kitty): *terminal-scrollback-pager* >lua
|
||||||
|
vim.api.nvim_create_user_command('TermHl', function()
|
||||||
|
local b = vim.api.nvim_create_buf(false, true)
|
||||||
|
local chan = vim.api.nvim_open_term(b, {})
|
||||||
|
vim.api.nvim_chan_send(chan, table.concat(vim.api.nvim_buf_get_lines(0, 0, -1, false), '\n'))
|
||||||
|
vim.api.nvim_win_set_buf(0, b)
|
||||||
|
end, { desc = 'Highlights ANSI termcodes in curbuf' })
|
||||||
|
<
|
||||||
|
|
||||||
Attributes: ~
|
Attributes: ~
|
||||||
not allowed when |textlock| is active
|
not allowed when |textlock| is active
|
||||||
|
|
||||||
|
9
runtime/doc/builtin.txt
generated
9
runtime/doc/builtin.txt
generated
@ -5443,7 +5443,7 @@ jobwait({jobs} [, {timeout}]) *jobwait()*
|
|||||||
• {timeout} (`integer?`)
|
• {timeout} (`integer?`)
|
||||||
|
|
||||||
Return: ~
|
Return: ~
|
||||||
(`any`)
|
(`integer[]`)
|
||||||
|
|
||||||
join({list} [, {sep}]) *join()*
|
join({list} [, {sep}]) *join()*
|
||||||
Join the items in {list} together into one String.
|
Join the items in {list} together into one String.
|
||||||
@ -7986,7 +7986,7 @@ rpcnotify({channel}, {event} [, {args}...]) *rpcnotify()*
|
|||||||
Parameters: ~
|
Parameters: ~
|
||||||
• {channel} (`integer`)
|
• {channel} (`integer`)
|
||||||
• {event} (`string`)
|
• {event} (`string`)
|
||||||
• {args} (`any?`)
|
• {...} (`any`)
|
||||||
|
|
||||||
Return: ~
|
Return: ~
|
||||||
(`any`)
|
(`any`)
|
||||||
@ -8001,7 +8001,7 @@ rpcrequest({channel}, {method} [, {args}...]) *rpcrequest()*
|
|||||||
Parameters: ~
|
Parameters: ~
|
||||||
• {channel} (`integer`)
|
• {channel} (`integer`)
|
||||||
• {method} (`string`)
|
• {method} (`string`)
|
||||||
• {args} (`any?`)
|
• {...} (`any`)
|
||||||
|
|
||||||
Return: ~
|
Return: ~
|
||||||
(`any`)
|
(`any`)
|
||||||
@ -10234,6 +10234,7 @@ str2list({string} [, {utf8}]) *str2list()*
|
|||||||
and exists only for backwards-compatibility.
|
and exists only for backwards-compatibility.
|
||||||
With UTF-8 composing characters are handled properly: >vim
|
With UTF-8 composing characters are handled properly: >vim
|
||||||
echo str2list("á") " returns [97, 769]
|
echo str2list("á") " returns [97, 769]
|
||||||
|
<
|
||||||
|
|
||||||
Parameters: ~
|
Parameters: ~
|
||||||
• {string} (`string`)
|
• {string} (`string`)
|
||||||
@ -11991,7 +11992,7 @@ winlayout([{tabnr}]) *winlayout()*
|
|||||||
• {tabnr} (`integer?`)
|
• {tabnr} (`integer?`)
|
||||||
|
|
||||||
Return: ~
|
Return: ~
|
||||||
(`any`)
|
(`any[]`)
|
||||||
|
|
||||||
winline() *winline()*
|
winline() *winline()*
|
||||||
The result is a Number, which is the screen line of the cursor
|
The result is a Number, which is the screen line of the cursor
|
||||||
|
@ -46,11 +46,11 @@ Remember to bump NVIM_API_LEVEL if it wasn't already during this development
|
|||||||
cycle.
|
cycle.
|
||||||
|
|
||||||
Other references:
|
Other references:
|
||||||
* |msgpack-rpc|
|
- |msgpack-rpc|
|
||||||
* |ui|
|
- |ui|
|
||||||
* https://github.com/neovim/neovim/pull/3246
|
- https://github.com/neovim/neovim/pull/3246
|
||||||
* https://github.com/neovim/neovim/pull/18375
|
- https://github.com/neovim/neovim/pull/18375
|
||||||
* https://github.com/neovim/neovim/pull/21605
|
- https://github.com/neovim/neovim/pull/21605
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
@ -300,7 +300,7 @@ vim.paste in runtime/lua/vim/_editor.lua like this: >
|
|||||||
--- @returns false if client should cancel the paste.
|
--- @returns false if client should cancel the paste.
|
||||||
|
|
||||||
|
|
||||||
LUA STDLIB DESIGN GUIDELINES *dev-lua*
|
STDLIB DESIGN GUIDELINES *dev-lua*
|
||||||
|
|
||||||
See also |dev-naming|.
|
See also |dev-naming|.
|
||||||
|
|
||||||
@ -337,7 +337,7 @@ preference):
|
|||||||
way. Advantage is that propagation happens for free and it's harder to
|
way. Advantage is that propagation happens for free and it's harder to
|
||||||
accidentally swallow errors. (E.g. using
|
accidentally swallow errors. (E.g. using
|
||||||
`uv_handle/pipe:write()` without checking return values is common.)
|
`uv_handle/pipe:write()` without checking return values is common.)
|
||||||
4. `on_error` parameter
|
4. `on_error` callback
|
||||||
- For async and "visitors" traversing a graph, where many errors may be
|
- For async and "visitors" traversing a graph, where many errors may be
|
||||||
collected while work continues.
|
collected while work continues.
|
||||||
5. `vim.notify` (sometimes with optional `opts.silent` (async, visitors ^))
|
5. `vim.notify` (sometimes with optional `opts.silent` (async, visitors ^))
|
||||||
@ -434,7 +434,9 @@ Use existing common {verb} names (actions) if possible:
|
|||||||
- eval: Evaluates an expression
|
- eval: Evaluates an expression
|
||||||
- exec: Executes code, may return a result
|
- exec: Executes code, may return a result
|
||||||
- fmt: Formats
|
- fmt: Formats
|
||||||
- get: Gets things (often by a query)
|
- get: Gets things. Two variants (overloads):
|
||||||
|
1. `get<T>(id: int): T` returns one item.
|
||||||
|
2. `get<T>(filter: dict): T[]` returns a list.
|
||||||
- inspect: Presents a high-level, often interactive, view
|
- inspect: Presents a high-level, often interactive, view
|
||||||
- is_enabled: Checks if functionality is enabled.
|
- is_enabled: Checks if functionality is enabled.
|
||||||
- open: Opens something (a buffer, window, …)
|
- open: Opens something (a buffer, window, …)
|
||||||
|
@ -20,8 +20,9 @@ features, whereas help tags with the "ui-" prefix refer to the |ui-protocol|.
|
|||||||
Nvim provides a default, builtin UI (the |TUI|), but there are many other
|
Nvim provides a default, builtin UI (the |TUI|), but there are many other
|
||||||
(third-party) GUIs that you can use instead:
|
(third-party) GUIs that you can use instead:
|
||||||
|
|
||||||
- Firenvim (Nvim in your web browser!) https://github.com/glacambre/firenvim
|
*vscode*
|
||||||
- vscode-neovim (Nvim in VSCode!) https://github.com/vscode-neovim/vscode-neovim
|
- vscode-neovim (Nvim in VSCode!) https://github.com/vscode-neovim/vscode-neovim
|
||||||
|
- Firenvim (Nvim in your web browser!) https://github.com/glacambre/firenvim
|
||||||
- Neovide https://neovide.dev/
|
- Neovide https://neovide.dev/
|
||||||
- Goneovim https://github.com/akiyosi/goneovim
|
- Goneovim https://github.com/akiyosi/goneovim
|
||||||
- Nvy https://github.com/RMichelsen/Nvy
|
- Nvy https://github.com/RMichelsen/Nvy
|
||||||
|
@ -49,17 +49,19 @@ For more information try one of these:
|
|||||||
==============================================================================
|
==============================================================================
|
||||||
Nvim on the interwebs *internet*
|
Nvim on the interwebs *internet*
|
||||||
|
|
||||||
*www* *distribution* *download*
|
*www* *distribution*
|
||||||
|
- Nvim home page: https://neovim.io/
|
||||||
|
- Vim FAQ: https://vimhelp.org/vim_faq.txt.html
|
||||||
|
|
||||||
Nvim home page: https://neovim.io/
|
*download* *upgrade* *ubuntu*
|
||||||
Downloads: https://github.com/neovim/neovim/releases
|
To install or upgrade Nvim, you can...
|
||||||
Vim FAQ: https://vimhelp.org/vim_faq.txt.html
|
- Download a pre-built archive:
|
||||||
|
https://github.com/neovim/neovim/releases
|
||||||
|
- Use your system package manager:
|
||||||
*bugs* *bug-report*
|
https://github.com/neovim/neovim/blob/master/INSTALL.md#install-from-package
|
||||||
Report bugs and request features here:
|
|
||||||
https://github.com/neovim/neovim/issues
|
|
||||||
|
|
||||||
|
*bugs* *bug-report* *feature-request*
|
||||||
|
Report bugs and request features here: https://github.com/neovim/neovim/issues
|
||||||
Be brief, yet complete. Always give a reproducible example and try to find
|
Be brief, yet complete. Always give a reproducible example and try to find
|
||||||
out which settings or other things trigger the bug.
|
out which settings or other things trigger the bug.
|
||||||
|
|
||||||
|
@ -17,9 +17,9 @@ get an idea of what lurks beneath: >vim
|
|||||||
:lua vim.print(package.loaded)
|
:lua vim.print(package.loaded)
|
||||||
|
|
||||||
Nvim includes a "standard library" |lua-stdlib| for Lua. It complements the
|
Nvim includes a "standard library" |lua-stdlib| for Lua. It complements the
|
||||||
"editor stdlib" (|builtin-functions| and |Ex-commands|) and the |API|, all of
|
"editor stdlib" (|vimscript-functions| + |Ex-commands|) and the |API|, all of
|
||||||
which can be used from Lua code (|lua-vimscript| |vim.api|). Together these
|
which can be used from Lua code (|lua-vimscript| |vim.api|). These three
|
||||||
"namespaces" form the Nvim programming interface.
|
namespaces form the Nvim programming interface.
|
||||||
|
|
||||||
Lua plugins and user config are automatically discovered and loaded, just like
|
Lua plugins and user config are automatically discovered and loaded, just like
|
||||||
Vimscript. See |lua-guide| for practical guidance.
|
Vimscript. See |lua-guide| for practical guidance.
|
||||||
|
@ -12,7 +12,7 @@ manual.
|
|||||||
Type |gO| to see the table of contents.
|
Type |gO| to see the table of contents.
|
||||||
|
|
||||||
==============================================================================
|
==============================================================================
|
||||||
1. Key mapping *key-mapping* *mapping* *macro*
|
1. Key mapping *keybind* *key-mapping* *mapping* *macro*
|
||||||
|
|
||||||
Key mapping is used to change the meaning of typed keys. The most common use
|
Key mapping is used to change the meaning of typed keys. The most common use
|
||||||
is to define a sequence of commands for a function key. Example: >
|
is to define a sequence of commands for a function key. Example: >
|
||||||
|
@ -6,21 +6,23 @@
|
|||||||
|
|
||||||
Nvim *nvim* *neovim* *nvim-intro*
|
Nvim *nvim* *neovim* *nvim-intro*
|
||||||
|
|
||||||
Nvim is based on Vim by Bram Moolenaar.
|
Nvim is based on Vim by Bram Moolenaar. Nvim is emphatically a fork of Vim,
|
||||||
|
not a clone: compatibility with Vim (especially editor and Vimscript features,
|
||||||
|
except |Vim9script|) is maintained where possible. See |vim-differences| for
|
||||||
|
the complete reference.
|
||||||
|
|
||||||
If you already use Vim see |nvim-from-vim| for a quickstart.
|
If you already use Vim, see |nvim-from-vim| for a quickstart. If you just
|
||||||
If you are new to Vim, try the 30-minute tutorial: >vim
|
installed Nvim and have never used it before, watch this 10-minute
|
||||||
|
video: https://youtu.be/TQn2hJeHQbM .
|
||||||
|
|
||||||
|
To learn how to use Vim in 30 minutes, try the tutorial: >vim
|
||||||
|
|
||||||
:Tutor<Enter>
|
:Tutor<Enter>
|
||||||
|
<
|
||||||
Nvim is emphatically a fork of Vim, not a clone: compatibility with Vim
|
|
||||||
(especially editor and Vimscript features) is maintained where possible. See
|
|
||||||
|vim-differences| for the complete reference of differences from Vim.
|
|
||||||
|
|
||||||
Type |gO| to see the table of contents.
|
Type |gO| to see the table of contents.
|
||||||
|
|
||||||
==============================================================================
|
==============================================================================
|
||||||
Transitioning from Vim *nvim-from-vim*
|
Transitioning from Vim *nvim-from-vim*
|
||||||
|
|
||||||
1. To start the transition, create your |init.vim| (user config) file: >vim
|
1. To start the transition, create your |init.vim| (user config) file: >vim
|
||||||
|
|
||||||
@ -70,5 +72,21 @@ the same Nvim configuration on all of your machines, by creating
|
|||||||
~/AppData/Local/nvim/init.vim containing just this line: >vim
|
~/AppData/Local/nvim/init.vim containing just this line: >vim
|
||||||
source ~/.config/nvim/init.vim
|
source ~/.config/nvim/init.vim
|
||||||
|
|
||||||
|
==============================================================================
|
||||||
|
What next? *nvim-quickstart*
|
||||||
|
|
||||||
|
If you are just trying out Nvim for a few minutes, and want to see the
|
||||||
|
extremes of what it can do, try one of these popular "extension packs" or
|
||||||
|
"distributions" (Note: Nvim is not affiliated with these projects, and does
|
||||||
|
not support them):
|
||||||
|
|
||||||
|
- *kickstart* https://github.com/nvim-lua/kickstart.nvim
|
||||||
|
- *lazyvim* https://www.lazyvim.org/
|
||||||
|
- *nvchad* https://nvchad.com/
|
||||||
|
|
||||||
|
However, in general, we recommend (eventually) taking time to learn Nvim from
|
||||||
|
its stock configuration, and incrementally setting options and adding plugins
|
||||||
|
to your |config| as you find an explicit need to do so.
|
||||||
|
|
||||||
==============================================================================
|
==============================================================================
|
||||||
vim:tw=78:ts=8:et:ft=help:norl:
|
vim:tw=78:ts=8:et:ft=help:norl:
|
||||||
|
@ -788,7 +788,7 @@ must handle.
|
|||||||
|
|
||||||
kind
|
kind
|
||||||
Name indicating the message kind:
|
Name indicating the message kind:
|
||||||
"" (empty) Unknown (consider a feature-request: |bugs|)
|
"" (empty) Unknown (consider a |feature-request|)
|
||||||
"confirm" |confirm()| or |:confirm| dialog
|
"confirm" |confirm()| or |:confirm| dialog
|
||||||
"confirm_sub" |:substitute| confirm dialog |:s_c|
|
"confirm_sub" |:substitute| confirm dialog |:s_c|
|
||||||
"emsg" Error (|errors|, internal error, |:throw|, …)
|
"emsg" Error (|errors|, internal error, |:throw|, …)
|
||||||
|
@ -534,7 +534,8 @@ gO Show a filetype-specific, navigable "outline" of the
|
|||||||
current buffer. For example, in a |help| buffer this
|
current buffer. For example, in a |help| buffer this
|
||||||
shows the table of contents.
|
shows the table of contents.
|
||||||
|
|
||||||
Currently works in |help| and |:Man| buffers.
|
Works in |help| and |:Man| buffers, or any buffer with
|
||||||
|
an active |LSP| client (|lsp-defaults|).
|
||||||
|
|
||||||
[N]gs *gs* *:sl* *:sleep*
|
[N]gs *gs* *:sl* *:sleep*
|
||||||
:[N]sl[eep] [N][m] Do nothing for [N] seconds, or [N] milliseconds if [m]
|
:[N]sl[eep] [N][m] Do nothing for [N] seconds, or [N] milliseconds if [m]
|
||||||
|
@ -686,7 +686,7 @@ Cscope:
|
|||||||
https://github.com/dhananjaylatkar/cscope_maps.nvim
|
https://github.com/dhananjaylatkar/cscope_maps.nvim
|
||||||
|
|
||||||
Eval:
|
Eval:
|
||||||
- Vim9script
|
- *Vim9script* (the Vim 9+ flavor of Vimscript) is not supported.
|
||||||
- *cscope_connection()*
|
- *cscope_connection()*
|
||||||
- *err_teapot()*
|
- *err_teapot()*
|
||||||
- *js_encode()*
|
- *js_encode()*
|
||||||
|
14
runtime/lua/vim/_meta/api.lua
generated
14
runtime/lua/vim/_meta/api.lua
generated
@ -1654,7 +1654,7 @@ function vim.api.nvim_notify(msg, log_level, opts) end
|
|||||||
--- Open a terminal instance in a buffer
|
--- Open a terminal instance in a buffer
|
||||||
---
|
---
|
||||||
--- By default (and currently the only option) the terminal will not be
|
--- By default (and currently the only option) the terminal will not be
|
||||||
--- connected to an external process. Instead, input send on the channel
|
--- connected to an external process. Instead, input sent on the channel
|
||||||
--- will be echoed directly by the terminal. This is useful to display
|
--- will be echoed directly by the terminal. This is useful to display
|
||||||
--- ANSI terminal sequences returned as part of a rpc message, or similar.
|
--- ANSI terminal sequences returned as part of a rpc message, or similar.
|
||||||
---
|
---
|
||||||
@ -1665,6 +1665,18 @@ function vim.api.nvim_notify(msg, log_level, opts) end
|
|||||||
--- Then `nvim_chan_send()` can be called immediately to process sequences
|
--- Then `nvim_chan_send()` can be called immediately to process sequences
|
||||||
--- in a virtual terminal having the intended size.
|
--- in a virtual terminal having the intended size.
|
||||||
---
|
---
|
||||||
|
--- Example: this `TermHl` command can be used to display and highlight raw ANSI termcodes, so you
|
||||||
|
--- can use Nvim as a "scrollback pager" (for terminals like kitty): [terminal-scrollback-pager]()
|
||||||
|
---
|
||||||
|
--- ```lua
|
||||||
|
--- vim.api.nvim_create_user_command('TermHl', function()
|
||||||
|
--- local b = vim.api.nvim_create_buf(false, true)
|
||||||
|
--- local chan = vim.api.nvim_open_term(b, {})
|
||||||
|
--- vim.api.nvim_chan_send(chan, table.concat(vim.api.nvim_buf_get_lines(0, 0, -1, false), '\n'))
|
||||||
|
--- vim.api.nvim_win_set_buf(0, b)
|
||||||
|
--- end, { desc = 'Highlights ANSI termcodes in curbuf' })
|
||||||
|
--- ```
|
||||||
|
---
|
||||||
--- @param buffer integer the buffer to use (expected to be empty)
|
--- @param buffer integer the buffer to use (expected to be empty)
|
||||||
--- @param opts vim.api.keyset.open_term Optional parameters.
|
--- @param opts vim.api.keyset.open_term Optional parameters.
|
||||||
--- - on_input: Lua callback for input sent, i e keypresses in terminal
|
--- - on_input: Lua callback for input sent, i e keypresses in terminal
|
||||||
|
13
runtime/lua/vim/_meta/vimfn.lua
generated
13
runtime/lua/vim/_meta/vimfn.lua
generated
@ -4928,7 +4928,7 @@ function vim.fn.jobstop(id) end
|
|||||||
---
|
---
|
||||||
--- @param jobs integer[]
|
--- @param jobs integer[]
|
||||||
--- @param timeout? integer
|
--- @param timeout? integer
|
||||||
--- @return any
|
--- @return integer[]
|
||||||
function vim.fn.jobwait(jobs, timeout) end
|
function vim.fn.jobwait(jobs, timeout) end
|
||||||
|
|
||||||
--- Join the items in {list} together into one String.
|
--- Join the items in {list} together into one String.
|
||||||
@ -7244,9 +7244,9 @@ function vim.fn.round(expr) end
|
|||||||
---
|
---
|
||||||
--- @param channel integer
|
--- @param channel integer
|
||||||
--- @param event string
|
--- @param event string
|
||||||
--- @param args? any
|
--- @param ... any
|
||||||
--- @return any
|
--- @return any
|
||||||
function vim.fn.rpcnotify(channel, event, args) end
|
function vim.fn.rpcnotify(channel, event, ...) end
|
||||||
|
|
||||||
--- Sends a request to {channel} to invoke {method} via
|
--- Sends a request to {channel} to invoke {method} via
|
||||||
--- |RPC| and blocks until a response is received.
|
--- |RPC| and blocks until a response is received.
|
||||||
@ -7256,9 +7256,9 @@ function vim.fn.rpcnotify(channel, event, args) end
|
|||||||
---
|
---
|
||||||
--- @param channel integer
|
--- @param channel integer
|
||||||
--- @param method string
|
--- @param method string
|
||||||
--- @param args? any
|
--- @param ... any
|
||||||
--- @return any
|
--- @return any
|
||||||
function vim.fn.rpcrequest(channel, method, args) end
|
function vim.fn.rpcrequest(channel, method, ...) end
|
||||||
|
|
||||||
--- @deprecated
|
--- @deprecated
|
||||||
--- Deprecated. Replace >vim
|
--- Deprecated. Replace >vim
|
||||||
@ -9328,6 +9328,7 @@ function vim.fn.str2float(string, quoted) end
|
|||||||
--- and exists only for backwards-compatibility.
|
--- and exists only for backwards-compatibility.
|
||||||
--- With UTF-8 composing characters are handled properly: >vim
|
--- With UTF-8 composing characters are handled properly: >vim
|
||||||
--- echo str2list("á") " returns [97, 769]
|
--- echo str2list("á") " returns [97, 769]
|
||||||
|
--- <
|
||||||
---
|
---
|
||||||
--- @param string string
|
--- @param string string
|
||||||
--- @param utf8? boolean
|
--- @param utf8? boolean
|
||||||
@ -10870,7 +10871,7 @@ function vim.fn.winheight(nr) end
|
|||||||
--- <
|
--- <
|
||||||
---
|
---
|
||||||
--- @param tabnr? integer
|
--- @param tabnr? integer
|
||||||
--- @return any
|
--- @return any[]
|
||||||
function vim.fn.winlayout(tabnr) end
|
function vim.fn.winlayout(tabnr) end
|
||||||
|
|
||||||
--- The result is a Number, which is the screen line of the cursor
|
--- The result is a Number, which is the screen line of the cursor
|
||||||
|
@ -1040,7 +1040,7 @@ fail:
|
|||||||
/// Open a terminal instance in a buffer
|
/// Open a terminal instance in a buffer
|
||||||
///
|
///
|
||||||
/// By default (and currently the only option) the terminal will not be
|
/// By default (and currently the only option) the terminal will not be
|
||||||
/// connected to an external process. Instead, input send on the channel
|
/// connected to an external process. Instead, input sent on the channel
|
||||||
/// will be echoed directly by the terminal. This is useful to display
|
/// will be echoed directly by the terminal. This is useful to display
|
||||||
/// ANSI terminal sequences returned as part of a rpc message, or similar.
|
/// ANSI terminal sequences returned as part of a rpc message, or similar.
|
||||||
///
|
///
|
||||||
@ -1051,6 +1051,18 @@ fail:
|
|||||||
/// Then |nvim_chan_send()| can be called immediately to process sequences
|
/// Then |nvim_chan_send()| can be called immediately to process sequences
|
||||||
/// in a virtual terminal having the intended size.
|
/// in a virtual terminal having the intended size.
|
||||||
///
|
///
|
||||||
|
/// Example: this `TermHl` command can be used to display and highlight raw ANSI termcodes, so you
|
||||||
|
/// can use Nvim as a "scrollback pager" (for terminals like kitty): [terminal-scrollback-pager]()
|
||||||
|
///
|
||||||
|
/// ```lua
|
||||||
|
/// vim.api.nvim_create_user_command('TermHl', function()
|
||||||
|
/// local b = vim.api.nvim_create_buf(false, true)
|
||||||
|
/// local chan = vim.api.nvim_open_term(b, {})
|
||||||
|
/// vim.api.nvim_chan_send(chan, table.concat(vim.api.nvim_buf_get_lines(0, 0, -1, false), '\n'))
|
||||||
|
/// vim.api.nvim_win_set_buf(0, b)
|
||||||
|
/// end, { desc = 'Highlights ANSI termcodes in curbuf' })
|
||||||
|
/// ```
|
||||||
|
///
|
||||||
/// @param buffer the buffer to use (expected to be empty)
|
/// @param buffer the buffer to use (expected to be empty)
|
||||||
/// @param opts Optional parameters.
|
/// @param opts Optional parameters.
|
||||||
/// - on_input: Lua callback for input sent, i e keypresses in terminal
|
/// - on_input: Lua callback for input sent, i e keypresses in terminal
|
||||||
|
@ -6049,6 +6049,7 @@ M.funcs = {
|
|||||||
]=],
|
]=],
|
||||||
name = 'jobwait',
|
name = 'jobwait',
|
||||||
params = { { 'jobs', 'integer[]' }, { 'timeout', 'integer' } },
|
params = { { 'jobs', 'integer[]' }, { 'timeout', 'integer' } },
|
||||||
|
returns = 'integer[]',
|
||||||
signature = 'jobwait({jobs} [, {timeout}])',
|
signature = 'jobwait({jobs} [, {timeout}])',
|
||||||
},
|
},
|
||||||
join = {
|
join = {
|
||||||
@ -8776,7 +8777,7 @@ M.funcs = {
|
|||||||
<
|
<
|
||||||
]=],
|
]=],
|
||||||
name = 'rpcnotify',
|
name = 'rpcnotify',
|
||||||
params = { { 'channel', 'integer' }, { 'event', 'string' }, { 'args', 'any' } },
|
params = { { 'channel', 'integer' }, { 'event', 'string' }, { '...', 'any' } },
|
||||||
signature = 'rpcnotify({channel}, {event} [, {args}...])',
|
signature = 'rpcnotify({channel}, {event} [, {args}...])',
|
||||||
},
|
},
|
||||||
rpcrequest = {
|
rpcrequest = {
|
||||||
@ -8789,7 +8790,7 @@ M.funcs = {
|
|||||||
<
|
<
|
||||||
]=],
|
]=],
|
||||||
name = 'rpcrequest',
|
name = 'rpcrequest',
|
||||||
params = { { 'channel', 'integer' }, { 'method', 'string' }, { 'args', 'any' } },
|
params = { { 'channel', 'integer' }, { 'method', 'string' }, { '...', 'any' } },
|
||||||
signature = 'rpcrequest({channel}, {method} [, {args}...])',
|
signature = 'rpcrequest({channel}, {method} [, {args}...])',
|
||||||
},
|
},
|
||||||
rpcstart = {
|
rpcstart = {
|
||||||
@ -11155,7 +11156,7 @@ M.funcs = {
|
|||||||
and exists only for backwards-compatibility.
|
and exists only for backwards-compatibility.
|
||||||
With UTF-8 composing characters are handled properly: >vim
|
With UTF-8 composing characters are handled properly: >vim
|
||||||
echo str2list("á") " returns [97, 769]
|
echo str2list("á") " returns [97, 769]
|
||||||
|
<
|
||||||
]=],
|
]=],
|
||||||
name = 'str2list',
|
name = 'str2list',
|
||||||
params = { { 'string', 'string' }, { 'utf8', 'boolean' } },
|
params = { { 'string', 'string' }, { 'utf8', 'boolean' } },
|
||||||
@ -13091,6 +13092,7 @@ M.funcs = {
|
|||||||
]=],
|
]=],
|
||||||
name = 'winlayout',
|
name = 'winlayout',
|
||||||
params = { { 'tabnr', 'integer' } },
|
params = { { 'tabnr', 'integer' } },
|
||||||
|
returns = 'any[]',
|
||||||
signature = 'winlayout([{tabnr}])',
|
signature = 'winlayout([{tabnr}])',
|
||||||
},
|
},
|
||||||
winline = {
|
winline = {
|
||||||
|
Loading…
Reference in New Issue
Block a user