https://github.com/Ambrevar/emacs-fish-completion
[MOVED TO GITLAB]
https://github.com/Ambrevar/emacs-fish-completion
completion emacs eshell fish
Last synced: 11 months ago
JSON representation
[MOVED TO GITLAB]
- Host: GitHub
- URL: https://github.com/Ambrevar/emacs-fish-completion
- Owner: Ambrevar
- License: gpl-3.0
- Created: 2017-10-25T22:29:30.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2018-08-27T08:29:44.000Z (almost 8 years ago)
- Last Synced: 2024-11-19T16:47:38.308Z (over 1 year ago)
- Topics: completion, emacs, eshell, fish
- Language: Emacs Lisp
- Homepage: https://gitlab.com/ambrevar/emacs-fish-completion
- Size: 21.5 KB
- Stars: 60
- Watchers: 5
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Emacs fish completion
This package extends the `pcomplete` completion framework with completion from the
[fish shell](http://fishshell.com/).
The `fish` shell has smart completion for a wide range of programs. `fish` does
not require any special configuration to work with this package.
Eshell, which uses `pcomplete` for completion, can be made to fall back on
`fish` when it does not find any completion candidate with its native completion
support.
`M-x shell` can be made to use `fish`. This will disable the underlying shell
completion.
## Setup
To enable fish completion in all Eshell and `M-x shell` buffers, add this to
your Emacs configuration:
(when (and (executable-find "fish")
(require 'fish-completion nil t))
(global-fish-completion-mode))
The condition will prevent the package from loading if `fish` is not found
(change the executable name according to you local installation).
Alternatively, you can simply load the package with `(require 'fish-completion)`
and call `fish-completion-mode` manually.
Optionally, if the package
[bash-completion](https://github.com/szermatt/emacs-bash-completion) is
installed, `fish-completion-complete` can be configured to fall back on bash to
further try completing. See `fish-completion-fallback-on-bash-p`.