2017-05-27 09:35:13 +03:00
|
|
|
kakoune(k)
|
2016-02-03 20:15:35 +03:00
|
|
|
==========
|
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
|
|
|
options - a
|
|
|
|
|
|
|
|
Types
|
|
|
|
-----
|
|
|
|
*int*::
|
|
|
|
an integer number
|
|
|
|
*bool*::
|
|
|
|
a boolean value, yes/true or no/false
|
|
|
|
*str*::
|
|
|
|
a string, some freeform text
|
|
|
|
*coord*::
|
|
|
|
a line, column pair (separated by comma)
|
|
|
|
*regex*::
|
2016-02-11 00:03:49 +03:00
|
|
|
as a string but the set commands will complain if the entered text
|
|
|
|
is not a valid regex
|
2017-07-12 20:18:24 +03:00
|
|
|
*int-list*, *str-list*, *codepoint-list*::
|
2016-02-11 00:03:49 +03:00
|
|
|
a list, elements are separated by a colon (:) if an element needs
|
2017-05-11 21:42:09 +03:00
|
|
|
to contain a colon, it can be escaped with a backslash
|
2017-05-17 21:35:54 +03:00
|
|
|
*range-specs*::
|
2017-05-25 11:02:10 +03:00
|
|
|
a `:` separated list of a pair of a buffer range (`<begin
|
|
|
|
line>.<begin column>,<end line>.<end column>` or `<begin
|
|
|
|
line>.<begin column>+<length>`) and a string (separated by `|`),
|
|
|
|
except for the first element which is just the timestamp of
|
|
|
|
the buffer. When the `update-option` is used on an option of
|
|
|
|
this type, its ranges gets updated according to all the buffer
|
|
|
|
modifications that happened since its timestamp.
|
|
|
|
*line-specs*::
|
2017-05-11 21:40:17 +03:00
|
|
|
a `:` separated list of a line number and a corresponding flag
|
2017-05-25 11:02:10 +03:00
|
|
|
(`<line>|<flag text>`), except for the first element which is
|
|
|
|
just the timestamp of the buffer. When the `update-option` is
|
|
|
|
used on an option of this type, its lines gets updated according
|
|
|
|
to all the buffer modifications that happened since its timestamp.
|
2016-08-27 13:05:22 +03:00
|
|
|
*completions*::
|
|
|
|
a `:` separated list of `<text>|<docstring>|<menu text>`
|
|
|
|
candidates, except for the first element which follows the
|
|
|
|
`<line>.<column>[+<length>]@<timestamp>` format to define where the
|
2017-05-17 11:27:57 +03:00
|
|
|
completion apply in the buffer. Markup can be used in the menu text.
|
2016-02-03 20:15:35 +03:00
|
|
|
*enum(value1|value2|...)*::
|
|
|
|
an enum, taking one of the given values
|
|
|
|
*flags(value1|value2|...)*::
|
2016-02-11 00:03:49 +03:00
|
|
|
a set of flags, taking a combination of the given values joined by a
|
|
|
|
'|' character
|
2016-02-03 20:15:35 +03:00
|
|
|
|
2016-10-13 11:55:09 +03:00
|
|
|
Refer to the 'scopes' documentation page for more information about
|
|
|
|
scopes.
|
2016-02-03 20:15:35 +03:00
|
|
|
|
|
|
|
Builtin options
|
|
|
|
---------------
|
|
|
|
|
|
|
|
*tabstop* 'int'::
|
|
|
|
width of a tab character
|
|
|
|
|
|
|
|
*indentwidth* 'int'::
|
|
|
|
width (in spaces) used for indentation, 0 means a tab character
|
|
|
|
|
|
|
|
*scrolloff* 'coord'::
|
2016-02-11 00:03:49 +03:00
|
|
|
number of lines, columns to keep visible around the cursor when
|
|
|
|
scrolling
|
2016-02-03 20:15:35 +03:00
|
|
|
|
|
|
|
*eolformat* 'enum(lf|crlf)'::
|
2016-02-11 00:03:49 +03:00
|
|
|
the format of end of lines when writing a buffer, this is autodetected
|
2016-10-13 11:55:09 +03:00
|
|
|
on load; values of this option assigned to the `window` scope are
|
|
|
|
ignored
|
2016-02-03 20:15:35 +03:00
|
|
|
|
|
|
|
*BOM* 'enum(none|utf8)'::
|
2017-04-21 13:32:47 +03:00
|
|
|
define if the file should be written with a unicode byte order mark;
|
2016-10-13 11:55:09 +03:00
|
|
|
values of this option assigned to the `window` scope are ignored
|
2016-02-03 20:15:35 +03:00
|
|
|
|
2016-07-11 18:39:26 +03:00
|
|
|
*readonly* 'bool'::
|
2016-10-13 11:55:09 +03:00
|
|
|
prevent modifications from being saved to disk, all buffers if set
|
|
|
|
to `true` in the `global` scope, or current buffer if set in the
|
|
|
|
`buffer` scope; values of this option assigned to the `window`
|
|
|
|
scope are ignored
|
2016-07-11 18:39:26 +03:00
|
|
|
|
2016-02-03 20:15:35 +03:00
|
|
|
*incsearch* 'bool'::
|
|
|
|
execute search as it is typed
|
|
|
|
|
|
|
|
*aligntab* 'bool'::
|
2016-04-08 19:00:24 +03:00
|
|
|
use tabs for alignment command
|
2016-02-03 20:15:35 +03:00
|
|
|
|
|
|
|
*autoinfo* 'flags(command|onkey|normal)'::
|
|
|
|
display automatic information box in the enabled contexts
|
|
|
|
|
|
|
|
*autoshowcompl* 'bool'::
|
|
|
|
automatically display possible completions when editing a prompt
|
|
|
|
|
|
|
|
*ignored_files* 'regex'::
|
2017-04-21 13:32:47 +03:00
|
|
|
filenames matching this regex won't be considered as candidates on
|
2016-02-11 00:03:49 +03:00
|
|
|
filename completion (except if the text being completed already
|
|
|
|
matches it)
|
2016-02-03 20:15:35 +03:00
|
|
|
|
|
|
|
*disabled_hooks* 'regex'::
|
2017-04-21 13:32:47 +03:00
|
|
|
hooks whose group matches this regex won't be executed. For example
|
2016-02-11 00:03:49 +03:00
|
|
|
indentation hooks can be disabled with '.*-indent'
|
2016-02-03 20:15:35 +03:00
|
|
|
|
|
|
|
*filetype* 'str'::
|
2016-02-11 00:03:49 +03:00
|
|
|
arbitrary string defining the type of the file filetype dependant
|
|
|
|
actions should hook on this option changing for activation/deactivation
|
2016-02-03 20:15:35 +03:00
|
|
|
|
|
|
|
*path* 'str-list'::
|
|
|
|
directories to search for gf command
|
|
|
|
|
|
|
|
*completers* 'str-list'::
|
2016-02-11 00:03:49 +03:00
|
|
|
completion engines to use for insert mode completion (they are tried
|
|
|
|
in order until one generates candidates). Existing completers are:
|
2016-02-03 20:15:35 +03:00
|
|
|
|
|
|
|
*word=all*, *word=buffer*:::
|
2016-02-11 00:03:49 +03:00
|
|
|
which complete using words in all buffers (*word=all*)
|
|
|
|
or only the current one (*word=buffer*)
|
2016-02-03 20:15:35 +03:00
|
|
|
|
|
|
|
*filename*:::
|
2016-02-11 00:03:49 +03:00
|
|
|
which tries to detect when a filename is being entered and
|
|
|
|
provides completion based on local filesystem
|
2016-02-03 20:15:35 +03:00
|
|
|
|
|
|
|
*option=<opt-name>*:::
|
2017-05-20 20:27:02 +03:00
|
|
|
where *opt-name* is an option of type 'completions' whose
|
|
|
|
contents will be used
|
2016-02-03 20:15:35 +03:00
|
|
|
|
2016-08-21 22:25:11 +03:00
|
|
|
*static_words* 'str-list'::
|
|
|
|
list of words that are always added to completion candidates
|
|
|
|
when completing words in insert mode
|
|
|
|
|
2017-07-12 20:18:24 +03:00
|
|
|
*extra_word_chars* 'codepoint-list'::
|
|
|
|
a list of all additional codepoints that should be considered
|
2016-08-21 22:25:11 +03:00
|
|
|
as word character for the purpose of insert mode completion.
|
2016-02-03 20:15:35 +03:00
|
|
|
|
|
|
|
*autoreload* 'enum(yes|no|ask)'::
|
|
|
|
auto reload the buffers when an external modification is detected
|
|
|
|
|
2017-08-27 20:30:26 +03:00
|
|
|
*debug* 'flags(hooks|shell|profile|keys|commands)'::
|
2016-02-03 20:15:35 +03:00
|
|
|
dump various debug information in the '\*debug*' buffer
|
|
|
|
|
2016-09-18 15:47:22 +03:00
|
|
|
*idle_timeout* 'int'::
|
|
|
|
timeout, in milliseconds, with no user input that will trigger the
|
2017-07-05 14:45:45 +03:00
|
|
|
*PromptIdle*, *InsertIdle* and *NormalIdle* hooks.
|
2016-09-18 15:47:22 +03:00
|
|
|
|
|
|
|
*fs_checkout_timeout* 'int'::
|
|
|
|
timeout, in milliseconds, between checks in normal mode of modifications
|
|
|
|
of the file associated with the current buffer on the filesystem.
|
|
|
|
|
2016-02-03 20:15:35 +03:00
|
|
|
*modelinefmt* 'string'::
|
2016-02-11 00:03:49 +03:00
|
|
|
A format string used to generate the mode line, that string is first
|
|
|
|
expanded as a command line would be (expanding '%...{...}' strings),
|
2017-03-10 12:06:37 +03:00
|
|
|
then markup tags are applied (c.f. the 'Expansions' documentation page.)
|
|
|
|
Two special atoms are available as markup:
|
|
|
|
|
|
|
|
*`{{mode_info}}`*:::
|
2017-05-11 21:42:09 +03:00
|
|
|
Information about the current mode, such as `insert 3 sel` or
|
2017-03-10 12:06:37 +03:00
|
|
|
`prompt`. The faces used are StatusLineMode, StatusLineInfo,
|
|
|
|
and StatusLineValue.
|
|
|
|
|
|
|
|
*`{{context_info}}`*:::
|
|
|
|
Information such as `[+][recording (@)][no-hooks][new file][fifo]`,
|
|
|
|
in face Information.
|
|
|
|
|
|
|
|
The default value is '%val{bufname} %val{cursor_line}:%val{cursor_char_column} {{context_info}} {{mode_info}} - %val{client}@[%val{session}]'
|
2016-02-03 20:15:35 +03:00
|
|
|
|
|
|
|
*ui_options*::
|
2016-02-11 00:03:49 +03:00
|
|
|
colon separated list of key=value pairs that are forwarded to the user
|
|
|
|
interface implementation. The NCurses UI support the following options:
|
2016-02-03 20:15:35 +03:00
|
|
|
|
|
|
|
*ncurses_set_title*:::
|
2016-02-11 00:03:49 +03:00
|
|
|
if *yes* or *true*, the terminal emulator title will
|
|
|
|
be changed
|
2016-02-03 20:15:35 +03:00
|
|
|
|
|
|
|
*ncurses_status_on_top*:::
|
2016-02-11 00:03:49 +03:00
|
|
|
if *yes*, or *true* the status line will be placed
|
|
|
|
at the top of the terminal rather than at the bottom
|
2016-02-03 20:15:35 +03:00
|
|
|
|
|
|
|
*ncurses_assistant*:::
|
2016-02-11 00:03:49 +03:00
|
|
|
specify the nice assistant you get in info boxes,
|
2017-03-08 19:45:15 +03:00
|
|
|
can be *clippy* (the default), *cat*, *dilbert* or *none*
|
2016-02-03 20:15:35 +03:00
|
|
|
|
2016-10-29 10:48:02 +03:00
|
|
|
*ncurses_enable_mouse*:::
|
|
|
|
boolean option that enables mouse support
|
|
|
|
|
2016-12-30 10:01:13 +03:00
|
|
|
*ncurses_change_colors*:::
|
|
|
|
boolean option that can disable color palette changing if the
|
|
|
|
terminfo enables it but the terminal does not support it.
|
|
|
|
|
2016-02-03 20:15:35 +03:00
|
|
|
*ncurses_wheel_down_button*, *ncurses_wheel_up_button*:::
|
|
|
|
specify which button send for wheel down/up events
|