GNU bug report logs - #38154
Man-follow-manual-reference could be as sharp as M-x man itself

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 38154 in the body.
You can then email your comments to 38154 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

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

From: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
To: bug-gnu-emacs <at> gnu.org
Subject: Man-follow-manual-reference could be as sharp as M-x man itself
Date: Sat, 09 Nov 2019 19:18:27 +0800

On a man page with

    SEE ALSO
            v.segment, v.split, v.to.rast, v.to.db
how come

   m runs the command man, which is an interactive autoloaded comp
     Lisp function in ‘man.el’.

still works (knows what man page we want) when placed on top of any of
the four. But

    r runs the command Man-follow-manual-reference, which is an
    interactive compiled Lisp function in ‘man.el’.

doesn't find any of them!

Sure, I'll tell the authors to use

   SEE ALSO
           v.segment(1grass), v.split(1grass), v.to.rast(1grass), v.to.db(1grass)

but in the meantime, Man-follow-manual-reference should be beefed up...

emacs-version "26.3"

Yes one can argue "well do you want Man-follow-manual-reference to catch
every "if, and, or but" in the SEE ALSO section? Well as a matter of
fact yes. Might as well.

(Please fix Man-follow-manual-reference to find them all, even if far
from the cursor too. Don't have it say "There are no references in the current man page".)

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
Cc: 38154 <at> debbugs.gnu.org
Subject: Re: bug#38154: Man-follow-manual-reference could be as sharp as M-x
 man itself
Date: Sat, 09 Nov 2019 17:53:58 +0200

> From: 積丹尼 Dan Jacobson
>  <jidanni <at> jidanni.org>
> Date: Sat, 09 Nov 2019 19:18:27 +0800
> 
> Sure, I'll tell the authors to use
> 
>    SEE ALSO
>            v.segment(1grass), v.split(1grass), v.to.rast(1grass), v.to.db(1grass)
> 
> but in the meantime, Man-follow-manual-reference should be beefed up...

FWIW, I'm not at all sure.  It's an invalid man page (a.k.a. "bug"),
so why should we support it?

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 38154 <at> debbugs.gnu.org,
 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
Subject: Re: bug#38154: Man-follow-manual-reference could be as sharp as M-x
 man itself
Date: Thu, 14 Nov 2019 06:57:31 +0100

Eli Zaretskii <eliz <at> gnu.org> writes:

>> Sure, I'll tell the authors to use
>> 
>>    SEE ALSO
>>            v.segment(1grass), v.split(1grass), v.to.rast(1grass), v.to.db(1grass)
>> 
>> but in the meantime, Man-follow-manual-reference should be beefed up...
>
> FWIW, I'm not at all sure.  It's an invalid man page (a.k.a. "bug"),
> so why should we support it?

Yeah, I don't think Man-follow-manual-reference should guess that much
here.  It makes sense for M-x man to guess though, so I don't think
there's anything to fix here, and I'm closing this bug report.

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

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: 38154 <at> debbugs.gnu.org, jidanni <at> jidanni.org
Subject: Re: bug#38154: Man-follow-manual-reference could be as sharp as M-x
 man itself
Date: Thu, 14 Nov 2019 15:58:27 +0200

> From: Lars Ingebrigtsen <larsi <at> gnus.org>
> Cc: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>,
>   38154 <at> debbugs.gnu.org
> Date: Thu, 14 Nov 2019 06:57:31 +0100
> 
> It makes sense for M-x man to guess though

I don't think "M-x man" guesses, I think it's 'man' the program.

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

From: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 38154 <at> debbugs.gnu.org
Subject: Re: bug#38154: Man-follow-manual-reference could be as sharp as M-x
 man itself
Date: Mon, 18 Nov 2019 02:59:16 +0800

>>>>> "EZ" == Eli Zaretskii <eliz <at> gnu.org> writes:
>> From: 積丹尼 Dan Jacobson
>> <jidanni <at> jidanni.org>
>> Date: Sat, 09 Nov 2019 19:18:27 +0800
>> 
>> Sure, I'll tell the authors to use
>> 
>> SEE ALSO
>> v.segment(1grass), v.split(1grass), v.to.rast(1grass), v.to.db(1grass)
>> 
>> but in the meantime, Man-follow-manual-reference should be beefed up...

EZ> FWIW, I'm not at all sure.  It's an invalid man page (a.k.a. "bug"),
EZ> so why should we support it?

It's even the way these document pros make their man pages:

$ man perldoc

SEE ALSO
       perlpod, Pod::Perldoc

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
Cc: 38154 <at> debbugs.gnu.org
Subject: Re: bug#38154: Man-follow-manual-reference could be as sharp as M-x
 man itself
Date: Sun, 17 Nov 2019 21:01:46 +0200

> From: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
> Cc: 38154 <at> debbugs.gnu.org
> Date: Mon, 18 Nov 2019 02:59:16 +0800
> 
> EZ> FWIW, I'm not at all sure.  It's an invalid man page (a.k.a. "bug"),
> EZ> so why should we support it?
> 
> It's even the way these document pros make their man pages:
> 
> $ man perldoc
> 
> SEE ALSO
>        perlpod, Pod::Perldoc

Please report a bug against them.  Not only Emacs has  bugs, and Emacs
doesn't have to fix the entire world.

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

From: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 38154 <at> debbugs.gnu.org
Subject: Re: bug#38154: Man-follow-manual-reference could be as sharp as M-x
 man itself
Date: Mon, 18 Nov 2019 17:45:03 +0800

>>>>> "EZ" == Eli Zaretskii <eliz <at> gnu.org> writes:
>> From: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
>> Cc: 38154 <at> debbugs.gnu.org
>> Date: Mon, 18 Nov 2019 02:59:16 +0800
>> 
EZ> FWIW, I'm not at all sure.  It's an invalid man page (a.k.a. "bug"),
EZ> so why should we support it?
>> 
>> It's even the way these document pros make their man pages:
>> 
>> $ man perldoc
>> 
>> SEE ALSO
>> perlpod, Pod::Perldoc

EZ> Please report a bug against them.  Not only Emacs has  bugs, and Emacs
EZ> doesn't have to fix the entire world.

"Put your money where your mouth is" and report it on
https://github.com/Perl/perl5/issues/new/choose
I say it is emacs that could be made smarter in such cases.

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

From: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 38154 <at> debbugs.gnu.org
Subject: Re: bug#38154: Man-follow-manual-reference could be as sharp as M-x
 man itself
Date: Mon, 18 Nov 2019 17:55:22 +0800

OK, submitted https://github.com/Perl/perl5/issues/17309 .

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
Cc: 38154 <at> debbugs.gnu.org
Subject: Re: bug#38154: Man-follow-manual-reference could be as sharp as M-x
 man itself
Date: Mon, 18 Nov 2019 17:46:52 +0200

> From: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
> Cc: 38154 <at> debbugs.gnu.org
> Date: Mon, 18 Nov 2019 17:55:22 +0800
> 
> OK, submitted https://github.com/Perl/perl5/issues/17309 .

Thank you.

Previous Next

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