From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#8285: 24.0.50; doc of `imenu-generic-expression' and `imenu--generic-function' Date: Fri, 18 Mar 2011 09:09:47 -0700 Message-ID: <6CAA58C0292943D68651BC3DB49A62C0@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1300466240 13965 80.91.229.12 (18 Mar 2011 16:37:20 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 18 Mar 2011 16:37:20 +0000 (UTC) To: 8285@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Mar 18 17:37:12 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Q0cfm-0007VN-Ps for geb-bug-gnu-emacs@m.gmane.org; Fri, 18 Mar 2011 17:37:11 +0100 Original-Received: from localhost ([127.0.0.1]:47796 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Q0cfm-0003V0-55 for geb-bug-gnu-emacs@m.gmane.org; Fri, 18 Mar 2011 12:37:10 -0400 Original-Received: from [140.186.70.92] (port=54221 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Q0cfe-0003Tw-QZ for bug-gnu-emacs@gnu.org; Fri, 18 Mar 2011 12:37:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Q0cfd-0003Tb-Mw for bug-gnu-emacs@gnu.org; Fri, 18 Mar 2011 12:37:02 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:33258) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Q0cfd-0003TQ-LE for bug-gnu-emacs@gnu.org; Fri, 18 Mar 2011 12:37:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1Q0cGU-0002sT-88; Fri, 18 Mar 2011 12:11:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 18 Mar 2011 16:11:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 8285 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.130046460710956 (code B ref -1); Fri, 18 Mar 2011 16:11:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 18 Mar 2011 16:10:07 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Q0cFZ-0002qf-SJ for submit@debbugs.gnu.org; Fri, 18 Mar 2011 12:10:06 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Q0cFX-0002q5-T3 for submit@debbugs.gnu.org; Fri, 18 Mar 2011 12:10:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Q0cFR-00060l-U9 for submit@debbugs.gnu.org; Fri, 18 Mar 2011 12:09:58 -0400 Original-Received: from lists.gnu.org ([199.232.76.165]:53937) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Q0cFR-00060d-Q3 for submit@debbugs.gnu.org; Fri, 18 Mar 2011 12:09:57 -0400 Original-Received: from [140.186.70.92] (port=56781 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Q0cFQ-00009k-Ek for bug-gnu-emacs@gnu.org; Fri, 18 Mar 2011 12:09:57 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Q0cFN-0005zN-7p for bug-gnu-emacs@gnu.org; Fri, 18 Mar 2011 12:09:56 -0400 Original-Received: from rcsinet10.oracle.com ([148.87.113.121]:41080) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Q0cFN-0005yt-2d for bug-gnu-emacs@gnu.org; Fri, 18 Mar 2011 12:09:53 -0400 Original-Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id p2IG9mc4020434 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Fri, 18 Mar 2011 16:09:50 GMT Original-Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id p2IG9m9i013358 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Fri, 18 Mar 2011 16:09:48 GMT Original-Received: from abhmt004.oracle.com (abhmt004.oracle.com [141.146.116.13]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p2IG9lKN026825 for ; Fri, 18 Mar 2011 11:09:47 -0500 Original-Received: from dradamslap1 (/10.159.39.7) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 18 Mar 2011 09:09:47 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: Acvlhub14h8AcWc4T++my/J0wlsoOA== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5994 X-Source-IP: acsmt356.oracle.com [141.146.40.156] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090205.4D8383CC.0148,ss=1,fgs=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Fri, 18 Mar 2011 12:11:02 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.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: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:45144 Archived-At: 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. If you don't understand the problem, change these names to UU, VV, WW, XX, YY, and ZZ, and see if you understand the doc. 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. In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600) of 2011-03-07 on 3249CTO Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.5) --no-opt --cflags -Ic:/imagesupport/include'