summary refs log tree commit diff
path: root/Doc/Zsh
diff options
context:
space:
mode:
authorPeter Stephenson <pws@zsh.org>2017-05-19 11:16:10 +0100
committerPeter Stephenson <pws@zsh.org>2017-05-19 11:16:10 +0100
commit14b5fae69ebde623105b18adaa6079d2a3e6dbd5 (patch)
tree216f1d6bdb03c143b3582ad69f3cc85140269936 /Doc/Zsh
parent94014ff65bc2bdd752717792b156cdfcbc5b5c98 (diff)
downloadzsh-14b5fae69ebde623105b18adaa6079d2a3e6dbd5.tar.gz
zsh-14b5fae69ebde623105b18adaa6079d2a3e6dbd5.tar.xz
zsh-14b5fae69ebde623105b18adaa6079d2a3e6dbd5.zip
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.
Diffstat (limited to 'Doc/Zsh')
-rw-r--r--Doc/Zsh/compsys.yo13
1 files changed, 10 insertions, 3 deletions
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.