From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#17073: 24.3.50; file-symlink-p doesn't return t as described in the doc Date: Tue, 25 Mar 2014 18:10:12 +0200 Message-ID: <83vbv2z2cb.fsf@gnu.org> References: <877g7k1zij.fsf@web.de> <83vbv41ce8.fsf@gnu.org> <83r45r1r08.fsf@gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1395764444 19724 80.91.229.3 (25 Mar 2014 16:20:44 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 25 Mar 2014 16:20:44 +0000 (UTC) Cc: michael_heerdegen@web.de, 17073@debbugs.gnu.org To: Juanma Barranquero Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Mar 25 17:20:53 2014 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1WSU5t-0001ZB-3O for geb-bug-gnu-emacs@m.gmane.org; Tue, 25 Mar 2014 17:20:53 +0100 Original-Received: from localhost ([::1]:42755 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WSU5s-0001GF-JR for geb-bug-gnu-emacs@m.gmane.org; Tue, 25 Mar 2014 12:20:52 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:34045) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WSU17-0006nZ-7j for bug-gnu-emacs@gnu.org; Tue, 25 Mar 2014 12:20:50 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WSTwN-0005oK-3J for bug-gnu-emacs@gnu.org; Tue, 25 Mar 2014 12:15:49 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:48340) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WSTwM-0005oD-TW for bug-gnu-emacs@gnu.org; Tue, 25 Mar 2014 12:11:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1WSTwM-0005Qa-9M for bug-gnu-emacs@gnu.org; Tue, 25 Mar 2014 12:11:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 25 Mar 2014 16:11:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 17073 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 17073-submit@debbugs.gnu.org id=B17073.139576382620815 (code B ref 17073); Tue, 25 Mar 2014 16:11:02 +0000 Original-Received: (at 17073) by debbugs.gnu.org; 25 Mar 2014 16:10:26 +0000 Original-Received: from localhost ([127.0.0.1]:49522 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WSTvj-0005Pb-JD for submit@debbugs.gnu.org; Tue, 25 Mar 2014 12:10:24 -0400 Original-Received: from mtaout25.012.net.il ([80.179.55.181]:45857) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WSTvg-0005PM-No for 17073@debbugs.gnu.org; Tue, 25 Mar 2014 12:10:21 -0400 Original-Received: from conversion-daemon.mtaout25.012.net.il by mtaout25.012.net.il (HyperSendmail v2007.08) id <0N3000B0023IAP00@mtaout25.012.net.il> for 17073@debbugs.gnu.org; Tue, 25 Mar 2014 18:09:03 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout25.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0N30004PV273K570@mtaout25.012.net.il>; Tue, 25 Mar 2014 18:09:03 +0200 (IST) In-reply-to: X-012-Sender: halo1@inter.net.il X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:87363 Archived-At: > From: Juanma Barranquero > Date: Mon, 24 Mar 2014 18:01:04 +0100 > Cc: Michael Heerdegen , 17073@debbugs.gnu.org > > On Mon, Mar 24, 2014 at 5:49 PM, Eli Zaretskii wrote: > > > Not sure which part needs love. Could you perhaps point out the > > unclear parts? > > First, this function recursively follows symbolic > links at all levels of parent directories. > > On one hand, though I suppose "First, this function recursively > follows..." means "This function, first of all, recursively > follows...", my instinct is that it is the start of an enumeration, so > I expect a "Second, it ...". > > On the other hand, you've explained that this: > > If the file FILENAME is a symbolic link, the `file-symlink-p' > function returns the (non-recursive) link target as a string. > > talks about the 'file (a.k.a. "basename") part of the file name', and this > > First, this function recursively follows symbolic > links at all levels of parent directories. > > talks about the 'leading directories part'. Well, I don't find that clear. I tried to clarify and improve the documentation in revision 116859 on the emacs-24 branch, please take a look.