about summary refs log tree commit diff
diff options
context:
space:
mode:
-rw-r--r--ChangeLog4
-rw-r--r--Doc/Zsh/expn.yo10
2 files changed, 11 insertions, 3 deletions
diff --git a/ChangeLog b/ChangeLog
index f9dc8594a..61886b2b6 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2016-07-26  Peter Stephenson  <p.stephenson@samsung.com>
+
+	* 38945: Doc/Zsh/expn.yo: additional notes on :a behaviour.
+
 2016-07-24  Oliver Kiddle  <opk@zsh.org>
 
 	* 38943: Completion/Unix/Command/_texinfo: update options
diff --git a/Doc/Zsh/expn.yo b/Doc/Zsh/expn.yo
index 0ed320bb4..ca4b94f5e 100644
--- a/Doc/Zsh/expn.yo
+++ b/Doc/Zsh/expn.yo
@@ -222,9 +222,13 @@ Turn a file name into an absolute path:  prepends the current directory,
 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.
+This transformation is agnostic about what is in the filesystem, i.e. is
+on the logical, not the physical directory.  It takes place in the same
+manner as when changing directories when neither of the options
+tt(CHASE_DOTS) or tt(CHASE_LINKS) is set.  For example,
+`tt(/before/here/../after)' is always transformed to
+`tt(/before/after)', regardless of whether `tt(/before/here)' 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