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

classic Classic list List threaded Threaded
9 messages Options
Reply | Threaded
Open this post in threaded view
|

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

積丹尼 Dan Jacobson
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".)



Reply | Threaded
Open this post in threaded view
|

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

Eli Zaretskii
> From: 積丹尼 Dan Jacobson
>  <[hidden email]>
> 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?



Reply | Threaded
Open this post in threaded view
|

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

Lars Ingebrigtsen
Eli Zaretskii <[hidden email]> 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



Reply | Threaded
Open this post in threaded view
|

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

Eli Zaretskii
> From: Lars Ingebrigtsen <[hidden email]>
> Cc: 積丹尼 Dan Jacobson <[hidden email]>,
>   [hidden email]
> 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.



Reply | Threaded
Open this post in threaded view
|

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

積丹尼 Dan Jacobson
In reply to this post by 積丹尼 Dan Jacobson
>>>>> "EZ" == Eli Zaretskii <[hidden email]> writes:
>> From: 積丹尼 Dan Jacobson
>> <[hidden email]>
>> 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



Reply | Threaded
Open this post in threaded view
|

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

Eli Zaretskii
> From: 積丹尼 Dan Jacobson <[hidden email]>
> Cc: [hidden email]
> 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.



Reply | Threaded
Open this post in threaded view
|

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

積丹尼 Dan Jacobson
In reply to this post by 積丹尼 Dan Jacobson
>>>>> "EZ" == Eli Zaretskii <[hidden email]> writes:
>> From: 積丹尼 Dan Jacobson <[hidden email]>
>> Cc: [hidden email]
>> 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.



Reply | Threaded
Open this post in threaded view
|

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

積丹尼 Dan Jacobson
In reply to this post by 積丹尼 Dan Jacobson
Reply | Threaded
Open this post in threaded view
|

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

Eli Zaretskii
> From: 積丹尼 Dan Jacobson <[hidden email]>
> Cc: [hidden email]
> Date: Mon, 18 Nov 2019 17:55:22 +0800
>
> OK, submitted https://github.com/Perl/perl5/issues/17309 .

Thank you.