diff options
author | Fabian Homborg <FHomborg@gmail.com> | 2015-10-20 23:21:57 +0200 |
---|---|---|
committer | Fabian Homborg <FHomborg@gmail.com> | 2016-02-26 12:14:55 +0100 |
commit | c1b384e5d3f2f46e7d7a1b41e31c7aadc1d9ce28 (patch) | |
tree | d8a503f47681505cef7cbbdbdc4f3b0541d768f8 | |
parent | 8b67a1b26f2525f7de1e2a64dee6ab48b72b0e33 (diff) |
Add functions and configuration snippets hierarchy
This allows "vendors" (i.e. third-party upstreams interested in
supporting fish) to add auto-loaded functions and eager-loaded
configuration "snippets", while still allowing both the user and the administrator to
fully override all of that.
This has been inspired by systemd's configuration hierarchy, and implements a similar scheme
whereby files with the same name in higher-ranking directories override files in lower-ranking ones.
Fixes #1956
-rw-r--r-- | Makefile.in | 3 | ||||
-rw-r--r-- | doc_src/index.hdr.in | 1 | ||||
-rw-r--r-- | fish.pc.in | 2 | ||||
-rw-r--r-- | share/config.fish | 14 |
4 files changed, 19 insertions, 1 deletions
diff --git a/Makefile.in b/Makefile.in index 88155b2d..056a3d81 100644 --- a/Makefile.in +++ b/Makefile.in @@ -660,9 +660,12 @@ install-force: all install-translations true ;\ done; $(INSTALL) -m 755 -d $(DESTDIR)$(sysconfdir)/fish + $(INSTALL) -m 755 -d $(DESTDIR)$(sysconfdir)/fish/conf.d $(INSTALL) -m 755 -d $(DESTDIR)$(datadir)/fish $(INSTALL) -m 755 -d $(DESTDIR)$(datadir)/fish/completions $(INSTALL) -m 755 -d $(DESTDIR)$(datadir)/fish/vendor_completions.d + $(INSTALL) -m 755 -d $(DESTDIR)$(datadir)/fish/vendor_functions.d + $(INSTALL) -m 755 -d $(DESTDIR)$(datadir)/fish/vendor_conf.d $(INSTALL) -m 755 -d $(DESTDIR)$(datadir)/fish/functions $(INSTALL) -m 755 -d $(DESTDIR)$(datadir)/fish/man/man1 $(INSTALL) -m 755 -d $(DESTDIR)$(datadir)/fish/tools diff --git a/doc_src/index.hdr.in b/doc_src/index.hdr.in index 9531876b..a0f7ec0a 100644 --- a/doc_src/index.hdr.in +++ b/doc_src/index.hdr.in @@ -1088,6 +1088,7 @@ function on_exit --on-process %self end \endfish +Right after reading /usr/share/fish/config.fish and before reading /etc/fish/config.fish, fish will also read files in ~/.config/fish/conf.d/, /etc/fish/conf.d and /usr/share/fish/vendor_conf.d (the exact values depend on $XDG_CONFIG_HOME, $__fish_sysconfdir and $__fish_datadir). If there are files with the same name in two or all of these, fish will only attempt to read the first (skipping all files with that name if it is unreadable). ~/.config takes precedence over /etc/ which takes precedence over /usr. The path to the latter can also be gotten via `pkg-config` as "confdir", and is meant for third-party applications to integrate with fish. \section other Other features @@ -1,6 +1,8 @@ prefix=@prefix@ datadir=@datadir@ completionsdir=${datadir}/fish/vendor_completions.d +functionsdir=${datadir}/fish/vendor_functions.d +confdir=${datadir}/fish/vendor_conf.d Name: fish Description: fish, the friendly interactive shell diff --git a/share/config.fish b/share/config.fish index b1d404ee..40000740 100644 --- a/share/config.fish +++ b/share/config.fish @@ -49,7 +49,7 @@ end # default functions/completions are included in the respective path. if not set -q fish_function_path - set fish_function_path $configdir/fish/functions $__fish_sysconfdir/functions $__fish_datadir/functions + set fish_function_path $configdir/fish/functions $__fish_sysconfdir/functions $__fish_datadir/vendor_functions.d $__fish_datadir/functions end if not contains $__fish_datadir/functions $fish_function_path @@ -151,3 +151,15 @@ function . --description 'Evaluate contents of file (deprecated, see "source")' source $argv end end + +# As last part of initialization, source the conf directories +# Implement precedence (User > Admin > Vendors > Fish) by basically doing "basename" +set -l sourcelist +for file in $configdir/fish/conf.d/* $__fish_sysconfdir/conf.d/* $__fish_datadir/vendor_conf.d/* + set -l basename (string replace -r '^.*/' '' -- $file) + contains -- $basename $sourcelist; and continue + set sourcelist $sourcelist $basename + # Also skip non-files or unreadable files + # This allows one to use e.g. symlinks to /dev/null to "mask" something (like in systemd) + [ -f $file -a -r $file ]; and source $file +end |