GNU bug report logs -
#25776
24.5; `imenu--generic-function' is not internal
Previous Next
Reported by: Drew Adams <drew.adams <at> oracle.com>
Date: Fri, 17 Feb 2017 17:02:02 UTC
Severity: wishlist
Tags: wontfix
Found in version 24.5
Done: Lars Ingebrigtsen <larsi <at> gnus.org>
Bug is archived. No further changes may be made.
To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 25776 in the body.
You can then email your comments to 25776 AT debbugs.gnu.org in the normal way.
Toggle the display of automated, internal messages from the tracker.
Report forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#25776
; Package
emacs
.
(Fri, 17 Feb 2017 17:02:02 GMT)
Full text and
rfc822 format available.
Acknowledgement sent
to
Drew Adams <drew.adams <at> oracle.com>
:
New bug report received and forwarded. Copy sent to
bug-gnu-emacs <at> gnu.org
.
(Fri, 17 Feb 2017 17:02:02 GMT)
Full text and
rfc822 format available.
Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):
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=/c/usr --host=i686-pc-mingw32'
Information forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#25776
; Package
emacs
.
(Fri, 26 Jul 2019 12:51:02 GMT)
Full text and
rfc822 format available.
Message #8 received at 25776 <at> debbugs.gnu.org (full text, mbox):
Drew Adams <drew.adams <at> oracle.com> 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
Added tag(s) wontfix.
Request was from
Lars Ingebrigtsen <larsi <at> gnus.org>
to
control <at> debbugs.gnu.org
.
(Fri, 26 Jul 2019 12:51:02 GMT)
Full text and
rfc822 format available.
bug closed, send any further explanations to
25776 <at> debbugs.gnu.org and Drew Adams <drew.adams <at> oracle.com>
Request was from
Lars Ingebrigtsen <larsi <at> gnus.org>
to
control <at> debbugs.gnu.org
.
(Fri, 26 Jul 2019 12:51:02 GMT)
Full text and
rfc822 format available.
bug archived.
Request was from
Debbugs Internal Request <help-debbugs <at> gnu.org>
to
internal_control <at> debbugs.gnu.org
.
(Sat, 24 Aug 2019 11:24:09 GMT)
Full text and
rfc822 format available.
This bug report was last modified 4 years and 247 days ago.
Previous Next
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997,2003 nCipher Corporation Ltd,
1994-97 Ian Jackson.