fish-shell/doc_src/cmds/funcsave.rst
Fabian Homborg 06b317c07f Document funced/funcsave harder
[ci skip]
2020-03-19 18:02:16 +01:00

22 lines
986 B
ReStructuredText

.. _cmd-funcsave:
funcsave - save the definition of a function to the user's autoload directory
=============================================================================
Synopsis
--------
::
funcsave FUNCTION_NAME
Description
-----------
``funcsave`` saves a function to a file in the fish configuration directory. This function will be automatically loaded by current and future fish sessions. This can be useful if you have interactively created a new function and wish to save it for later use.
Note that because fish loads functions on-demand, saved functions will not function as :ref:`event handlers <event>` until they are run or sourced otherwise. To activate an event handler for every new shell, add the function to your :ref:`shell initialization file <initialization>` instead of using ``funcsave``.
This is typically used together with :ref:`funced <cmd-funced>`, which will open the function in your editor and load it in the current seession afterwards.