From 00f18f29de1b03364eb4eff1f625bc7df936d607 Mon Sep 17 00:00:00 2001 From: Daniel Shahaf Date: Fri, 22 Jul 2016 06:25:23 +0000 Subject: users/21779: Clarify documentation of the ':a' word modifier. --- ChangeLog | 3 +++ Doc/Zsh/expn.yo | 9 ++++++--- 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/ChangeLog b/ChangeLog index f7ca7697c..5446378ce 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,8 @@ 2016-07-22 Daniel Shahaf + * users/21779: Doc/Zsh/expn.yo: Clarify documentation of the + ':a' word modifier. + * 38890: Completion/Zsh/Function/_add-zle-hook-widget, Completion/Zsh/Function/_add-zsh-hook: _add-zle-hook-widget: New completion. 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 -- cgit 1.4.1