Document completion support for ALE, and expand the fixer documentation a little

This commit is contained in:
w0rp
2017-08-18 00:08:58 +01:00
parent 0a282eb76a
commit 2365fd2948
2 changed files with 115 additions and 12 deletions

View File

@@ -11,7 +11,8 @@ CONTENTS *ale-contents*
3. Global Options.......................|ale-options|
3.1 Highlights........................|ale-highlights|
4. Fixing Problems......................|ale-fix|
5. Integration Documentation............|ale-integrations|
5. Completion...........................|ale-completion|
6. Integration Documentation............|ale-integrations|
asm...................................|ale-asm-options|
gcc.................................|ale-asm-gcc|
c.....................................|ale-c-options|
@@ -132,10 +133,10 @@ CONTENTS *ale-contents*
yaml..................................|ale-yaml-options|
swaglint............................|ale-yaml-swaglint|
yamllint............................|ale-yaml-yamllint|
6. Commands/Keybinds....................|ale-commands|
7. API..................................|ale-api|
8. Special Thanks.......................|ale-special-thanks|
9. Contact..............................|ale-contact|
7. Commands/Keybinds....................|ale-commands|
8. API..................................|ale-api|
9. Special Thanks.......................|ale-special-thanks|
10. Contact.............................|ale-contact|
===============================================================================
1. Introduction *ale-introduction*
@@ -271,6 +272,44 @@ g:ale_change_sign_column_color *g:ale_change_sign_column_color*
windows.
g:ale_completion_delay *g:ale_completion_delay*
Type: |Number|
Default: `100`
The number of milliseconds before ALE will send a request to a language
server for completions after you have finished typing.
See |ale-completion|
g:ale_completion_enabled *g:ale_completion_enabled*
Type: |Number|
Default: `0`
When this option is set to `1`, completion support will be enabled.
See |ale-completion|
g:ale_completion_max_suggestions *g:ale_completion_max_suggestions*
Type: |Number|
Default: `20`
The maximum number of items ALE will suggest in completion menus for
automatic completion.
Setting this number higher will require more processing time, and may
suggest too much noise. Setting this number lower will require less
processing time, but some suggestions will not be included, so you might not
be able to see the suggestions you want.
Adjust this option as needed, depending on the complexity of your codebase
and your available processing power.
g:ale_echo_cursor *g:ale_echo_cursor*
Type: |Number|
@@ -410,7 +449,7 @@ g:ale_keep_list_window_open *g:ale_keep_list_window_open*
the loclist or quicfix windows will be closed automatically when there
are no warnings or errors.
See: |g:ale_open_list|
See |g:ale_open_list|
g:ale_list_window_size *g:ale_list_window_size*
@@ -1031,7 +1070,26 @@ by default.
===============================================================================
5. Integration Documentation *ale-integrations*
5. Completion *ale-completion*
ALE offers some limited support for automatic completion of code while you
type. Completion is only supported via Language Server Protocol servers which
ALE can connect to for linting, which can offer good built-in support for
suggesting completion information. ALE will only suggest symbols for
completion for LSP linters that are enabled.
NOTE: At the moment, only `tsserver` for TypeScript code is supported for
completion.
Suggestions will be made while you type after completion is enabled.
Completion can be enabled by setting |g:ale_completion_enabled| to `1`. The
delay for completion can be configured with |g:ale_completion_delay|. ALE will
only suggest so many possible matches for completion. The maximum number of
items can be controlled with |g:ale_completion_max_suggestions|.
===============================================================================
6. Integration Documentation *ale-integrations*
Linter and fixer options are documented in individual help files. See the
table of contents at |ale-contents|.
@@ -1064,7 +1122,7 @@ ALE will use to search for Python executables.
===============================================================================
6. Commands/Keybinds *ale-commands*
7. Commands/Keybinds *ale-commands*
ALEFix *ALEFix*
@@ -1167,7 +1225,7 @@ ALEInfoToClipboard *ALEInfoToClipboard*
===============================================================================
7. API *ale-api*
8. API *ale-api*
ale#Queue(delay, [linting_flag, buffer_number]) *ale#Queue()*
@@ -1557,13 +1615,13 @@ ALELint *ALELint-autocmd*
echoing messges.
===============================================================================
8. Special Thanks *ale-special-thanks*
9. Special Thanks *ale-special-thanks*
Special thanks to Mark Grealish (https://www.bhalash.com/) for providing ALE's
snazzy looking ale glass logo. Cheers, Mark!
===============================================================================
9. Contact *ale-contact*
10. Contact *ale-contact*
If you like this plugin, and wish to get in touch, check out the GitHub
page for issues and more at https://github.com/w0rp/ale