66 lines
3.5 KiB
Markdown
66 lines
3.5 KiB
Markdown
zsh-completions   [](irc://irc.freenode.net/#zsh-completions) [](https://gitter.im/zsh-users/zsh-completions?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
|
|
=============
|
|
|
|
**Additional completion definitions for [Zsh](http://www.zsh.org).**
|
|
|
|
*This projects aims at gathering/developing new completion scripts that are not available in Zsh yet. The scripts may be contributed to the Zsh project when stable enough.*
|
|
|
|
|
|
## Usage
|
|
|
|
### Using packages
|
|
|
|
| System | Package |
|
|
| ------------- | ------------- |
|
|
| Debian / Ubuntu | [zsh-completions OBS repository](https://software.opensuse.org/download.html?project=shells%3Azsh-users%3Azsh-completions&package=zsh-completions) |
|
|
| Fedora / CentOS / RHEL / Scientific Linux | [zsh-completions OBS repository](https://software.opensuse.org/download.html?project=shells%3Azsh-users%3Azsh-completions&package=zsh-completions) |
|
|
| OpenSUSE / SLE | [zsh-completions OBS repository](https://software.opensuse.org/download.html?project=shells%3Azsh-users%3Azsh-completions&package=zsh-completions) |
|
|
| Arch Linux / Manjaro / Antergos / Hyperbola | [zsh-completions](https://www.archlinux.org/packages/zsh-completions), [zsh-completions-git](https://aur.archlinux.org/packages/zsh-completions-git) |
|
|
| Gentoo / Funtoo | [app-shells/zsh-completions](http://packages.gentoo.org/package/app-shells/zsh-completions) |
|
|
| NixOS | [zsh-completions](https://github.com/NixOS/nixpkgs/blob/master/pkgs/shells/zsh/zsh-completions/default.nix) |
|
|
| Void Linux | [zsh-completions](https://github.com/void-linux/void-packages/blob/master/srcpkgs/zsh-completions/template) |
|
|
| Slackware | [Slackbuilds](https://slackbuilds.org/repository/14.2/system/zsh-completions/) |
|
|
| macOS | [homebrew](https://github.com/Homebrew/homebrew-core/blob/master/Formula/zsh-completions.rb), [MacPorts](https://github.com/macports/macports-ports/blob/master/sysutils/zsh-completions/Portfile) |
|
|
| NetBSD | [pkgsrc](http://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc/shells/zsh-completions/README.html) |
|
|
|
|
|
|
### Using zsh frameworks
|
|
|
|
#### [antigen](https://github.com/zsh-users/antigen)
|
|
|
|
Add `antigen bundle zsh-users/zsh-completions` to your `~/.zshrc`.
|
|
|
|
#### [oh-my-zsh](http://github.com/robbyrussell/oh-my-zsh)
|
|
|
|
* Clone the repository inside your oh-my-zsh repo:
|
|
|
|
git clone https://github.com/zsh-users/zsh-completions ${ZSH_CUSTOM:=~/.oh-my-zsh/custom}/plugins/zsh-completions
|
|
|
|
* Enable it in your `.zshrc` by adding it to your plugin list and reloading the completion:
|
|
|
|
plugins=(… zsh-completions)
|
|
autoload -U compinit && compinit
|
|
|
|
### Manual installation
|
|
|
|
* Clone the repository:
|
|
|
|
git clone git://github.com/zsh-users/zsh-completions.git
|
|
|
|
* Include the directory in your `$fpath`, for example by adding in `~/.zshrc`:
|
|
|
|
fpath=(path/to/zsh-completions/src $fpath)
|
|
|
|
* You may have to force rebuild `zcompdump`:
|
|
|
|
rm -f ~/.zcompdump; compinit
|
|
|
|
### Contributing
|
|
|
|
Contributions are welcome, see [CONTRIBUTING](https://github.com/zsh-users/zsh-completions/blob/master/CONTRIBUTING.md).
|
|
|
|
|
|
## License
|
|
Completions use the Zsh license, unless explicitly mentioned in the file header.
|
|
See [LICENSE](https://github.com/zsh-users/zsh-completions/blob/master/LICENSE) for more information.
|