From 6d20b6c1628bff0a0eeacd0bf02c0dd1463c3acb Mon Sep 17 00:00:00 2001 From: David Briscoe Date: Fri, 4 Feb 2022 03:22:40 -0800 Subject: doc: Clarify the types of process_with (#4039) --- doc/ale.txt | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/doc/ale.txt b/doc/ale.txt index c7c1e81b..c31e2d3b 100644 --- a/doc/ale.txt +++ b/doc/ale.txt @@ -364,12 +364,16 @@ are supported for running the commands. `process_with` An optional callback for post-processing. - The callback must accept two arguments, - `(buffer, output)`, which can be used for converting - the output from a command into lines to replace the - buffer's contents with. + The callback must accept arguments `(bufnr, output)`: + the buffer number undergoing fixing and the fixer's + output as a |List| of |String|s. It must return a |List| + of |String|s that will be the new contents of the + buffer. + + This callback is useful to remove excess lines from the + command's output or apply additional changes to the + output. - A |List| of |String|s must be returned. `read_buffer` An optional key for disabling reading the buffer. -- cgit v1.2.3