From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <zsh-users-return-21779-mason-zsh=primenet.com.au@zsh.org>
Received: (qmail 14738 invoked by alias); 20 Jul 2016 07:01:17 -0000
Mailing-List: contact zsh-users-help@zsh.org; run by ezmlm
Precedence: bulk
X-No-Archive: yes
List-Id: Zsh Users List <zsh-users.zsh.org>
List-Post: <mailto:zsh-users@zsh.org>
List-Help: <mailto:zsh-users-help@zsh.org>
X-Seq: 21779
Received: (qmail 15395 invoked from network); 20 Jul 2016 07:01:16 -0000
X-Qmail-Scanner-Diagnostics: from hermes.apache.org by f.primenet.com.au (envelope-from <danielsh@apache.org>, uid 7791) with qmail-scanner-2.11 
 (clamdscan: 0.99.2/21882. spamassassin: 3.4.1.  
 Clear:RC:0(140.211.11.3):SA:0(-1.3/5.0):. 
 Processed in 0.185785 secs); 20 Jul 2016 07:01:16 -0000
X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on f.primenet.com.au
X-Spam-Level: 
X-Spam-Status: No, score=-1.3 required=5.0 tests=HEADER_FROM_DIFFERENT_DOMAINS,
	RP_MATCHES_RCVD autolearn=unavailable autolearn_force=no version=3.4.1
X-Envelope-From: danielsh@apache.org
X-Qmail-Scanner-Mime-Attachments: |
X-Qmail-Scanner-Zip-Files: |
Received-SPF: none (ns1.primenet.com.au: domain at apache.org does not designate permitted sender hosts)
Date: Wed, 20 Jul 2016 06:54:33 +0000
From: Daniel Shahaf <d.s@daniel.shahaf.name>
To: Peter Stephenson <p.stephenson@samsung.com>
Cc: zsh-users@zsh.org
Subject: Re: [PATCH] improve :A docs (was: Re: Next release (5.3))
Message-ID: <20160720065433.GA18653@tarsus.local2>
References: <20160712075849.GG1537@isis.sigpipe.cz>
 <160712094017.ZM17395@torch.brasslantern.com>
 <37271.1468354988@hydra.kiddle.eu>
 <20160713103233.14bfd05a__26126.9551389434$1468402471$gmane$org@pwslap01u.europe.root.pri>
 <20160717145931.GA4859__10178.6871244714$1468767679$gmane$org@tarsus.local2>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
In-Reply-To: <20160717145931.GA4859__10178.6871244714$1468767679$gmane$org@tarsus.local2>
User-Agent: Mutt/1.5.23 (2014-03-12)

Daniel Shahaf wrote on Sun, Jul 17, 2016 at 14:59:31 +0000:
> Peter Stephenson wrote on Wed, Jul 13, 2016 at 10:32:33 +0100:
> > I suggest we focus on improving the documentation of :A,

:a too.

diff --git a/Doc/Zsh/expn.yo b/Doc/Zsh/expn.yo
index c6e7b6f..7e78869 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))(
 As `tt(a)', but also resolve use of symbolic links where possible.