From 14b5fae69ebde623105b18adaa6079d2a3e6dbd5 Mon Sep 17 00:00:00 2001 From: Peter Stephenson Date: Fri, 19 May 2017 11:16:10 +0100 Subject: users/22707: Document extra use of accept-exact-dirs It allows completion after magically appearing directories that dont't show up in the parent directory by supressing searching of the parent directory if the subdirectory is directly found to exist. --- ChangeLog | 6 ++++++ Doc/Zsh/compsys.yo | 13 ++++++++++--- 2 files changed, 16 insertions(+), 3 deletions(-) diff --git a/ChangeLog b/ChangeLog index b5060864a..b050093a3 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +2017-05-19 Peter Stephenson + + * users/22707: Doc/Zsh/compsys.yo: Document use of + accept-exact-dirs for allowing completion after "magic" + directories. + 2017-05-18 Peter Stephenson * 41113 (tweaked): Src/hashtable,c, Src/hist.c, Src/zsh.h: Save diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo index 2a112ed15..ec1809fa1 100644 --- a/Doc/Zsh/compsys.yo +++ b/Doc/Zsh/compsys.yo @@ -1158,6 +1158,12 @@ directory is accepted without any attempt to complete it further. Hence, in the given example, the path tt(/usr/bin/) is accepted immediately and completion tried in that directory. +This style is also useful when completing after directories that +magically appear when referenced, such as ZFS tt(.zfs) directories +or NetApp tt(.snapshot) directories. When the style is set the +shell does not check for the existence of the directory within the +parent directory. + If you wish to inhibit this behaviour entirely, set the tt(path-completion) style (see below) to `false'. ) @@ -1428,9 +1434,10 @@ or colons in var(dir) should be quoted with a backslash to be treated literally. This can be useful on systems that support special file systems whose -top-level pathnames can not be listed or generated with glob patterns. -It can also be used for directories for which one does not have read -permission. +top-level pathnames can not be listed or generated with glob patterns +(but see tt(accept-exact-dirs) for a more general way of dealing +with this problem). It can also be used for directories for which one +does not have read permission. The pattern form can be used to add a certain `magic' entry to all directories on a particular file system. -- cgit 1.4.1