From unknown Thu Sep 11 13:39:56 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#9274 <9274@debbugs.gnu.org> To: bug#9274 <9274@debbugs.gnu.org> Subject: Status: 24.0.50; doc string of `normal-top-level-add-subdirs-to-load-path' Reply-To: bug#9274 <9274@debbugs.gnu.org> Date: Thu, 11 Sep 2025 20:39:56 +0000 retitle 9274 24.0.50; doc string of `normal-top-level-add-subdirs-to-load-p= ath' reassign 9274 emacs submitter 9274 "Drew Adams" severity 9274 minor thanks From debbugs-submit-bounces@debbugs.gnu.org Tue Aug 09 18:27:15 2011 Received: (at submit) by debbugs.gnu.org; 9 Aug 2011 22:27:15 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QqulW-0005KZ-KE for submit@debbugs.gnu.org; Tue, 09 Aug 2011 18:27:15 -0400 Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QqulT-0005KS-Tt for submit@debbugs.gnu.org; Tue, 09 Aug 2011 18:27:13 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QqukI-0006F9-1E for submit@debbugs.gnu.org; Tue, 09 Aug 2011 18:26:01 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-2.7 required=5.0 tests=BAYES_00,RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 Received: from lists.gnu.org ([140.186.70.17]:36526) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QqukH-0006F1-7r for submit@debbugs.gnu.org; Tue, 09 Aug 2011 18:25:57 -0400 Received: from eggs.gnu.org ([140.186.70.92]:57036) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QqukD-0004WZ-CX for bug-gnu-emacs@gnu.org; Tue, 09 Aug 2011 18:25:57 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Qquk8-0006DI-Qi for bug-gnu-emacs@gnu.org; Tue, 09 Aug 2011 18:25:53 -0400 Received: from acsinet15.oracle.com ([141.146.126.227]:37672) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qquk8-0006CD-8d for bug-gnu-emacs@gnu.org; Tue, 09 Aug 2011 18:25:48 -0400 Received: from rtcsinet22.oracle.com (rtcsinet22.oracle.com [66.248.204.30]) by acsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p79MPf6U004709 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Tue, 9 Aug 2011 22:25:43 GMT Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by rtcsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p79MPeUg019874 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Tue, 9 Aug 2011 22:25:41 GMT Received: from abhmt105.oracle.com (abhmt105.oracle.com [141.146.116.57]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p79MPZVu020493 for ; Tue, 9 Aug 2011 17:25:35 -0500 Received: from dradamslap1 (/10.159.42.25) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 09 Aug 2011 15:25:35 -0700 From: "Drew Adams" To: Subject: 24.0.50; doc string of `normal-top-level-add-subdirs-to-load-path' Date: Tue, 9 Aug 2011 15:25:34 -0700 Message-ID: <0813B49C7EAA4AD484E4DF3043F59003@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcxW40GWQI/VtwKgTAyu67Qpws3n7A== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 X-Source-IP: rtcsinet22.oracle.com [66.248.204.30] X-CT-RefId: str=0001.0A090202.4E41B3E8.0009,ss=1,re=0.000,fgs=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.17 X-Spam-Score: -6.2 (------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.2 (------) The doc string should say `default-directory', not "current directory". The latter is confusing because imprecise - it should almost never be used. The former lets users use `C-h v' to find out exactly which directory is meant. FWIW - Sheesh, what a horrible function name! Should have been called something like `add-subdirs-to-load-path'. Or, if you're worried about calling out which subdirs in the name, `add-normal-subdirs-to-load-path' or some such. (But "normal" is not a great choice for naming the subdirs in question, in any case.) But "normal-top-level" means nothing here. In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600) of 2011-08-08 on 3249CTO Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.5) --no-opt' From debbugs-submit-bounces@debbugs.gnu.org Tue Aug 09 19:17:38 2011 Received: (at 9274) by debbugs.gnu.org; 9 Aug 2011 23:17:38 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QqvYH-0006TU-4e for submit@debbugs.gnu.org; Tue, 09 Aug 2011 19:17:37 -0400 Received: from mail-fx0-f44.google.com ([209.85.161.44]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QqvYE-0006TN-Ts for 9274@debbugs.gnu.org; Tue, 09 Aug 2011 19:17:36 -0400 Received: by fxe6 with SMTP id 6so510683fxe.3 for <9274@debbugs.gnu.org>; Tue, 09 Aug 2011 16:16:23 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=from:to:cc:subject:in-reply-to:references:user-agent:date :message-id:mime-version:content-type:content-transfer-encoding; bh=amBE+3fmpqieDd+G7Pg+cfWMMjFQL6opYgJTROZUQL8=; b=dWYnJb8UiQ3Za6MdB+0tEvyP01IMW8qK+0IgcHk2lCj6A3NwGD8/XPUL+70prx4Pck sM1CRVAEqZpB8aSt0NJOLoUqa3Bix9XeiTZ5YPrxJFl2wbXtZl7W0eofpnLtb7TSiFCa l/9O9dLBoicvoTRML2zYZpQh/8l0N4rTknFcU= Received: by 10.223.10.15 with SMTP id n15mr1272357fan.95.1312931783709; Tue, 09 Aug 2011 16:16:23 -0700 (PDT) Received: from localhost (176.119.broadband10.iol.cz [90.177.119.176]) by mx.google.com with ESMTPS id d5sm296482fak.40.2011.08.09.16.16.21 (version=TLSv1/SSLv3 cipher=OTHER); Tue, 09 Aug 2011 16:16:22 -0700 (PDT) From: =?utf-8?B?xaB0xJtww6FuIE7Em21lYw==?= To: "Drew Adams" Subject: Re: bug#9274: 24.0.50; doc string of `normal-top-level-add-subdirs-to-load-path' In-Reply-To: <0813B49C7EAA4AD484E4DF3043F59003@us.oracle.com> (Drew Adams's message of "Tue, 9 Aug 2011 15:25:34 -0700") References: <0813B49C7EAA4AD484E4DF3043F59003@us.oracle.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) Date: Wed, 10 Aug 2011 01:11:38 +0200 Message-ID: <874o1qb2ol.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -3.7 (---) X-Debbugs-Envelope-To: 9274 Cc: 9274@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -3.7 (---) On Wed, 10 Aug 2011 00:25:34 +0200 Drew Adams wrote: > FWIW - Sheesh, what a horrible function name! Indeed. > Should have been called something like `add-subdirs-to-load-path'. This is one of the fortunate cases when it's never too late to add a more reasonable (and discoverable -- the function isn't even documented in the manual AFAIK) alias. --=20 =C5=A0t=C4=9Bp=C3=A1n From debbugs-submit-bounces@debbugs.gnu.org Wed Aug 10 12:08:48 2011 Received: (at 9274) by debbugs.gnu.org; 10 Aug 2011 16:08:48 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QrBKq-0007fv-5G for submit@debbugs.gnu.org; Wed, 10 Aug 2011 12:08:48 -0400 Received: from mail-out.m-online.net ([212.18.0.10]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QrBKn-0007fo-HI for 9274@debbugs.gnu.org; Wed, 10 Aug 2011 12:08:46 -0400 Received: from frontend1.mail.m-online.net (frontend1.mail.intern.m-online.net [192.168.8.180]) by mail-out.m-online.net (Postfix) with ESMTP id 72A4F186DED0; Wed, 10 Aug 2011 18:07:30 +0200 (CEST) Received: from localhost (dynscan1.mnet-online.de [192.168.8.164]) by mail.m-online.net (Postfix) with ESMTP id 5962B1C0009D; Wed, 10 Aug 2011 18:07:30 +0200 (CEST) X-Virus-Scanned: amavisd-new at mnet-online.de Received: from mail.mnet-online.de ([192.168.8.180]) by localhost (dynscan1.mail.m-online.net [192.168.8.164]) (amavisd-new, port 10024) with ESMTP id yNN+hdfF3ZHb; Wed, 10 Aug 2011 18:02:30 +0200 (CEST) Received: from igel.home (ppp-88-217-105-8.dynamic.mnet-online.de [88.217.105.8]) by mail.mnet-online.de (Postfix) with ESMTP; Wed, 10 Aug 2011 18:02:30 +0200 (CEST) Received: by igel.home (Postfix, from userid 501) id 6E4C1CA293; Wed, 10 Aug 2011 18:02:29 +0200 (CEST) From: Andreas Schwab To: "Drew Adams" Subject: Re: bug#9274: 24.0.50; doc string of `normal-top-level-add-subdirs-to-load-path' References: <0813B49C7EAA4AD484E4DF3043F59003@us.oracle.com> X-Yow: My forehead feels like a PACKAGE of moist CRANBERRIES in a remote FRENCH OUTPOST!! Date: Wed, 10 Aug 2011 18:02:29 +0200 In-Reply-To: <0813B49C7EAA4AD484E4DF3043F59003@us.oracle.com> (Drew Adams's message of "Tue, 9 Aug 2011 15:25:34 -0700") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.3 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Spam-Score: -2.6 (--) X-Debbugs-Envelope-To: 9274 Cc: 9274@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) "Drew Adams" writes: > FWIW - Sheesh, what a horrible function name! Should have been called > something like `add-subdirs-to-load-path'. It's a part of normal-top-level, so it's the perfect name. Andreas. -- Andreas Schwab, schwab@linux-m68k.org GPG Key fingerprint = 58CA 54C7 6D53 942B 1756 01D3 44D5 214B 8276 4ED5 "And now for something completely different." From debbugs-submit-bounces@debbugs.gnu.org Wed Aug 10 12:36:14 2011 Received: (at 9274) by debbugs.gnu.org; 10 Aug 2011 16:36:14 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QrBlO-0008KA-BL for submit@debbugs.gnu.org; Wed, 10 Aug 2011 12:36:14 -0400 Received: from acsinet15.oracle.com ([141.146.126.227]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QrBlL-0008K1-OR for 9274@debbugs.gnu.org; Wed, 10 Aug 2011 12:36:12 -0400 Received: from rtcsinet21.oracle.com (rtcsinet21.oracle.com [66.248.204.29]) by acsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p7AGYsNs003273 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 10 Aug 2011 16:34:56 GMT Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by rtcsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p7AGYr5V024332 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 10 Aug 2011 16:34:54 GMT Received: from abhmt107.oracle.com (abhmt107.oracle.com [141.146.116.59]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p7AGYlOB030438; Wed, 10 Aug 2011 11:34:47 -0500 Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 10 Aug 2011 09:34:47 -0700 From: "Drew Adams" To: "'Andreas Schwab'" References: <0813B49C7EAA4AD484E4DF3043F59003@us.oracle.com> Subject: RE: bug#9274: 24.0.50; doc string of `normal-top-level-add-subdirs-to-load-path' Date: Wed, 10 Aug 2011 09:34:46 -0700 Message-ID: <8491EA0175394F3E9696DB721F377469@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 In-Reply-To: Thread-Index: AcxXd6GNbpDs2aONQWyVqaXVEk8uLwAAHiTQ X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 X-Source-IP: rtcsinet21.oracle.com [66.248.204.29] X-CT-RefId: str=0001.0A090209.4E42B330.0192,ss=1,re=0.000,fgs=0 X-Spam-Score: -4.2 (----) X-Debbugs-Envelope-To: 9274 Cc: 9274@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.2 (----) > > FWIW - Sheesh, what a horrible function name! Should have > > been called something like `add-subdirs-to-load-path'. > > It's a part of normal-top-level, so it's the perfect name. Whatever. It's part of GNU Emacs Lisp too, so maybe an even more perfect name would be `gnu-emacs-lisp-normal-top-level-add-subdirs-to-load-path'? I'm no expert on this, but "normal-top-level" itself seems like a lousy name (what's normal about it? what are the non-normal top levels?) BTW, `normal-top-level' rambles on for 5788 chars, including long, expository comments trying to help make some sense of what's going on - a nearly sure sign that things could be better organized. And it is invoked from Lisp in only this one sexp: (setq top-level (normal-top-level)) - nowhere else. And I do not see `normal-top-level-add-subdirs-to-load-path' (or `normal-top-level-add-to-load-path', for that matter) used anywhere in the body of `normal-top-level'. In fact, it is called from _no_ Lisp code whatsoever. In what sense then is `n-t-l-a-s-t-l-p' (whew!) "part of normal-top-level" (an internal function that doesn't even have a doc string, BTW)? You will notice that the description (doc string) of `n-t-l-a-s-t-l-p' says nothing about normal-top-level or even top-level. If its description is accurate, then the function name should reflect it, saying what the function does. If `normal-top-level' is so important to this function, then surely it should be mentioned in its description. Surely that would be more important than adding this unexplained term to the name. Anyway, this discussion is peripheral to this bug. The name is monstrous, but it is unlikely that it will ever be changed... From debbugs-submit-bounces@debbugs.gnu.org Wed Aug 10 15:03:36 2011 Received: (at 9274) by debbugs.gnu.org; 10 Aug 2011 19:03:36 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QrE3z-0003Oq-AX for submit@debbugs.gnu.org; Wed, 10 Aug 2011 15:03:36 -0400 Received: from mail-fx0-f44.google.com ([209.85.161.44]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QrE3w-0003Oj-UA for 9274@debbugs.gnu.org; Wed, 10 Aug 2011 15:03:34 -0400 Received: by fxe6 with SMTP id 6so1176261fxe.3 for <9274@debbugs.gnu.org>; Wed, 10 Aug 2011 12:02:17 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=from:to:cc:subject:in-reply-to:references:user-agent:date :message-id:mime-version:content-type:content-transfer-encoding; bh=bYYXsknDYPBRPFMuIW1BY3kC+H/fwkTuAHPf514bdSM=; b=leF9MZeOxEAetGq9f4m5Ely1kVFom3qdtvmVnyeQFd5B0HpLECsmfkfCnHlqL07OI1 4fHrxOopSEmV4QtnMWmUZEVP9e3i3QbE1xmxCtZ9lnCcmek/yMB7CBUZMPANqfpq9nzM AXSlFml6A6jix8z1+FZXsuXTdQe2HyC+n+Jwk= Received: by 10.223.149.199 with SMTP id u7mr4514653fav.129.1313002937026; Wed, 10 Aug 2011 12:02:17 -0700 (PDT) Received: from localhost (176.119.broadband10.iol.cz [90.177.119.176]) by mx.google.com with ESMTPS id h2sm226681fai.1.2011.08.10.12.02.14 (version=TLSv1/SSLv3 cipher=OTHER); Wed, 10 Aug 2011 12:02:15 -0700 (PDT) From: =?utf-8?B?xaB0xJtww6FuIE7Em21lYw==?= To: "Drew Adams" Subject: Re: bug#9274: 24.0.50; doc string of `normal-top-level-add-subdirs-to-load-path' In-Reply-To: <8491EA0175394F3E9696DB721F377469@us.oracle.com> (Drew Adams's message of "Wed, 10 Aug 2011 09:34:46 -0700") References: <0813B49C7EAA4AD484E4DF3043F59003@us.oracle.com> <8491EA0175394F3E9696DB721F377469@us.oracle.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) Date: Wed, 10 Aug 2011 20:57:25 +0200 Message-ID: <87vcu59jsa.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -3.7 (---) X-Debbugs-Envelope-To: 9274 Cc: 'Andreas Schwab' , 9274@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -3.7 (---) On Wed, 10 Aug 2011 18:34:46 +0200 Drew Adams wrote: > Anyway, this discussion is peripheral to this bug. The name is monstrous= , but > it is unlikely that it will ever be changed... Why is that unlikely? What's wrong with adding a more sensible alias, optionally declaring the old name obsolete? Standard procedure, it's done every now and then. The question is whether the maintainers acknowledge the problem or not -- I for one don't use the function even though I've known about it for some time, but I know people who do use it, and the docstring suggests general usefulness. One more argument for "it's a lousy name". --=20 =C5=A0t=C4=9Bp=C3=A1n From debbugs-submit-bounces@debbugs.gnu.org Wed Aug 10 17:39:23 2011 Received: (at 9274) by debbugs.gnu.org; 10 Aug 2011 21:39:23 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QrGUl-0007vm-2f for submit@debbugs.gnu.org; Wed, 10 Aug 2011 17:39:23 -0400 Received: from acsinet15.oracle.com ([141.146.126.227]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QrGUj-0007ve-GX for 9274@debbugs.gnu.org; Wed, 10 Aug 2011 17:39:22 -0400 Received: from rtcsinet22.oracle.com (rtcsinet22.oracle.com [66.248.204.30]) by acsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p7ALc2lP005572 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 10 Aug 2011 21:38:04 GMT Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by rtcsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p7ALc0Iu006662 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 10 Aug 2011 21:38:01 GMT Received: from abhmt108.oracle.com (abhmt108.oracle.com [141.146.116.60]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p7ALbtuT032719; Wed, 10 Aug 2011 16:37:55 -0500 Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 10 Aug 2011 14:37:54 -0700 From: "Drew Adams" To: "=?iso-8859-2?Q?'=A9tep=E1n_Nemec'?=" References: <0813B49C7EAA4AD484E4DF3043F59003@us.oracle.com><8491EA0175394F3E9696DB721F377469@us.oracle.com> <87vcu59jsa.fsf@gmail.com> Subject: RE: bug#9274: 24.0.50; doc string of `normal-top-level-add-subdirs-to-load-path' Date: Wed, 10 Aug 2011 14:37:54 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-2" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <87vcu59jsa.fsf@gmail.com> Thread-Index: AcxXkAsZgcQ6Sz2IQMKmOIcWZDFiCQAFJ6Zw X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 X-Source-IP: rtcsinet22.oracle.com [66.248.204.30] X-CT-RefId: str=0001.0A020205.4E42FA3C.0092,ss=1,re=0.000,fgs=0 X-Spam-Score: -4.2 (----) X-Debbugs-Envelope-To: 9274 Cc: 'Andreas Schwab' , 9274@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.2 (----) > > Anyway, this discussion is peripheral to this bug. The > > name is monstrous, but it is unlikely that it will ever be changed... > > Why is that unlikely? I can't really speak to whether it is unlikely or why it would be - I misspoke. I should have said that my _guess_ is that it is unlikely. And that guess is not based on any good reason I know of why it should not be changed. On the contrary... > What's wrong with adding a more sensible alias, > optionally declaring the old name obsolete? > Standard procedure, it's done every now and then. Sounds good to me. And yes, it is. > The question is whether the maintainers acknowledge the problem > or not -- I for one don't use the function even though I've known > about it for some time, but I know people who do use it, and the > docstring suggests general usefulness. One more argument for > "it's a lousy name". Same here - on all accounts: Yes, that is the question. I haven't used it. But I see it called out in recommendations here and there (e.g. the wiki) to users. From debbugs-submit-bounces@debbugs.gnu.org Sat Aug 20 15:32:25 2011 Received: (at 9274) by debbugs.gnu.org; 20 Aug 2011 19:32:25 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QurHL-0000eS-7P for submit@debbugs.gnu.org; Sat, 20 Aug 2011 15:32:24 -0400 Received: from vm-emlprdomr-04.its.yale.edu ([130.132.50.145]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QurHH-0000eI-5u for 9274@debbugs.gnu.org; Sat, 20 Aug 2011 15:32:20 -0400 Received: from furball ([64.134.100.139]) (authenticated bits=0) by vm-emlprdomr-04.its.yale.edu (8.14.4/8.14.4) with ESMTP id p7KJU5Cp002706 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NOT); Sat, 20 Aug 2011 15:30:06 -0400 From: Chong Yidong To: "Drew Adams" Subject: Re: bug#9274: 24.0.50; doc string of `normal-top-level-add-subdirs-to-load-path' References: <0813B49C7EAA4AD484E4DF3043F59003@us.oracle.com> Date: Sat, 20 Aug 2011 15:30:04 -0400 In-Reply-To: <0813B49C7EAA4AD484E4DF3043F59003@us.oracle.com> (Drew Adams's message of "Tue, 9 Aug 2011 15:25:34 -0700") Message-ID: <87sjovhoeb.fsf@stupidchicken.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Scanned-By: MIMEDefang 2.71 on 130.132.50.145 X-Spam-Score: -2.6 (--) X-Debbugs-Envelope-To: 9274 Cc: 9274@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) "Drew Adams" writes: > The doc string should say `default-directory', not "current directory". > The latter is confusing because imprecise - it should almost never be > used. The former lets users use `C-h v' to find out exactly which > directory is meant. Fixed, thanks. From debbugs-submit-bounces@debbugs.gnu.org Sat Aug 20 15:33:22 2011 Received: (at control) by debbugs.gnu.org; 20 Aug 2011 19:33:22 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QurII-0000g9-3E for submit@debbugs.gnu.org; Sat, 20 Aug 2011 15:33:22 -0400 Received: from vm-emlprdomr-05.its.yale.edu ([130.132.50.146]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QurIF-0000g1-Oe for control@debbugs.gnu.org; Sat, 20 Aug 2011 15:33:20 -0400 Received: from furball ([64.134.100.139]) (authenticated bits=0) by vm-emlprdomr-05.its.yale.edu (8.14.4/8.14.4) with ESMTP id p7KJV62a012490 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NOT) for ; Sat, 20 Aug 2011 15:31:07 -0400 From: Chong Yidong To: control@debbugs.gnu.org Subject: close 9274 Date: Sat, 20 Aug 2011 15:31:06 -0400 Message-ID: <87zkj3283p.fsf@stupidchicken.com> MIME-Version: 1.0 Content-Type: text/plain X-Scanned-By: MIMEDefang 2.71 on 130.132.50.146 X-Spam-Score: -2.6 (--) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) close 9274 thanks From unknown Thu Sep 11 13:39:56 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 18 Sep 2011 11:24:05 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator