From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 19084 invoked by alias); 17 Jul 2016 14:59:39 -0000 Mailing-List: contact zsh-users-help@zsh.org; run by ezmlm Precedence: bulk X-No-Archive: yes List-Id: Zsh Users List List-Post: List-Help: X-Seq: 21777 Received: (qmail 17829 invoked from network); 17 Jul 2016 14:59:39 -0000 X-Qmail-Scanner-Diagnostics: from hermes.apache.org by f.primenet.com.au (envelope-from , 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.13499 secs); 17 Jul 2016 14:59:39 -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: Sun, 17 Jul 2016 14:59:31 +0000 From: Daniel Shahaf To: Peter Stephenson Cc: zsh-users@zsh.org Subject: [PATCH] improve :A docs (was: Re: Next release (5.3)) Message-ID: <20160717145931.GA4859@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> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline In-Reply-To: <20160713103233.14bfd05a__26126.9551389434$1468402471$gmane$org@pwslap01u.europe.root.pri> User-Agent: Mutt/1.5.23 (2014-03-12) Peter Stephenson wrote on Wed, Jul 13, 2016 at 10:32:33 +0100: > No one can actually point to a specific error case being fixed by the > change. > > I suggest we focus on improving the documentation of :A, as the current > ".." behaviour is one thing it *is* clear about so it's a little > bizarre to change *that*, to point out problems, and decide if we > actually want a new qualifier, which I think would be fairly > uncontroversial even if it's not frequently used. diff --git a/Doc/Zsh/expn.yo b/Doc/Zsh/expn.yo index c6e7b6f..c5f3c00 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