From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Nathan Trapuzzano Newsgroups: gmane.emacs.bugs Subject: bug#15848: 24.3.50; cperl-mode + which-function: Improve reporting (corner case) Date: Tue, 12 Nov 2013 14:41:30 -0500 Message-ID: <87txfhif11.fsf@nbtrap.com> References: <87d2m8pwts.fsf@gmail.com> <87d2m8bhk1.fsf@nbtrap.com> <87iow0quc6.fsf@gmail.com> <87bo1squ1q.fsf@gmail.com> <87ob5sw8zm.fsf@nbtrap.com> <87txfkp6si.fsf@gmail.com> <87d2m8w6bx.fsf@nbtrap.com> <87vbzz9zga.fsf@gmail.com> <877gcf43g5.fsf@nbtrap.com> <87eh6n2o0a.fsf@gmail.com> <87li0v2nkw.fsf@nbtrap.com> <877gcf2n0b.fsf@gmail.com> <871u2nrne5.fsf@nbtrap.com> <878uwukxaw.fsf@gmail.com> <877gcdemmh.fsf@nbtrap.com> <87r4alqzm2.fsf@gmail.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1384285351 18319 80.91.229.3 (12 Nov 2013 19:42:31 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 12 Nov 2013 19:42:31 +0000 (UTC) Cc: 15848@debbugs.gnu.org To: Jambunathan K Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Nov 12 20:42:33 2013 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1VgJqv-0001Np-Ku for geb-bug-gnu-emacs@m.gmane.org; Tue, 12 Nov 2013 20:42:22 +0100 Original-Received: from localhost ([::1]:44905 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VgJqv-0007tq-9M for geb-bug-gnu-emacs@m.gmane.org; Tue, 12 Nov 2013 14:42:21 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:49038) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VgJql-0007tR-I6 for bug-gnu-emacs@gnu.org; Tue, 12 Nov 2013 14:42:18 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VgJqe-0004k3-Jc for bug-gnu-emacs@gnu.org; Tue, 12 Nov 2013 14:42:11 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:35129) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VgJqc-0004jk-FF for bug-gnu-emacs@gnu.org; Tue, 12 Nov 2013 14:42:04 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1VgJqc-0002mt-0w for bug-gnu-emacs@gnu.org; Tue, 12 Nov 2013 14:42:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Nathan Trapuzzano Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 12 Nov 2013 19:42:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 15848 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 15848-submit@debbugs.gnu.org id=B15848.138428530110684 (code B ref 15848); Tue, 12 Nov 2013 19:42:01 +0000 Original-Received: (at 15848) by debbugs.gnu.org; 12 Nov 2013 19:41:41 +0000 Original-Received: from localhost ([127.0.0.1]:49148 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VgJqG-0002mF-Bw for submit@debbugs.gnu.org; Tue, 12 Nov 2013 14:41:40 -0500 Original-Received: from qproxy1-pub.mail.unifiedlayer.com ([173.254.64.10]:47009) by debbugs.gnu.org with smtp (Exim 4.80) (envelope-from ) id 1VgJqB-0002m3-0V for 15848@debbugs.gnu.org; Tue, 12 Nov 2013 14:41:39 -0500 Original-Received: (qmail 303 invoked by uid 0); 12 Nov 2013 19:41:32 -0000 Original-Received: from unknown (HELO host393.hostmonster.com) (66.147.240.193) by qproxy1.mail.unifiedlayer.com with SMTP; 12 Nov 2013 19:41:32 -0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=nbtrap.com; s=default; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date:References:Subject:Cc:To:From; bh=ITNfOmqHWERnWD/T/L+Cfdy52Wn9Pple3Wuh4cJJqMI=; b=BaY2HlFKHvWMUJrKX2AOPASgMjxHoDllWkDkOE6QbbxvXKHP1djinEUPzybdH6SorSc2eakOToB16jDeA6RPrFhJ8083mFUS6wnGo2UaBK+AjrDVSZ4NxX3XRUME5rIg; Original-Received: from [50.90.253.209] (port=56329 helo=Nathan-GNU) by host393.hostmonster.com with esmtpsa (TLSv1:CAMELLIA128-SHA:128) (Exim 4.80) (envelope-from ) id 1VgJq7-0007Cn-RO; Tue, 12 Nov 2013 12:41:32 -0700 In-Reply-To: <87r4alqzm2.fsf@gmail.com> (Jambunathan K.'s message of "Tue, 12 Nov 2013 23:19:41 +0530") User-Agent: Gnus/5.130007 (Ma Gnus v0.7) Emacs/24.3.50 (gnu/linux) X-Identified-User: {1585:host393.hostmonster.com:nbtrapco:nbtrap.com} {sentby:smtp auth 50.90.253.209 authed with nbtrap@nbtrap.com} X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x 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: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:80343 Archived-At: Jambunathan K writes: > Your patch looks good. Thanks. > > Before trying the patch, I had the "wrong" impression that headN lines > won't be displayed in > > Perl->Tools->Imenu-POD headers menu entry. > > I see that Imenu still shows the perldoc headers. > > So > > cperl-imenu-index-pod is a variable defined in `cperl-mode.el'. > Its value is t > > Documentation: > *Whether POD `=head' directives should be indexed by imenu. > > the first line of the docstring is misleading. Perhaps I misunderstand, but when I have that variable set to nil, the POD imenu entries go away, which is what the docstring says. Indeed, which-function-mode uses the imenu index for determining which function point is in. I don't know how often which-function-mode calls the indexing function, so make sure you have the variable set before visiting the file. Try again and let me know. > ---------------------------------------------------------------- > > Btw, if you are convinced that what this patch does is "the norm" rather > than "an exception", you may as well consider removing the variable. > > ---------------------------------------------------------------- I do think it's better to say that the definitions begin earlier than what cperl currently says (though it's not a "bug"). However, I think indexing the POD entries by default is the better way for several reasons: 1. cperl-mode already does it that way. 2. perl-mode does it. 3. There is no "pod-mode". For editing pod files, perl-/cperl-mode is the best Emacs has. Moreover, many people _do_ write plain pod files, in which case the entries should get indexed.