aboutsummaryrefslogtreecommitdiff
path: root/runtime
diff options
context:
space:
mode:
authorBjörn Linse <bjorn.linse@gmail.com>2019-07-02 15:53:43 +0200
committerBjörn Linse <bjorn.linse@gmail.com>2019-09-01 15:55:10 +0200
commitb51ba122c1edfb769e72c25c4f14f469f59f1b8e (patch)
tree84052cf27b2e1aa904b898cd01d9d35df9afaf92 /runtime
parent9cec097ffacfd0de100912781df2efed1a4c8ba9 (diff)
downloadrneovim-b51ba122c1edfb769e72c25c4f14f469f59f1b8e.tar.gz
rneovim-b51ba122c1edfb769e72c25c4f14f469f59f1b8e.tar.bz2
rneovim-b51ba122c1edfb769e72c25c4f14f469f59f1b8e.zip
screen: use dedicated message grid
add proper msg_set_pos event, delet win_scroll_over_* make compositor click through unfocusable grids add MsgArea attribute for the message/cmdline area, and add docs and tests
Diffstat (limited to 'runtime')
-rw-r--r--runtime/doc/syntax.txt2
-rw-r--r--runtime/doc/ui.txt23
2 files changed, 15 insertions, 10 deletions
diff --git a/runtime/doc/syntax.txt b/runtime/doc/syntax.txt
index e5b65554d4..f813717eeb 100644
--- a/runtime/doc/syntax.txt
+++ b/runtime/doc/syntax.txt
@@ -4969,6 +4969,8 @@ MatchParen The character under the cursor or just before it, if it
*hl-ModeMsg*
ModeMsg 'showmode' message (e.g., "-- INSERT --")
+ *hl-MsgArea*
+MsgArea Area for messages and cmdline
*hl-MsgSeparator*
MsgSeparator Separator for scrolled messages, `msgsep` flag of 'display'
*hl-MoreMsg*
diff --git a/runtime/doc/ui.txt b/runtime/doc/ui.txt
index 7d213f959b..3b7debd99e 100644
--- a/runtime/doc/ui.txt
+++ b/runtime/doc/ui.txt
@@ -543,6 +543,8 @@ The multigrid extension gives UIs more control over how windows are displayed:
occupies on the global layout. So the UI could use a different font size
per-window. Or reserve space around the border of the window for its own
elements, such as scrollbars from the UI toolkit.
+- A dedicated grid is used for messages, which may scroll over the window
+ area. (Alternatively |ext_messages| can be used).
By default, the grid size is handled by Nvim and set to the outer grid size
(i.e. the size of the window frame in Nvim) whenever the split is created.
@@ -573,19 +575,20 @@ tabs.
["win_hide", grid]
Stop displaying the window. The window can be shown again later.
-["win_scroll_over_start"]
- Hint that following `grid_scroll` on the default grid should
- scroll over windows. This is a temporary workaround to allow
- UIs to use the builtin message drawing. Later on, messages will be
- drawn on a dedicated grid. Using |ui-messages| also avoids this issue.
-
-["win_scroll_over_reset"]
- Hint that scrolled over windows should be redrawn again, and not be
- overdrawn by default grid scrolling anymore.
-
["win_close", grid]
Close the window.
+["msg_set_pos", grid, row, scrolled, sep_char]
+ Display messages on `grid`. The grid will be displayed at `row` on the
+ default grid (grid=1), covering the full column width. `scrolled`
+ indicates whether the message area has been scrolled to cover other
+ grids. It can be useful to draw a separator then ('display' msgsep
+ flag). The Builtin TUI draws a full line filled with `sep_char` and
+ |hl-MsgSeparator| highlight.
+
+ When |ext_messages| is active, no message grid is used, and this event
+ will not be sent.
+
==============================================================================
Popupmenu Events *ui-popupmenu*