From e5ad9076b3e0f24116891a44f50080bab57a4e26 Mon Sep 17 00:00:00 2001 From: Gerry Agbobada Date: Thu, 17 May 2018 10:57:04 +0200 Subject: [PATCH 1/2] Documentation : document the mouseover magic This first try is focused on fitting the information in existing paragraphs --- doc/ale.txt | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/doc/ale.txt b/doc/ale.txt index fa5e30d..b134286 100644 --- a/doc/ale.txt +++ b/doc/ale.txt @@ -668,6 +668,15 @@ at the cursor taken from LSP linters. The following commands are supported: |ALEHover| - Print information about the symbol at the cursor. +If |b:ale_set_balloons| is set and you are are using vim with the +|balloon_show()| feature (tested with vim 8 patch 1318), then "hover" +information also show up when you put the mouse on a symbol in a buffer +("mouseover"). +Diagnostics information have priority over hover information for the balloon +space : if there is a diagnostics message (warning or error) on the line the +mouse points to, then the mouseover will print this information instead of +hover information. + =============================================================================== 6. Global Options *ale-options* @@ -1354,9 +1363,11 @@ g:ale_set_balloons *g:ale_set_balloons* `has('balloon_eval_term') && !has('gui_running')` When this option is set to `1`, balloon messages will be displayed for - problems. Problems nearest to the cursor on the line the cursor is over will - be displayed. Balloons will not be shown when either |g:ale_enabled| is `0` - or |b:ale_enabled| is `0`. + problems or hover information if relevant. Problems nearest to the cursor on + the line the cursor is over will be displayed. If there are no problem, and + one of the linters support |ale-hover|, then brief information about the + symbol under the cursor will be shown. Balloons will not be shown when + either |g:ale_enabled| is `0` or |b:ale_enabled| is `0`. `b:ale_set_balloons` can be set to `0` to disable balloons for a buffer. Balloons cannot be enabled for a specific buffer when not initially enabled From 1258b032e6b0d12588ba0e77a76983f5483abba2 Mon Sep 17 00:00:00 2001 From: Gerry Agbobada Date: Thu, 17 May 2018 11:06:37 +0200 Subject: [PATCH 2/2] Documentation : Add mention of mouseover in README --- README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.md b/README.md index 0c3aba7..8bf54f7 100644 --- a/README.md +++ b/README.md @@ -272,6 +272,9 @@ ALE supports "hover" information for printing brief information about symbols at the cursor taken from Language Server Protocol linters and `tsserver` with the `ALEHover` command. +On vim/gvim with `balloon` support you can see the information in a tooltip +that appears under the mouse when you mouseover a symbol. + See `:help ale-hover` for more information.