fish-shell/doc_src/cmds/emit.rst

.. _cmd-emit:

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 :ref:`event handlers <event>`. 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.
docs: Add labels to all commands This allows us to use :ref: references, which don't require hardcoding it as html [ci skip] 2019-03-31 09:05:09 +00:00			`.. _cmd-emit:`

doc: homogenize commands titles 2020-03-31 15:37:38 +00:00			`emit - emit a generic event`
Fix command section separator line lengths 2019-01-03 04:10:47 +00:00			`===========================`
Switch command docs from \section to reStructuredText 2018-12-17 01:39:33 +00:00
Migrate the 'synopsis' sections to .rst format 2018-12-18 01:58:24 +00:00			`Synopsis`
			`--------`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 21:08:41 +00:00
Commit doc_src progress. This is continuing the work I've been doing to remove the :: formatting for the synopsis sections of our manual pages. 2021-12-17 21:58:38 +00:00			``emit`` EVENT_NAME [ARGUMENTS...]
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 21:08:41 +00:00
Convert \\subsection sections into rst format 2018-12-19 02:44:30 +00:00			`Description`
Fix command section separator line lengths 2019-01-03 04:10:47 +00:00			`-----------`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 21:08:41 +00:00
doc: add link to event handlers in emit [ci skip] 2019-10-04 13:03:25 +00:00			``emit`` emits, or fires, an event. Events are delivered to, or caught by, special functions called :ref:`event handlers <event>`. The arguments are passed to the event handlers as function arguments.
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 21:08:41 +00:00

Convert \\subsection sections into rst format 2018-12-19 02:44:30 +00:00			`Example`
Fix command section separator line lengths 2019-01-03 04:10:47 +00:00			`-------`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 21:08:41 +00:00
			`The following code first defines an event handler for the generic event named 'test_event', and then emits an event of that type.`


Switch \fish sections to rst format 2018-12-19 03:14:04 +00:00
			`::`

			`function event_test --on-event test_event`
			`echo event test: $argv`
			`end`

			`emit test_event something`

Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 21:08:41 +00:00

Convert \\subsection sections into rst format 2018-12-19 02:44:30 +00:00			`Notes`
Fix command section separator line lengths 2019-01-03 04:10:47 +00:00			`-----`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 21:08:41 +00:00
			`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.`