.TH KAKOUNE 1 "" "" "EXEC & EVAL"

.TP
The
.IR exec " and " eval
commands can be used to run Kakoune commands, and should be used as follows:

.RS 3
.TP
.BR exec " [<flags>] <key> …"
.TP
.BR eval " [<flags>] <command> …"
.RE

.IR exec
runs keys as if they were pressed, whereas
.IR eval
executes its given paremeters as if they were entered in the command prompt. \
By default, their execution happens within the context of the current client, \
and stops when the last key/command is reached, or an error is raised.

.SS Optional flags
.TP
.BR -client " <name>"
execute in the context of the client named
.IR <name>
.TP
.BR -try-client " <name>"
execute in the context of the client named
.IR <name>
if such client exists, or else in the current context
.TP
.BR -draft
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
.TP
.BR -itersel " (requires -draft)"
execute once per selection, in a context with only the considered selection. This permits to avoid cases where the selections may get merged
.TP
.BR -buffer " <names>"
execute in the context of each buffers in the comma separated list
.IR <names> ", " *
as a name can be used to iterate on all buffers
.TP
.BR -no-hooks
disable hook execution while executing the keys/commands
.TP
.BR -with-maps
use user key mapping in
.IR exec
instead of built in keys
.TP
.BR -save-regs " <regs>"
regs is a string of registers to be restored after execution