2017-05-27 09:35:13 +03:00
|
|
|
|
kakoune(k)
|
2016-02-03 20:15:35 +03:00
|
|
|
|
==========
|
|
|
|
|
|
|
|
|
|
NAME
|
|
|
|
|
----
|
|
|
|
|
execeval - a
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
-----------
|
2016-02-11 00:03:49 +03:00
|
|
|
|
The *exec* and *eval* commands can be used to run Kakoune commands, and
|
|
|
|
|
should be used as follows:
|
2016-02-03 20:15:35 +03:00
|
|
|
|
|
|
|
|
|
----------------------------
|
|
|
|
|
exec [<flags>] <key> ...
|
|
|
|
|
eval [<flags>] <command> ...
|
|
|
|
|
----------------------------
|
|
|
|
|
|
2016-02-11 00:03:49 +03:00
|
|
|
|
*exec* runs keys as if they were pressed, whereas *eval* executes its given
|
2016-04-08 19:00:24 +03:00
|
|
|
|
parameters as if they were entered in the command prompt. By default, their
|
2016-02-11 00:03:49 +03:00
|
|
|
|
execution happens within the context of the current client, and stops when
|
2016-02-03 20:15:35 +03:00
|
|
|
|
the last key/command is reached, or an error is raised.
|
|
|
|
|
|
2016-02-18 15:57:23 +03:00
|
|
|
|
These two commands also save the following registers, who are then restored
|
|
|
|
|
when the commands have been executed: */*, *"*, *|*, *^*, *@*.
|
|
|
|
|
|
2016-02-03 20:15:35 +03:00
|
|
|
|
Optional flags
|
|
|
|
|
--------------
|
|
|
|
|
*-client* <name>::
|
|
|
|
|
execute in the context of the client named *name*
|
|
|
|
|
|
|
|
|
|
*-try-client* <name>::
|
2016-02-11 00:03:49 +03:00
|
|
|
|
execute in the context of the client named *name* if such client
|
|
|
|
|
exists, or else in the current context
|
2016-02-03 20:15:35 +03:00
|
|
|
|
|
|
|
|
|
*-draft*::
|
2016-02-11 00:03:49 +03:00
|
|
|
|
execute in a copy of the context of the selected client. Modifications
|
|
|
|
|
to the selections or input state will not affect the client. This
|
|
|
|
|
permits to make some modification to the buffer without modifying
|
|
|
|
|
the user’s selection
|
2016-02-03 20:15:35 +03:00
|
|
|
|
|
|
|
|
|
*-itersel* (requires -draft)::
|
2016-02-11 00:03:49 +03:00
|
|
|
|
execute once per selection, in a context with only the considered
|
2017-04-21 13:32:47 +03:00
|
|
|
|
selection. This permits avoiding cases where the selections may
|
2016-02-11 00:03:49 +03:00
|
|
|
|
get merged
|
2016-02-03 20:15:35 +03:00
|
|
|
|
|
|
|
|
|
*-buffer* <names>::
|
2016-02-11 00:03:49 +03:00
|
|
|
|
execute in the context of each buffers in the comma separated list
|
|
|
|
|
*names*, as a name can be used to iterate on all buffers
|
2016-02-03 20:15:35 +03:00
|
|
|
|
|
|
|
|
|
*-no-hooks*::
|
|
|
|
|
disable hook execution while executing the keys/commands
|
|
|
|
|
|
|
|
|
|
*-with-maps*::
|
|
|
|
|
use user key mapping in instead of built in keys (*exec* only)
|
|
|
|
|
|
|
|
|
|
*-save-regs* <regs>::
|
2016-02-18 15:57:23 +03:00
|
|
|
|
regs is a string of registers to be restored after execution (overwrites
|
|
|
|
|
the list of registers saved by default, c.f. description)
|