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#15159: 24.3.50; doc of `file-relative-name' Date: Thu, 22 Aug 2013 17:43:43 +0300 Message-ID: <83d2p5kcps.fsf@gnu.org> References: <88607a9f-9b87-45b3-b661-99970acc0c97@default> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1377182659 3457 80.91.229.3 (22 Aug 2013 14:44:19 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 22 Aug 2013 14:44:19 +0000 (UTC) Cc: 15159@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Aug 22 16:44:20 2013 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 1VCW7W-0006uv-16 for geb-bug-gnu-emacs@m.gmane.org; Thu, 22 Aug 2013 16:44:18 +0200 Original-Received: from localhost ([::1]:60218 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VCW7V-0007To-Jh for geb-bug-gnu-emacs@m.gmane.org; Thu, 22 Aug 2013 10:44:17 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54134) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VCW7M-0007TT-QB for bug-gnu-emacs@gnu.org; Thu, 22 Aug 2013 10:44:15 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VCW7H-0002JQ-Es for bug-gnu-emacs@gnu.org; Thu, 22 Aug 2013 10:44:08 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:53474) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VCW7H-0002JK-Bv for bug-gnu-emacs@gnu.org; Thu, 22 Aug 2013 10:44:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1VCW7G-0000lp-U0 for bug-gnu-emacs@gnu.org; Thu, 22 Aug 2013 10:44:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 22 Aug 2013 14:44:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 15159 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 15159-submit@debbugs.gnu.org id=B15159.13771826302936 (code B ref 15159); Thu, 22 Aug 2013 14:44:02 +0000 Original-Received: (at 15159) by debbugs.gnu.org; 22 Aug 2013 14:43:50 +0000 Original-Received: from localhost ([127.0.0.1]:47790 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VCW74-0000lI-Ee for submit@debbugs.gnu.org; Thu, 22 Aug 2013 10:43:50 -0400 Original-Received: from mtaout20.012.net.il ([80.179.55.166]:42527) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VCW70-0000l6-2p for 15159@debbugs.gnu.org; Thu, 22 Aug 2013 10:43:47 -0400 Original-Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0MRX00300SSCTC00@a-mtaout20.012.net.il> for 15159@debbugs.gnu.org; Thu, 22 Aug 2013 17:43:41 +0300 (IDT) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MRX0032HSWTD2B0@a-mtaout20.012.net.il>; Thu, 22 Aug 2013 17:43:41 +0300 (IDT) In-reply-to: <88607a9f-9b87-45b3-b661-99970acc0c97@default> 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:77605 Archived-At: > Date: Wed, 21 Aug 2013 20:42:19 -0700 (PDT) > From: Drew Adams > > The doc says nothing about whether arg FILENAME needs to be absolute or > relative, and in fact it can be either. It is clear enough what the > function does if it is absolute, but the doc should say explicitly what > it does for a relative FILENAME, namely, it expands the FILENAME in the > `default-directory' of the current buffer. Sorry, but I see nothing unclear in this doc string: (file-relative-name FILENAME &optional DIRECTORY) Convert FILENAME to be relative to DIRECTORY (default: `default-directory'). This function returns a relative file name which is equivalent to FILENAME when used with that default directory as the default. "Convert FILENAME to be relative to DIRECTORY" is accurate and unequivocal. The fact that relative file names are treated as relative to the current buffer's default-directory is what Emacs does with _every_ file name in _any_ function; if users don't know this basic fact, they will have problems all over the place.