From f1ef94b87150bd8f1f70c670409bd668136b8258 Mon Sep 17 00:00:00 2001 From: ZyX Date: Mon, 14 Aug 2017 01:20:52 +0300 Subject: doc: Clarify how function is executed --- runtime/doc/eval.txt | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt index 905d0b590b..279c5e4442 100644 --- a/runtime/doc/eval.txt +++ b/runtime/doc/eval.txt @@ -4744,6 +4744,14 @@ input({opts}) sections must be ordered so that next hl_start_col is greater then or equal to previous hl_end_col. + Highlight function is called at least once for each new input + string, before command-line is redrawn. It is expected that + function is pure for the duration of one input() call, i.e. it + produces the same output for the same input, so output may be + memoized. Function is run like under |:silent| modifier, + additionally any errors from function cause it to be no longer + executed for the duration of the current input() call. + Currently coloring is disabled when command-line contains arabic characters. -- cgit