From debbugs-submit-bounces@debbugs.gnu.org Fri Feb 17 12:01:20 2017 Received: (at submit) by debbugs.gnu.org; 17 Feb 2017 17:01:20 +0000 Received: from localhost ([127.0.0.1]:43766 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1celuK-0006Cs-AC for submit@debbugs.gnu.org; Fri, 17 Feb 2017 12:01:20 -0500 Received: from eggs.gnu.org ([208.118.235.92]:43487) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1celuI-0006Cg-FT for submit@debbugs.gnu.org; Fri, 17 Feb 2017 12:01:19 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1celuC-0002ff-HA for submit@debbugs.gnu.org; Fri, 17 Feb 2017 12:01:13 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:44944) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1celuC-0002fN-ET for submit@debbugs.gnu.org; Fri, 17 Feb 2017 12:01:12 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:34448) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1celuB-0003Tg-7c for bug-gnu-emacs@gnu.org; Fri, 17 Feb 2017 12:01:12 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1celu6-0002ZA-E4 for bug-gnu-emacs@gnu.org; Fri, 17 Feb 2017 12:01:11 -0500 Received: from aserp1040.oracle.com ([141.146.126.69]:28499) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1celu6-0002XQ-5D for bug-gnu-emacs@gnu.org; Fri, 17 Feb 2017 12:01:06 -0500 Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id v1HH12Or007470 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 17 Feb 2017 17:01:03 GMT Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userv0021.oracle.com (8.14.4/8.14.4) with ESMTP id v1HH12B8026918 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 17 Feb 2017 17:01:02 GMT Received: from abhmp0019.oracle.com (abhmp0019.oracle.com [141.146.116.25]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id v1HH110B024049 for ; Fri, 17 Feb 2017 17:01:01 GMT MIME-Version: 1.0 Message-ID: Date: Fri, 17 Feb 2017 09:01:00 -0800 (PST) From: Drew Adams To: bug-gnu-emacs@gnu.org Subject: 24.5; `imenu--generic-function' is not internal X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 12.0.6753.5000 (x86)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0021.oracle.com [156.151.31.71] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) It is a relatively recent mania to name functions and variables using `--' to indicate that they are internal. This function should not be so named. It is referred to in several doc strings. We do not (should not) name functions specially just because we want to indicate that users probably do not want to redefine them or that they are especially likely to have their implementations changed in the future. We don't name `forward-char' `forward--char' just because it is (truly) "internal". Users exploring the doc strings of `imenu.el' encounter this function name throughout. Particularly if it is important to refer to the function when documenting user-visible behavior, it makes little sense to call it out as something "internal". It is enough to add a comment in the code to suggest that users probably do not want to mess with its definition or that its implementation is especially likely to be changed in the future. Each of these doc strings refers to `imenu--generic-function': imenu-generic-skip-comments-and-strings imenu-generic-expression imenu-syntax-alist imenu-default-create-index-function imenu-case-fold-search In GNU Emacs 24.5.1 (i686-pc-mingw32) of 2015-04-11 on LEG570 Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --prefix=3D/c/usr --host=3Di686-pc-mingw32' From debbugs-submit-bounces@debbugs.gnu.org Fri Jul 26 08:50:17 2019 Received: (at 25776) by debbugs.gnu.org; 26 Jul 2019 12:50:17 +0000 Received: from localhost ([127.0.0.1]:41098 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hqzft-0003nt-CA for submit@debbugs.gnu.org; Fri, 26 Jul 2019 08:50:17 -0400 Received: from quimby.gnus.org ([80.91.231.51]:33040) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hqzfr-0003ni-HE for 25776@debbugs.gnu.org; Fri, 26 Jul 2019 08:50:15 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hqzfm-0006TT-PK; Fri, 26 Jul 2019 14:50:13 +0200 From: Lars Ingebrigtsen To: Drew Adams Subject: Re: bug#25776: 24.5; `imenu--generic-function' is not internal References: Date: Fri, 26 Jul 2019 14:50:10 +0200 In-Reply-To: (Drew Adams's message of "Fri, 17 Feb 2017 09:01:00 -0800 (PST)") Message-ID: <8736itm03h.fsf@mouse.gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Drew Adams writes: > It is a relatively recent mania to name functions and variables using > `--' to indicate that they are internal. This function should not be so > named. It is referred to in several doc strings. We [...] Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 25776 Cc: 25776@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Drew Adams writes: > It is a relatively recent mania to name functions and variables using > `--' to indicate that they are internal. This function should not be so > named. It is referred to in several doc strings. We do not (should > not) name functions specially just because we want to indicate that > users probably do not want to redefine them or that they are especially > likely to have their implementations changed in the future. We don't > name `forward-char' `forward--char' just because it is (truly) > "internal". That's not the meaning of -- - it's that other packages probably shouldn't rely on them. Everything should rely on `forward-char', so that's not a very good comparison. It is slightly eccentric to name a function that's that user-forward as `imenu--generic-function' is with two dashes... My preference would be to not do that, but we do do similar things here and there with some filter functions and the like that are meant to be values for variables that can be tweaked, so I don't think this is so abnormal as all that. So I'm closing this bug report. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Fri Jul 26 08:50:20 2019 Received: (at control) by debbugs.gnu.org; 26 Jul 2019 12:50:20 +0000 Received: from localhost ([127.0.0.1]:41101 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hqzfw-0003oA-Kg for submit@debbugs.gnu.org; Fri, 26 Jul 2019 08:50:20 -0400 Received: from quimby.gnus.org ([80.91.231.51]:33054) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hqzfv-0003o2-0T for control@debbugs.gnu.org; Fri, 26 Jul 2019 08:50:19 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hqzfs-0006TZ-Dp for control@debbugs.gnu.org; Fri, 26 Jul 2019 14:50:18 +0200 Date: Fri, 26 Jul 2019 14:50:16 +0200 Message-Id: <871rydm03b.fsf@mouse.gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #25776 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: tags 25776 wontfix close 25776 quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) tags 25776 wontfix close 25776 quit From unknown Tue Aug 19 02:52:36 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sat, 24 Aug 2019 11:24:09 +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