From 59b5644fb3d893c8146edd5e370f02ab114c09c2 Mon Sep 17 00:00:00 2001 From: w0rp Date: Wed, 22 Mar 2017 08:57:29 +0000 Subject: [PATCH] Clean up the documentation some more, and make the description of the ALELint autocmd clearer --- doc/ale.txt | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/doc/ale.txt b/doc/ale.txt index bf700e0a..a5630977 100644 --- a/doc/ale.txt +++ b/doc/ale.txt @@ -1280,6 +1280,7 @@ ale#engine#ManageDirectory(buffer, directory) *ale#engine#ManageDirectory()* ale#linter#Define(filetype, linter) *ale#linter#Define()* + Given a |String| for a filetype and a |Dictionary| Describing a linter configuration, add a linter for the given filetype. The dictionaries each offer the following options: @@ -1468,6 +1469,7 @@ ale#linter#Define(filetype, linter) *ale#linter#Define()* ale#linter#Get(filetype) *ale#linter#Get()* + Return all of linters configured for a given filetype as a |List| of |Dictionary| values in the format specified by |ale#linter#Define()|. @@ -1481,6 +1483,7 @@ ale#linter#Get(filetype) *ale#linter#Get()* ale#statusline#Status() *ale#statusline#Status()* + Return a formatted string that can be added to the statusline. The output's format is defined in |`g:ale_statusline_format`|. To enable it, the following should be present in your |statusline| settings: > @@ -1488,12 +1491,16 @@ ale#statusline#Status() *ale#statusline#Status()* ALELint *ALELint-autocmd* - This |User| autocommand is triggered by ALE every time it completes a lint - operation. It can be used to update statuslines, send notifications, or - complete any other operation that needs to be done after a lint run. - It can be used simply: - autocmd User ALELint echom "ALE run!" + This |User| autocommand is triggered by ALE every time it completes a lint + cycle. It can be used to update statuslines, send notifications, or + complete any other operation that needs to be done after linting has been + performed. + + For example, you can echo a message when linting is complete like so: + > + autocmd User ALELint echom "ALE run!" +< =============================================================================== 8. Special Thanks *ale-special-thanks*