diff --git a/README.asciidoc b/README.asciidoc index 4452fb00f..942802391 100644 --- a/README.asciidoc +++ b/README.asciidoc @@ -893,10 +893,10 @@ Some options are built in Kakoune, and can be used to control it's behaviour: (`word=all`) or only the current one (`word=buffer`) - `filename` which tries to detect when a filename is being entered and provides completion based on local filesystem. - - `option=` where is a _str-list_ option. The first - element of the list should follow the format: - _.[+]@_ to define where the completion - apply in the buffer, and the other strings are the candidates. + - `option=` where is a _completions_ option, which is a `:` + separated list of _||_ candidates, except for the first + element which follows the _.[+]@_ format to define + where the completion apply in the buffer. * `static_words` _str-list_: list of words that are always added to completion candidates when completing words in insert mode. * `autoreload` _enum(yes|no|ask)_: auto reload the buffers when an external diff --git a/doc/interfacing.asciidoc b/doc/interfacing.asciidoc index 8efe75e65..f896b1750 100644 --- a/doc/interfacing.asciidoc +++ b/doc/interfacing.asciidoc @@ -85,13 +85,13 @@ external completions are provided using an option to store completion, which have the following format. ---- -line.column[+len]@timestamp:candidate1[|desc1[|menu1]]:candidate2[|desc2[|menu2]]:... +line.column[+len]@timestamp:candidate1|desc1|menu1:candidate2|desc2|menu2:... ---- the first element of this string list specify where and when this completions -applies, the others are simply completion candidates, eventually containing -a descriptive text (after an `|` separator), and a separate menu text (after -the second `|` separator). +applies, the others are a triplet `||` + +The menu text is a a markup string, so it can contain `{face}` directives. to effectively use that completion option, it should get added to the completers option.