tink/zsh-completions
4
0
Fork 0
mirror of https://github.com/zsh-users/zsh-completions.git synced 2026-11-10 18:17:33 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity
Additional completion definitions for Zsh.
2,465 Commits 1 Branch 40 Tags 7.1 MiB
Shell 94.7%
Python 4.3%
Emacs Lisp 1%
af1db4e3c9
Go to file
hetaaaaaaaansh af1db4e3c9 cmake: suggest -D arguments required by --find-package 
--find-package (cmake's legacy pkg-config-like mode) silently requires
-DNAME=, -DLANGUAGE=, -DCOMPILER_ID= and -DMODE= to be set, or cmake
aborts with a chain of 'argument not specified' errors (see
Modules/CMakeFindPackageMode.cmake). The completion script gave no
hint that these were needed.

Detect --find-package on the command line and, when present, offer
NAME/LANGUAGE/COMPILER_ID/MODE alongside the usual -D property names,
plus value completion for each (e.g. LANGUAGE -> C/CXX/Fortran,
MODE -> EXIST/COMPILE/LINK).

Fixes #593
2026-08-16 18:08:32 +05:30
.github
src cmake: suggest -D arguments required by --find-package 2026-08-16 18:08:32 +05:30
.editorconfig
.gitignore
CONTRIBUTING.md
LICENSE
README.md
zsh-completions-howto.org docs: clarify _regex_arguments example explanation (#1106) 2026-05-21 12:12:35 -05:00
zsh-completions.plugin.zsh

README.md

zsh-completions GitHub release GitHub contributors IRC Gitter

Additional completion definitions for Zsh.

This project 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
Fedora / CentOS / RHEL / Scientific Linux zsh-completions OBS repository
OpenSUSE / SLE zsh-completions OBS repository
Arch Linux / Manjaro / Antergos / Hyperbola zsh-completions, zsh-completions-git
Gentoo / Funtoo app-shells/zsh-completions
NixOS zsh-completions
Void Linux zsh-completions
Slackware Slackbuilds
macOS homebrew, MacPorts
NetBSD pkgsrc
FreeBSD shells/zsh-completions

Using zsh frameworks

antigen

Add antigen bundle zsh-users/zsh-completions to your ~/.zshrc.

oh-my-zsh

To avoid issues with redundant .zcompdump cache generation (see #603), do not load zsh-completions as a standard plugin.
Instead, follow this optimized approach:

  1. Clone the repository into your custom plugins directory:
git clone https://github.com/zsh-users/zsh-completions.git \
  ${ZSH_CUSTOM:-${ZSH:-~/.oh-my-zsh}/custom}/plugins/zsh-completions
  1. Update your ~/.zshrc configuration before sourcing oh-my-zsh:
fpath+=${ZSH_CUSTOM:-${ZSH:-~/.oh-my-zsh}/custom}/plugins/zsh-completions/src
autoload -U compinit && compinit
source "$ZSH/oh-my-zsh.sh"

This prevents compinit from being called twice and significantly improves shell startup time.

zinit

Add zinit light zsh-users/zsh-completions to your ~/.zshrc.

Manual installation

  • Clone the repository:
git clone https://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.

License

Completions use the Zsh license, unless explicitly mentioned in the file header.
See LICENSE for more information.