zsh-workers
 help / color / mirror / Atom feed
* Question to maintainers of third-party packages that install zsh completions
@ 2021-04-01 23:11 Daniel Shahaf
  2021-04-02  6:00 ` Stephane Chazelas
  2021-04-02 11:56 ` Frank Terbeck
  0 siblings, 2 replies; 4+ messages in thread
From: Daniel Shahaf @ 2021-04-01 23:11 UTC (permalink / raw)
  To: zsh-workers

Where would you expect the answer to "How does one install third-party
zsh completions in such a way that zsh will pick them up automatically?"
to be found?  I'd like to make sure the documentation has this
information where people who look for it will find it.

Cheers,

Daniel


^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: Question to maintainers of third-party packages that install zsh completions
  2021-04-01 23:11 Question to maintainers of third-party packages that install zsh completions Daniel Shahaf
@ 2021-04-02  6:00 ` Stephane Chazelas
  2021-04-22 17:13   ` Marlon Richert
  2021-04-02 11:56 ` Frank Terbeck
  1 sibling, 1 reply; 4+ messages in thread
From: Stephane Chazelas @ 2021-04-02  6:00 UTC (permalink / raw)
  To: Daniel Shahaf; +Cc: zsh-workers

2021-04-01 23:11:28 +0000, Daniel Shahaf:
> Where would you expect the answer to "How does one install third-party
> zsh completions in such a way that zsh will pick them up automatically?"
> to be found?  I'd like to make sure the documentation has this
> information where people who look for it will find it.
[...]

On the subject, see also
https://unix.stackexchange.com/questions/607809/where-should-i-install-the-zsh-completion-file-as-a-package-maintainer

-- 
Stephane


^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: Question to maintainers of third-party packages that install zsh completions
  2021-04-01 23:11 Question to maintainers of third-party packages that install zsh completions Daniel Shahaf
  2021-04-02  6:00 ` Stephane Chazelas
@ 2021-04-02 11:56 ` Frank Terbeck
  1 sibling, 0 replies; 4+ messages in thread
From: Frank Terbeck @ 2021-04-02 11:56 UTC (permalink / raw)
  To: Daniel Shahaf; +Cc: zsh-workers

Hi,

Daniel Shahaf wrote:
> Where would you expect the answer to "How does one install third-party
> zsh completions in such a way that zsh will pick them up automatically?"
> to be found?  I'd like to make sure the documentation has this
> information where people who look for it will find it.

Tough question to answer in full generality.  Depends on the kind of in-
stallation you're interested in, too. Debian's vendor package, for exam-
ple, has the following convention¹:

[..snip..]
Load-path for functions from other packages
-------------------------------------------

In respsonse to #620452, the  zsh-binary from Debian's zsh package star-
ted to provide two entries to $fpath (the search path for loadable func-
tions) for other packages to drop function files into:

  - /usr/share/zsh/vendor-completions for functions  that add functiona-
    lity to zsh's function based completion system (compsys)

  - /usr/share/zsh/vendor-functions for all other functions

If you  maintain another Debian package  that wants to add  functions to
zsh's function load-path, please use  the those conventions when instal-
ling function files.
[..snap..]

This  was done  to keep  ‘/usr/local/share/zsh/site-functions’ available
for purely  local additions to  the load-path.  Debian does not  put the
‘site-functions’ directory  into ‘/usr’ (sans /local),  because the non-
local part of ‘/usr’ is meant to be managed by Debian's package system.

Not all vendors do this, of course. But it neatly keeps package and site
local installation separate.


Still, however, the ‘site-functions’ directory is always the first entry
in the load-path list, based on all compile-time options. So, for purely
local function installation, this may be good enough:

  zsh -f -c 'print ${fpath[1]}'

Vendors may have additional requirements  when it comes to their package
system.


Regards, Frank

¹ https://salsa.debian.org/debian/zsh/-/blob/debian/debian/README.Debian


^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: Question to maintainers of third-party packages that install zsh completions
  2021-04-02  6:00 ` Stephane Chazelas
@ 2021-04-22 17:13   ` Marlon Richert
  0 siblings, 0 replies; 4+ messages in thread
From: Marlon Richert @ 2021-04-22 17:13 UTC (permalink / raw)
  To: Daniel Shahaf; +Cc: Zsh hackers list, Stephane Chazelas

[-- Attachment #1: Type: text/plain, Size: 852 bytes --]

On 2 Apr 2021, at 09:00, Stephane Chazelas <stephane@chazelas.org> wrote:
> 2021-04-01 23:11:28 +0000, Daniel Shahaf:
>> Where would you expect the answer to "How does one install third-party
>> zsh completions in such a way that zsh will pick them up automatically?"
>> to be found?  I'd like to make sure the documentation has this
>> information where people who look for it will find it.
> 
> On the subject, see also
> https://unix.stackexchange.com/questions/607809/where-should-i-install-the-zsh-completion-file-as-a-package-maintainer

See also https://stackoverflow.com/questions/67136714/how-to-properly-call-compinit-and-bashcompinit-in-zsh <https://stackoverflow.com/questions/67136714/how-to-properly-call-compinit-and-bashcompinit-in-zsh>

…and let me know if you think I should change anything about my answer there. :)


[-- Attachment #2: Type: text/html, Size: 1568 bytes --]

^ permalink raw reply	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2021-04-22 17:14 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-04-01 23:11 Question to maintainers of third-party packages that install zsh completions Daniel Shahaf
2021-04-02  6:00 ` Stephane Chazelas
2021-04-22 17:13   ` Marlon Richert
2021-04-02 11:56 ` Frank Terbeck

zsh-workers

This inbox may be cloned and mirrored by anyone:

	git clone --mirror http://inbox.vuxu.org/zsh-workers

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V1 zsh-workers zsh-workers/ http://inbox.vuxu.org/zsh-workers \
		zsh-workers@zsh.org
	public-inbox-index zsh-workers

Example config snippet for mirrors.
Newsgroup available over NNTP:
	nntp://inbox.vuxu.org/vuxu.archive.zsh.workers


code repositories for the project(s) associated with this inbox:

	https://git.vuxu.org/mirror/zsh/

AGPL code for this site: git clone https://public-inbox.org/public-inbox.git