about summary refs log tree commit diff
path: root/Doc
diff options
context:
space:
mode:
authorDaniel Shahaf <d.s@daniel.shahaf.name>2016-07-22 06:25:23 +0000
committerDaniel Shahaf <d.s@daniel.shahaf.name>2016-07-22 06:25:43 +0000
commit00f18f29de1b03364eb4eff1f625bc7df936d607 (patch)
treeaec9f75609519ebece723287aa2968ef81d1c0fc /Doc
parent5c7d92bd9c811404abe9784bdc18d129e5fbbdeb (diff)
downloadzsh-00f18f29de1b03364eb4eff1f625bc7df936d607.tar.gz
zsh-00f18f29de1b03364eb4eff1f625bc7df936d607.tar.xz
zsh-00f18f29de1b03364eb4eff1f625bc7df936d607.zip
users/21779: Clarify documentation of the ':a' word modifier.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/Zsh/expn.yo9
1 files changed, 6 insertions, 3 deletions
diff --git a/Doc/Zsh/expn.yo b/Doc/Zsh/expn.yo
index c5f3c00d3..0ed320bb4 100644
--- a/Doc/Zsh/expn.yo
+++ b/Doc/Zsh/expn.yo
@@ -219,9 +219,12 @@ noted.
 startitem()
 item(tt(a))(
 Turn a file name into an absolute path:  prepends the current directory,
-if necessary, and resolves any use of `tt(..)' and `tt(.)' in the path.
-Note that the transformation takes place even if the file or any
-intervening directories do not exist.
+if necessary; remove `tt(.)' path segments; and remove `tt(..)' path segments
+and the segments that immediately precede them.
+
+This transformation is agnostic of the filesystem: `tt(/foo/bar/../baz)' shall
+always be transformed to `tt(/foo/baz)', regardless of whether `tt(/foo)'
+exists or what kind of object (dir, file, symlink, etc.) it is.
 )
 item(tt(A))(
 Turn a file name into an absolute path as the `tt(a)' modifier does, and