about summary refs log tree commit diff
path: root/Doc/Zsh/compsys.yo
diff options
context:
space:
mode:
authordana <dana@dana.is>2018-10-10 18:50:40 -0500
committerdana <dana@dana.is>2018-10-10 18:50:40 -0500
commit995a56cf0103b14d9741af40f96f6a741e82b469 (patch)
tree7f85fdfce8cc22af96b0afc8ce04d0901b7f088c /Doc/Zsh/compsys.yo
parentf19266cf99f8a194add752a764bd5ea13ed215b2 (diff)
downloadzsh-995a56cf0103b14d9741af40f96f6a741e82b469.tar.gz
zsh-995a56cf0103b14d9741af40f96f6a741e82b469.tar.xz
zsh-995a56cf0103b14d9741af40f96f6a741e82b469.zip
43602: Clarify behaviour of `compdef -p`
Diffstat (limited to 'Doc/Zsh/compsys.yo')
-rw-r--r--Doc/Zsh/compsys.yo6
1 files changed, 5 insertions, 1 deletions
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