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

30 lines
791 B
ReStructuredText

emit - Emit a generic event
==========================================
Synopsis
--------
emit EVENT_NAME [ARGUMENTS...]
\subsection emit-description 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.
\subsection emit-example Example
The following code first defines an event handler for the generic event named 'test_event', and then emits an event of that type.
\fish
function event_test --on-event test_event
echo event test: $argv
end
emit test_event something
\endfish
\subsection emit-notes 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.