From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: owner@emacsbugs.donarmstrong.com (Emacs bug Tracking System) Newsgroups: gmane.emacs.bugs Subject: bug#4654: marked as done (23.1; Elisp manual doc of abbreviate-file-name) Date: Wed, 07 Oct 2009 10:30:15 +0000 Message-ID: References: <83ab03mrlo.fsf@gnu.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="----------=_1254911415-22552-0" X-Trace: ger.gmane.org 1254912462 1197 80.91.229.12 (7 Oct 2009 10:47:42 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 7 Oct 2009 10:47:42 +0000 (UTC) To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Oct 07 12:47:32 2009 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1MvU3N-0001qm-Az for geb-bug-gnu-emacs@m.gmane.org; Wed, 07 Oct 2009 12:47:29 +0200 Original-Received: from localhost ([127.0.0.1]:52978 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MvU3M-0004Jq-JH for geb-bug-gnu-emacs@m.gmane.org; Wed, 07 Oct 2009 06:47:28 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MvU3F-0004Ir-Pa for bug-gnu-emacs@gnu.org; Wed, 07 Oct 2009 06:47:21 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MvU3A-0004Fj-MO for bug-gnu-emacs@gnu.org; Wed, 07 Oct 2009 06:47:21 -0400 Original-Received: from [199.232.76.173] (port=58156 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MvU39-0004FS-TD for bug-gnu-emacs@gnu.org; Wed, 07 Oct 2009 06:47:16 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:54353) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MvU35-00034d-Ly; Wed, 07 Oct 2009 06:47:12 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n97Al9Ni025337; Wed, 7 Oct 2009 03:47:09 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n97AUFeJ022692; Wed, 7 Oct 2009 03:30:16 -0700 X-Mailer: MIME-tools 5.427 (Entity 5.427) X-Loop: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: closed 4654 X-Emacs-PR-Package: emacs X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:31759 Archived-At: This is a multi-part message in MIME format... ------------=_1254911415-22552-0 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=utf-8 Your message dated Wed, 07 Oct 2009 12:21:55 +0200 with message-id <83ab03mrlo.fsf@gnu.org> and subject line Re: bug#4654: 23.1; Elisp manual doc of abbreviate-file-na= me has caused the Emacs bug report #4654, regarding 23.1; Elisp manual doc of abbreviate-file-name to be marked as done. This means that you claim that the problem has been dealt with. If this is not the case it is now your responsibility to reopen the bug report if necessary, and/or fix the problem forthwith. (NB: If you are a system administrator and have no idea what this message is talking about, this may indicate a serious mail system misconfiguration somewhere. Please contact owner@emacsbugs.donarmstrong.com immediately.) --=20 4654: http://emacsbugs.donarmstrong.com/cgi-bin/bugreport.cgi?bug=3D4654 Emacs Bug Tracking System Contact owner@emacsbugs.donarmstrong.com with problems ------------=_1254911415-22552-0 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by emacsbugs.donarmstrong.com; 6 Oct 2009 17:54:02 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-2.4 required=4.0 tests=AWL,FOURLA autolearn=no version=3.2.5-bugs.debian.org_2005_01_02 Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n96Hs0aT010805 for ; Tue, 6 Oct 2009 10:54:01 -0700 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MvEEa-00025E-78 for bug-gnu-emacs@gnu.org; Tue, 06 Oct 2009 13:54:00 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MvEEV-0001ug-9p for bug-gnu-emacs@gnu.org; Tue, 06 Oct 2009 13:53:59 -0400 Received: from [199.232.76.173] (port=48319 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MvEEV-0001uK-5q for bug-gnu-emacs@gnu.org; Tue, 06 Oct 2009 13:53:55 -0400 Received: from acsinet12.oracle.com ([141.146.126.234]:25785) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MvEEU-0004Jo-JY for bug-gnu-emacs@gnu.org; Tue, 06 Oct 2009 13:53:54 -0400 Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by acsinet12.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n96Hp57o023910 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Tue, 6 Oct 2009 17:51:06 GMT Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by acsinet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n968ccxi014283 for ; Tue, 6 Oct 2009 17:54:39 GMT Received: from abhmt020.oracle.com by acsmt355.oracle.com with ESMTP id 20239367761254851628; Tue, 06 Oct 2009 10:53:48 -0700 Received: from dradamslap1 (/141.144.169.34) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 06 Oct 2009 10:53:48 -0700 From: "Drew Adams" To: Subject: 23.1; Elisp manual doc of abbreviate-file-name Date: Tue, 6 Oct 2009 10:54:09 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcpGrgFj3lL4ybh8TDu0xAfvOXYX+g== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 X-Source-IP: acsmt357.oracle.com [141.146.40.157] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090208.4ACB842D.01C8:SCFMA4539814,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) The doc string mentions this qualification, but the Elisp manual does not: " (unless the home directory is a root directory)". Please mention this in the manual also. Question: Why? What is the rationale for not substituting `~' when it is a root directory? If the reason is short to express, perhaps it should be included in the doc. Understanding the rationale helps one remember what the function does. In GNU Emacs 23.1.1 (i386-mingw-nt5.1.2600) of 2009-07-29 on SOFT-MJASON Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.4)' ------------=_1254911415-22552-0 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 4654-done) by emacsbugs.donarmstrong.com; 7 Oct 2009 10:24:05 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-4.8 required=4.0 tests=AWL,FOURLA,HAS_BUG_NUMBER autolearn=ham version=3.2.5-bugs.debian.org_2005_01_02 Received: from mtaout3.012.net.il (mtaout3.012.net.il [84.95.2.7]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n97AO2G4021692 for <4654-done@emacsbugs.donarmstrong.com>; Wed, 7 Oct 2009 03:24:04 -0700 Received: from conversion-daemon.i_mtaout3.012.net.il by i_mtaout3.012.net.il (HyperSendmail v2004.12) id <0KR5005003G5RM00@i_mtaout3.012.net.il> for 4654-done@emacsbugs.donarmstrong.com; Wed, 07 Oct 2009 12:23:55 +0200 (IST) Received: from HOME-C4E4A596F7 ([77.127.224.43]) by i_mtaout3.012.net.il (HyperSendmail v2004.12) with ESMTPA id <0KR500LQL3JUOSF0@i_mtaout3.012.net.il>; Wed, 07 Oct 2009 12:23:55 +0200 (IST) Date: Wed, 07 Oct 2009 12:21:55 +0200 From: Eli Zaretskii Subject: Re: bug#4654: 23.1; Elisp manual doc of abbreviate-file-name In-reply-to: <0F408BF94DA24CFCB960917D03E903BA@us.oracle.com> X-012-Sender: halo1@inter.net.il To: Drew Adams , 4654-done@emacsbugs.donarmstrong.com Cc: monnier@iro.umontreal.ca Reply-to: Eli Zaretskii Message-id: <83ab03mrlo.fsf@gnu.org> References: <2C5117E03B57417289F8B3E16B1B8B61@us.oracle.com> <0F408BF94DA24CFCB960917D03E903BA@us.oracle.com> > From: "Drew Adams" > Date: Wed, 7 Oct 2009 00:50:41 -0700 > Cc: 4654@emacsbugs.donarmstrong.com > > a. Always substituting `~' for the home dir is consistent; and it tells you > where the file is wrt the home dir. > > b. Substituting `~' for the home dir except when it is the root dir breaks > consistency; but it does tell you where the file is wrt root (in that one > exceptional case only - otherwise, it tells you where the file is wrt the home > dir). It also has the advantage of legacy: consistency with the past and > existing code. > > c. If we were to substitute `~' for the home dir except when that is the root > dir, on UNIX etc., but not substitute it for the home dir when that is the root > dir, on Windows, that would ensure that `~' substitution would always shorten > the file name. But that would introduce additional inconsistency. > > And in any case, substituting using `directory-abbrev-alist' does not guarantee > shortening at all. Nothing prevents such "abbreviation" from lengthening the > name. > > Overall, (a) is a better choice than (b) or (c) - unless the legacy > consideration has particular importance here for some reason (I don't think it > does). I hope no one is seriously suggesting to change the behavior of one of the oldest Emacs APIs... I fixed the manual. The description now says This function applies abbreviations from @code{directory-abbrev-alist} to its argument, and also substitutes @samp{~} for the user's home directory if the argument names a file in the home directory or one of its subdirectories. (If the home directory is a root directory, it is not replaced with @samp{~}, because this does not make the result shorter on many systems.) You can use it for directory names and for file names, because it recognizes abbreviations even as part of the name. I hope this is something everybody can live with. ------------=_1254911415-22552-0--