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: Sat, 18 May 2013 11:11:21 +0300 Message-ID: <83ppwor9li.fsf@gnu.org> References: Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1368864724 26648 80.91.229.3 (18 May 2013 08:12:04 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 18 May 2013 08:12:04 +0000 (UTC) Cc: emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat May 18 10:12:03 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 1UdcFF-0003m7-Ms for ged-emacs-devel@m.gmane.org; Sat, 18 May 2013 10:12:01 +0200 Original-Received: from localhost ([::1]:44368 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UdcFE-0001UD-F4 for ged-emacs-devel@m.gmane.org; Sat, 18 May 2013 04:12:00 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:54756) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UdcF8-0001U3-39 for emacs-devel@gnu.org; Sat, 18 May 2013 04:11:58 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UdcF1-0006u9-3G for emacs-devel@gnu.org; Sat, 18 May 2013 04:11:54 -0400 Original-Received: from mtaout22.012.net.il ([80.179.55.172]:44032) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UdcF0-0006tw-RX for emacs-devel@gnu.org; Sat, 18 May 2013 04:11:47 -0400 Original-Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0MMZ00D00IM63S00@a-mtaout22.012.net.il> for emacs-devel@gnu.org; Sat, 18 May 2013 11:11:36 +0300 (IDT) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MMZ00C3UIRCWCA0@a-mtaout22.012.net.il>; Sat, 18 May 2013 11:11:36 +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.172 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:159658 Archived-At: > From: Stefan Monnier > Date: Fri, 17 May 2013 17:28:30 -0400 > > Could we find some other name for this function? You are welcome to suggest any name you like. The only semi-important consideration I had in mind was not to have too long a name, so as not to require reformatting of too many lines in Makefile.in files. > Either we treat it as some "internal auxiliary" function used to build > Emacs, in which case it should have a more discreet name, maybe starting > with "internal-" or some such thingy that makes it clear noone else will > want to use it. Experience shows that calling a function 'internal-something' tends to attract a certain kind of Emacs users to that function, where a more "innocent" name would normally leave it under the radar... > "Produce the real file name for FILE" isn't sufficiently descriptive > to decide when it's buggy and when it's not. That's unfair: the doc string does explain what this function does. You quoted only the first line of the doc string.