From 995a56cf0103b14d9741af40f96f6a741e82b469 Mon Sep 17 00:00:00 2001 From: dana Date: Wed, 10 Oct 2018 18:50:40 -0500 Subject: 43602: Clarify behaviour of `compdef -p` --- Doc/Zsh/compsys.yo | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) (limited to 'Doc/Zsh/compsys.yo') diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo index 65f596752..a5a9e5b5d 100644 --- a/Doc/Zsh/compsys.yo +++ b/Doc/Zsh/compsys.yo @@ -489,7 +489,11 @@ The parameter tt($_compskip) may be set by any function defined for a pattern context. If it is set to a value containing the substring `tt(patterns)' none of the pattern-functions will be called; if it is set to a value containing the substring `tt(all)', no other function -will be called. +will be called. Setting tt($_compskip) in this manner is of particular +utility when using the tt(-p) option, as otherwise the dispatcher will +move on to additional functions (likely the default one) after calling +the pattern-context one, which can mangle the display of completion +possibilities if not handled properly. The form with tt(-k) defines a widget with the same name as the var(function) that will be called for each of the var(key-sequence)s; this is like the -- cgit 1.4.1