From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: reveal-filename Date: Tue, 21 May 2013 19:19:24 +0300 Message-ID: <83li78uwz7.fsf@gnu.org> References: <83ppwor9li.fsf@gnu.org> <83mwrpujr4.fsf@gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1369153190 5636 80.91.229.3 (21 May 2013 16:19:50 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 21 May 2013 16:19:50 +0000 (UTC) Cc: emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue May 21 18:19:47 2013 Return-path: Envelope-to: ged-emacs-devel@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 1UepHs-0007EK-KO for ged-emacs-devel@m.gmane.org; Tue, 21 May 2013 18:19:44 +0200 Original-Received: from localhost ([::1]:55762 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UepHs-0007pF-1R for ged-emacs-devel@m.gmane.org; Tue, 21 May 2013 12:19:44 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:46853) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UepHl-0007p7-4q for emacs-devel@gnu.org; Tue, 21 May 2013 12:19:41 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UepHg-0003BM-AI for emacs-devel@gnu.org; Tue, 21 May 2013 12:19:37 -0400 Original-Received: from mtaout20.012.net.il ([80.179.55.166]:45226) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UepHf-0003Ax-SU for emacs-devel@gnu.org; Tue, 21 May 2013 12:19:32 -0400 Original-Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0MN500800P8HWD00@a-mtaout20.012.net.il> for emacs-devel@gnu.org; Tue, 21 May 2013 19:19:30 +0300 (IDT) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MN5007NWPCI2NZ0@a-mtaout20.012.net.il>; Tue, 21 May 2013 19:19:30 +0300 (IDT) In-reply-to: X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: Solaris 10 X-Received-From: 80.179.55.166 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:159710 Archived-At: > From: Stefan Monnier > Cc: emacs-devel@gnu.org > Date: Tue, 21 May 2013 01:26:27 -0400 > > > The description that's already there is all there is to tell: > > "Produce the real file name for FILE. > > On systems other than MS-Windows, just returns FILE. > > On MS-Windows, converts /d/foo/bar form of file names > > passed by MSYS Make into d:/foo/bar that Emacs can grok. > > This function is called from lisp/Makefile." > > What did you find missing from this description? > > Looks very ad-hoc to me. But that's what the function does, no less, no more. And yes, it's ad-hoc, because it simply works around an MSYS bug (I tried to find other solutions, but failed). > My guess is that the "cleaner" description that > could correspond to it might be something along the lines of "accepts > a file name in the format commonly used by other programs on the system, > and turns it into an equivalent form that works within Emacs". When the function is extended to do that, it would make sense to change the doc string along these lines. For now, saying that would be simply incorrect.