fish-shell/sphinx_doc_src/cmds/emit.rst
2019-02-24 18:15:48 -08:00

37 lines
739 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.