about summary refs log tree commit diff
path: root/Doc/Zsh/expn.yo
diff options
context:
space:
mode:
authorDaniel Shahaf <d.s@daniel.shahaf.name>2016-07-17 12:32:13 +0000
committerDaniel Shahaf <d.s@daniel.shahaf.name>2016-07-20 07:00:29 +0000
commit6e966f691d588932cde025083fa91575f661119a (patch)
treec710f0e33d9bef5281a9c317b317606b6c0121cb /Doc/Zsh/expn.yo
parentfff00804002735067aef56e09e36074235077e20 (diff)
downloadzsh-6e966f691d588932cde025083fa91575f661119a.tar.gz
zsh-6e966f691d588932cde025083fa91575f661119a.tar.xz
zsh-6e966f691d588932cde025083fa91575f661119a.zip
users/21777: Clarify documentation of the ':A' word modifier.
Diffstat (limited to 'Doc/Zsh/expn.yo')
-rw-r--r--Doc/Zsh/expn.yo13
1 files changed, 9 insertions, 4 deletions
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