Awesome
echodoc.vim
Displays function signatures from completions in the command line.
Installation
Use a package manager and follow its instructions.
Note: echodoc requires v:completed_item feature. It is added in Vim 7.4.774.
Global options
| Flag | Default | Description |
|---|---|---|
g:echodoc#enable_at_startup | 0 | If the value of this variable is non-zero, echodoc is automatically enabled at startup. |
g:echodoc#type | "echo" | Where the documentation is displayed. Choose between: "echo", "signature", "virtual" or "floating" |
g:echodoc#events | ['CompleteDone'] | If the autocmd-events are fired, echodoc is enabled. |
g:echodoc#floating_config | {} | The configuration for the floating window. |
g:echodoc#highlight_identifier | "Identifier" | The highlight of identifier. |
g:echodoc#highlight_arguments | "Special" | The highlight of current argument. |
g:echodoc#highlight_trailing | "Type" | The highlight of trailing. |
Type "echo" Usage
When using
let g:echodoc#type = "echo" " Default value
The command line is used to display echodoc text. This means that you will
either need to set noshowmode or set cmdheight=2. Otherwise, the -- INSERT -- mode text will overwrite echodoc's text.
When you accept a completion for a function with <c-y>, echodoc will
display the function signature in the command line and highlight the argument
position your cursor is in.
Examples
Option 1:
" To use echodoc, you must increase 'cmdheight' value.
set cmdheight=2
let g:echodoc_enable_at_startup = 1
Option 2:
" Or, you could disable showmode alltogether.
set noshowmode
let g:echodoc_enable_at_startup = 1
Option 3:
" Or, you could use neovim's virtual virtual text feature.
let g:echodoc#enable_at_startup = 1
let g:echodoc#type = 'virtual'
Option 4:
" Or, you could use neovim's floating window feature.
let g:echodoc#enable_at_startup = 1
let g:echodoc#type = 'floating'
" You could configure the behaviour of the floating window like below:
let g:echodoc#floating_config = {'border': 'single'}
" To use a custom highlight for the float window,
" change Pmenu to your highlight group
highlight link EchoDocFloat Pmenu
Option 5:
" Or, you could use vim's popup window feature.
let g:echodoc#enable_at_startup = 1
let g:echodoc#type = 'popup'
" To use a custom highlight for the popup window,
" change Pmenu to your highlight group
highlight link EchoDocPopup Pmenu