Mirrors/fish-shell
2
0
Fork 0
mirror of https://github.com/fish-shell/fish-shell synced 2024-12-26 21:03:12 +00:00
Code Issues Projects Releases Packages Wiki Activity

docs: Mention $__fish_x_dir in autoloading chapter

Browse source 
That's what we want people to use instead of hardcoding
"/usr/share/fish", because that would break the code on other systems.

[ci skip]
This commit is contained in:
Fabian Homborg 2019-03-18 17:09:48 +01:00
parent 03454b7dcd
commit 69abbd7b2a
1 changed files with 4 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

7
sphinx_doc_src/index.rst
View file

@ -452,9 +452,10 @@ Fish automatically searches through any directories in the array variable ``$fis
By default, Fish searches the following for functions, using the first available file that it finds: By default, Fish searches the following for functions, using the first available file that it finds:
- A directory for end-users to keep their own functions, usually ``~/.config/fish/functions`` (controlled by the ``XDG_CONFIG_HOME`` environment variable). - A directory for end-users to keep their own functions, usually ``~/.config/fish/functions`` (controlled by the ``XDG_CONFIG_HOME`` environment variable).
- A directory for systems administrators to install functions for all users on the system, usually ``/etc/fish/functions``. - A directory for systems administrators to install functions for all users on the system, usually ``/etc/fish/functions`` (really ``$__fish_sysconfdir/functions``).
- A directory for third-party software vendors to ship their own functions for their software, usually ``/usr/share/fish/vendor_functions.d``. - A directory for third-party software vendors to ship their own functions for their software, usually ``/usr/share/fish/vendor_functions.d``.
- The functions shipped with fish, usually installed in ``/usr/share/fish/functions``. (set at compile time; by default, ``$__fish_data_dir/vendor_functions.d``)
- The functions shipped with fish, usually installed in ``/usr/share/fish/functions`` (really ``$__fish_data_dir/functions``).
These paths are controlled by parameters set at build, install, or run time, and may vary from the defaults listed above. These paths are controlled by parameters set at build, install, or run time, and may vary from the defaults listed above.
@ -1581,7 +1582,7 @@ Configuration files are evaluated in the following order:
- Configuration snippets in files ending in ``.fish``, in the directories: - Configuration snippets in files ending in ``.fish``, in the directories:
- ``$__fish_config_dir/conf.d`` (by default, ``~/.config/fish/conf.d/``) - ``$__fish_config_dir/conf.d`` (by default, ``~/.config/fish/conf.d/``)
- ``$__fish_sysconf_dir/conf.d`` (by default, ``/etc/fish/conf.d``) - ``$__fish_sysconf_dir/conf.d`` (by default, ``/etc/fish/conf.d``)
- ``/usr/share/fish/vendor_conf.d`` (set at compile time; by default, ``$__fish_data_dir/conf.d``) - ``/usr/share/fish/vendor_conf.d`` (set at compile time; by default, ``$__fish_data_dir/vendor_conf.d``)
If there are multiple files with the same name in these directories, only the first will be executed. If there are multiple files with the same name in these directories, only the first will be executed.
They are executed in order of their filename, sorted (like globs) in a natural order (i.e. "01" sorts before "2"). They are executed in order of their filename, sorted (like globs) in a natural order (i.e. "01" sorts before "2").