diff options
| author | bfredl <bjorn.linse@gmail.com> | 2022-09-28 19:00:54 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2022-09-28 19:00:54 +0200 |
| commit | e8ff43292265879beff1d644d7d27df5d2b635cb (patch) | |
| tree | 5f667d12774794d3edc90d9ba9343047c30feffb | |
| parent | 268bad479870fe74359650087a4a2f55c750daac (diff) | |
| parent | 47b821eccf7bd08f429bb16e9d4ea309d6994896 (diff) | |
| download | rneovim-e8ff43292265879beff1d644d7d27df5d2b635cb.tar.gz rneovim-e8ff43292265879beff1d644d7d27df5d2b635cb.tar.bz2 rneovim-e8ff43292265879beff1d644d7d27df5d2b635cb.zip | |
Merge pull request #20390 from bfredl/doc2
docs: mark cmdheight=0 and vim.ui_attach as experimental
| -rw-r--r-- | runtime/doc/lua.txt | 6 | ||||
| -rw-r--r-- | runtime/doc/options.txt | 10 |
2 files changed, 13 insertions, 3 deletions
diff --git a/runtime/doc/lua.txt b/runtime/doc/lua.txt index 0c6eb6af78..3026476ab9 100644 --- a/runtime/doc/lua.txt +++ b/runtime/doc/lua.txt @@ -978,6 +978,12 @@ vim.ui_attach({ns}, {options}, {callback}) *vim.ui_attach()* {callback} receives event name plus additional parameters. See |ui-popupmenu| and the sections below for event format for respective events. + WARNING: This api is considered experimental. Usability will vary for + different screen elements. In particular `ext_messages` behavior is subject + to further changes and usability improvements. This is expected to be + used to handle messages when setting 'cmdheight' to zero (which is + likewise experimental). + Example (stub for a |ui-popupmenu| implementation): > ns = vim.api.nvim_create_namespace('my_fancy_pum') diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt index c1a0836f5b..0654265dbe 100644 --- a/runtime/doc/options.txt +++ b/runtime/doc/options.txt @@ -1338,9 +1338,13 @@ A jump table for the options with a short description can be found at |Q_op|. When 'cmdheight' is zero, there is no command-line unless it is being used. The command-line will cover the last line of the screen when - shown. Some informative messages will not be displayed, any other - messages will cause the |hit-enter| prompt. Expect some other - unexpected behavior too. + shown. + + WARNING: `cmdheight=0` is considered experimental. Except some + unwanted behaviour. Some 'shortmess' flags and similar + mechanism might fail to take effect, causing unwanted hit-enter + prompts. Some informative messages, both from Nvim itself and + plugins, will not be displayed. *'cmdwinheight'* *'cwh'* 'cmdwinheight' 'cwh' number (default 7) |