[Pkg-zsh-devel] Installing zsh completion files

Frank Terbeck ft at bewatermyfriend.org
Wed Jul 24 13:48:41 UTC 2013

Felipe Sateler wrote:
> While zsh provides great completion functions for many programs,
> sometimes a better one is crafted by the program authors. Where should
> a program install the completion file? It seems to me that
> /u/s/zsh/vendor-completions is the correct place, but I wanted to
> confirm that.

For other debian packages that is precisely the intended location to
install additional completion functions. The two directories
`vendor-completions' and `vendor-functions' are located very early in
$fpath, so that anything in them overrides any function of the same
name, that zsh may ship.

The directories are located after /usr/local/share/zsh/site-functions,
so that system administrators still have the option to override any
function shipped by a package.

> The specific case I'm thinking of now is systemd, where zsh already
> provides a completion file but systemd upstream provides a more
> complete and up to date one.

It would be useful if upstream would consider syncing their completion
with the one zsh ships; zsh developers are always happy about new and
updated completions. If they have any questions about the subject,
mailing zsh-workers at zsh.org is the right place to do it (no need to be
subscribed, just ask to be Cc:ed).

Regards, Frank

In protocol design, perfection has been reached not when there is
nothing left to add, but when there is nothing left to take away.
                                                  -- RFC 1925

More information about the Pkg-zsh-devel mailing list