4d11bb20c3
There does not seem to be any reasonable use cases of not collapsing jumps when the input is not comming from the user. Always collapse them. It could make sense to move jump collapsing out of context_wrap as in general any action not comming directly from the user should collapse them, at the moment a comment or mapping will not collapse jumps, which is unfortunate.
57 lines
1.9 KiB
Plaintext
57 lines
1.9 KiB
Plaintext
= Execute-keys and Evaluate-commands
|
||
|
||
== Description
|
||
|
||
The *execute-keys* and *evaluate-commands* commands can be used to run
|
||
Kakoune commands, and should be used as follows:
|
||
|
||
----------------------------
|
||
execute-keys [<flags>] <key> ...
|
||
evaluate-commands [<flags>] <command> ...
|
||
----------------------------
|
||
|
||
*execute-keys* runs keys as if they were pressed, whereas *evaluate-commands*
|
||
evaluates its given parameters 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.
|
||
|
||
These two commands also save the following registers, who are then restored
|
||
when the commands have been executed: */*, *"*, *|*, *^*, *@*.
|
||
(See <<registers#,`:doc registers`>>)
|
||
|
||
== Optional flags
|
||
|
||
*-client* <name>::
|
||
execute in the context of the client named *name*
|
||
|
||
*-try-client* <name>::
|
||
execute in the context of the client named *name* if such client
|
||
exists, or else in the current context
|
||
|
||
*-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
|
||
|
||
*-itersel*::
|
||
execute once per selection, in a context with only the considered
|
||
selection. This permits avoiding cases where the selections may
|
||
get merged
|
||
|
||
*-buffer* <names>::
|
||
execute in the context of each buffers in the comma separated list
|
||
*names*, as a name can be used to iterate on all buffers
|
||
|
||
*-no-hooks*::
|
||
disable hook execution while executing the keys/commands
|
||
(See <<hooks#,`:doc hooks`>>)
|
||
|
||
*-with-maps*::
|
||
use user key mapping in instead of built in keys (*execute-keys* only)
|
||
(See <<mapping#,`:doc mapping`>>)
|
||
|
||
*-save-regs* <regs>::
|
||
regs is a string of registers to be restored after execution (overwrites
|
||
the list of registers saved by default, c.f. description)
|