Improve documentation for completions options
This commit is contained in:
parent
b9144f151a
commit
e0c1f33427
|
@ -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`)
|
(`word=all`) or only the current one (`word=buffer`)
|
||||||
- `filename` which tries to detect when a filename is being entered and
|
- `filename` which tries to detect when a filename is being entered and
|
||||||
provides completion based on local filesystem.
|
provides completion based on local filesystem.
|
||||||
- `option=<opt-name>` where <opt-name> is a _str-list_ option. The first
|
- `option=<opt-name>` where <opt-name> is a _completions_ option, which is a `:`
|
||||||
element of the list should follow the format:
|
separated list of _<text>|<docstring>|<menu text>_ candidates, except for the first
|
||||||
_<line>.<column>[+<length>]@<timestamp>_ to define where the completion
|
element which follows the _<line>.<column>[+<length>]@<timestamp>_ format to define
|
||||||
apply in the buffer, and the other strings are the candidates.
|
where the completion apply in the buffer.
|
||||||
* `static_words` _str-list_: list of words that are always added to completion
|
* `static_words` _str-list_: list of words that are always added to completion
|
||||||
candidates when completing words in insert mode.
|
candidates when completing words in insert mode.
|
||||||
* `autoreload` _enum(yes|no|ask)_: auto reload the buffers when an external
|
* `autoreload` _enum(yes|no|ask)_: auto reload the buffers when an external
|
||||||
|
|
|
@ -85,13 +85,13 @@ external completions are provided using an option to store completion, which
|
||||||
have the following format.
|
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
|
the first element of this string list specify where and when this completions
|
||||||
applies, the others are simply completion candidates, eventually containing
|
applies, the others are a triplet `<completion text>|<docstring>|<menu text>`
|
||||||
a descriptive text (after an `|` separator), and a separate menu text (after
|
|
||||||
the second `|` separator).
|
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
|
to effectively use that completion option, it should get added to the completers
|
||||||
option.
|
option.
|
||||||
|
|
Loading…
Reference in New Issue
Block a user