GNU bug report logs - #8285
24.0.50; doc of `imenu-generic-expression' and `imenu--generic-function'

Previous Next

Full log

Message #17 received at 8285 <at> debbugs.gnu.org (full text, mbox):

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 8285 <at> debbugs.gnu.org
Subject: Re: bug#8285: 24.0.50; doc of `imenu-generic-expression' and
 `imenu--generic-function'
Date: Thu, 26 Aug 2021 17:49:49 +0200

"Drew Adams" <drew.adams <at> oracle.com> writes:

> 1. In the doc string of `imenu--generic-function', these terms are
> completely undefined and unexplained: POSITION-MARKER, INDEX-NAME,
> FUNCTION, ARGUMENTS, INDEX-POSITION, and INDEX-ALIST.  Please
> define/explain these undefined terms.

Eli answered this one...

> 2. Seems a bit odd that this internal-only function (judging by its
> name, which contains `--') has all of the important doc for
> `imenu-generic-expression'.  In the past, the latter's doc string
> described the format.  Now the format is described (only) in the doc
> string of an internal function.  This state, which seems inappropriate,
> was introduced in Emacs 22.

This was fixed in:

commit b7ccbdc2e39ff834a03a7f30516b71cd98e84a44
Author:     Chong Yidong <cyd <at> gnu.org>
AuthorDate: Sun Aug 5 22:14:54 2012 +0800

So I'm closing this bug report.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.