From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#25776: 24.5; `imenu--generic-function' is not internal Date: Fri, 17 Feb 2017 09:01:00 -0800 (PST) Message-ID: NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1487351241 16071 195.159.176.226 (17 Feb 2017 17:07:21 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 17 Feb 2017 17:07:21 +0000 (UTC) To: 25776@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Feb 17 18:07:14 2017 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cem01-0003Z5-KX for geb-bug-gnu-emacs@m.gmane.org; Fri, 17 Feb 2017 18:07:14 +0100 Original-Received: from localhost ([::1]:54915 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cem07-0008Px-6g for geb-bug-gnu-emacs@m.gmane.org; Fri, 17 Feb 2017 12:07:19 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:34771) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1celv5-0004H8-KW for bug-gnu-emacs@gnu.org; Fri, 17 Feb 2017 12:02:08 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1celv0-0003Ay-O9 for bug-gnu-emacs@gnu.org; Fri, 17 Feb 2017 12:02:07 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:45567) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1celv0-0003Au-LD for bug-gnu-emacs@gnu.org; Fri, 17 Feb 2017 12:02:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1celv0-0006Do-8u for bug-gnu-emacs@gnu.org; Fri, 17 Feb 2017 12:02:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 17 Feb 2017 17:02:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 25776 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.148735088023866 (code B ref -1); Fri, 17 Feb 2017 17:02:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 17 Feb 2017 17:01:20 +0000 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 12.0.6753.5000 (x86)] 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-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:129456 Archived-At: 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'