fish-shell/sphinx_doc_src/cmds/emit.rst

36 lines
767 B
ReStructuredText

emit - Emit a generic event
==========================================
Synopsis
--------
emit EVENT_NAME [ARGUMENTS...]
Description
------------
``emit`` emits, or fires, an event. Events are delivered to, or caught by, special functions called event handlers. The arguments are passed to the event handlers as function arguments.
Example
------------
The following code first defines an event handler for the generic event named 'test_event', and then emits an event of that type.
::
function event_test --on-event test_event
echo event test: $argv
end
emit test_event something
Notes
------------
Note that events are only sent to the current fish process as there is no way to send events from one fish process to another.