about summary refs log tree commit diff
diff options
context:
space:
mode:
-rw-r--r--ChangeLog5
-rw-r--r--Doc/Zsh/expn.yo13
2 files changed, 14 insertions, 4 deletions
diff --git a/ChangeLog b/ChangeLog
index 0d7c8328e..bdcfd6f6b 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2016-07-20  Daniel Shahaf  <d.s@daniel.shahaf.name>
+
+	* users/21777: Doc/Zsh/expn.yo: Clarify documentation of the
+	':A' word modifier.
+
 2016-07-19  Jun-ichi Takimoto <takimoto-j@kba.biglobe.ne.jp>
 
 	* 38862: Src/Modules/datetime.c: strptime(3) requires _XOPEN_SOURCE
diff --git a/Doc/Zsh/expn.yo b/Doc/Zsh/expn.yo
index c6e7b6f16..c5f3c00d3 100644
--- a/Doc/Zsh/expn.yo
+++ b/Doc/Zsh/expn.yo
@@ -224,10 +224,15 @@ Note that the transformation takes place even if the file or any
 intervening directories do not exist.
 )
 item(tt(A))(
-As `tt(a)', but also resolve use of symbolic links where possible.
-Note that resolution of `tt(..)' occurs em(before) resolution of symbolic
-links.  This call is equivalent to tt(a) unless your system has the
-tt(realpath) system call (modern systems do).
+Turn a file name into an absolute path as the `tt(a)' modifier does, and
+em(then) pass the result through the tt(realpath+LPAR()3+RPAR()) library
+function to resolve symbolic links.
+
+Note: on systems that do not have a tt(realpath+LPAR()3+RPAR()) library
+function, symbolic links are not resolved, so on those systems `tt(a)' and
+`tt(A)' are equivalent.
+
+Note: tt(foo:A) and tt(realpath+LPAR()foo+RPAR()) are different on some inputs.
 )
 item(tt(c))(
 Resolve a command name into an absolute path by searching the command