xenia/kakoune
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: add -always and -once switch on hooks page

Browse Source
This commit is contained in:
Delapouite 2018-08-16 19:06:57 +02:00
parent a6da34e192
commit 231e140d37
3 changed files with 13 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
doc/pages/execeval.asciidoc
View File

@ -52,7 +52,7 @@ when the commands have been executed: */*, *"*, *|*, *^*, *@*.
*-no-hooks*:: *-no-hooks*::
disable hook execution while executing the keys/commands disable hook execution while executing the keys/commands
(See <<hooks#,`:doc hooks`>>) (See <<hooks#disabling-hooks,`:doc hooks`>>)
== execute-keys specific switches == execute-keys specific switches

15
doc/pages/hooks.asciidoc
View File

@ -18,20 +18,22 @@ is called.
For example to automatically use line numbering with .cc files, use the For example to automatically use line numbering with .cc files, use the
following command: following command:
---------------------------------------------------- --------------------------------------------------------------
hook global WinCreate .*\.cc %{ add-highlighter number-lines } hook global WinCreate .*\.cc %{ add-highlighter number-lines }
---------------------------------------------------- --------------------------------------------------------------
If *group* is given, make this hook part of the named group. Groups are used If *group* is given, make this hook part of the named group. Groups are used
for removing hooks with the following command: for removing hooks with the following command:
----------------------- ----------------------------
remove-hooks <scope> <group> remove-hooks <scope> <group>
----------------------- ----------------------------
A call to the command above will remove every hooks in *scope* that are part A call to the command above will remove every hooks in *scope* that are part
of the given *group*. of the given *group*.
Hooks declared with the `-once` switch are automatically removed after running.
== Default hooks == Default hooks
*NormalIdle*:: *NormalIdle*::
@ -152,7 +154,7 @@ of the given *group*.
*InsertCompletionSelect* `selected completion`:: *InsertCompletionSelect* `selected completion`::
Triggered when an entry is selected in the insert completion Triggered when an entry is selected in the insert completion
menu. The filtering text is the selected completion text or menu. The filtering text is the selected completion text or
the empty string if the original text was selected back. the empty string if the original text was selected back
*RawKey* `key`:: *RawKey* `key`::
Triggered whenever a key is pressed by the user Triggered whenever a key is pressed by the user
@ -186,3 +188,6 @@ For example indentation hooks can be disabled with '.*-indent'.
Finally, hook execution can be disabled while using the `execute-keys` or Finally, hook execution can be disabled while using the `execute-keys` or
`evaluate-commands` commands by using the `-no-hooks` switch. `evaluate-commands` commands by using the `-no-hooks` switch.
(See <<execeval#,`:doc execeval`>>) (See <<execeval#,`:doc execeval`>>)
As an exception to these rules, hooks declared with the `-always` switch
are triggered no matter what. A good use case is doing some cleanup on `BufCloseFifo`.

3
doc/pages/options.asciidoc
View File

@ -177,7 +177,8 @@ are exclusively available to built-in options.
*disabled_hooks* `regex`:: *disabled_hooks* `regex`::
hooks whose group matches this regex won't be executed. For example hooks whose group matches this regex won't be executed. For example
indentation hooks can be disabled with `.*-indent` indentation hooks can be disabled with `.*-indent`.
(See <<hooks#disabling-hooks,`:doc hooks`>>)
*filetype* `str`:: *filetype* `str`::
arbitrary string defining the type of the file filetype dependant arbitrary string defining the type of the file filetype dependant