unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#38154: Man-follow-manual-reference could be as sharp as M-x man itself
@ 2019-11-09 11:18 積丹尼 Dan Jacobson
  2019-11-09 15:53 ` Eli Zaretskii
  0 siblings, 1 reply; 9+ messages in thread
From: 積丹尼 Dan Jacobson @ 2019-11-09 11:18 UTC (permalink / raw)
  To: 38154

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".)





^ permalink raw reply	[flat|nested] 9+ messages in thread

* bug#38154: Man-follow-manual-reference could be as sharp as M-x man itself
  2019-11-09 11:18 bug#38154: Man-follow-manual-reference could be as sharp as M-x man itself 積丹尼 Dan Jacobson
@ 2019-11-09 15:53 ` Eli Zaretskii
  2019-11-14  5:57   ` Lars Ingebrigtsen
  2019-11-17 18:59   ` 積丹尼 Dan Jacobson
  0 siblings, 2 replies; 9+ messages in thread
From: Eli Zaretskii @ 2019-11-09 15:53 UTC (permalink / raw)
  To: 積丹尼 Dan Jacobson; +Cc: 38154

> From: 積丹尼 Dan Jacobson
>  <jidanni@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?





^ permalink raw reply	[flat|nested] 9+ messages in thread

* bug#38154: Man-follow-manual-reference could be as sharp as M-x man itself
  2019-11-09 15:53 ` Eli Zaretskii
@ 2019-11-14  5:57   ` Lars Ingebrigtsen
  2019-11-14 13:58     ` Eli Zaretskii
  2019-11-17 18:59   ` 積丹尼 Dan Jacobson
  1 sibling, 1 reply; 9+ messages in thread
From: Lars Ingebrigtsen @ 2019-11-14  5:57 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: 38154, 積丹尼 Dan Jacobson

Eli Zaretskii <eliz@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





^ permalink raw reply	[flat|nested] 9+ messages in thread

* bug#38154: Man-follow-manual-reference could be as sharp as M-x man itself
  2019-11-14  5:57   ` Lars Ingebrigtsen
@ 2019-11-14 13:58     ` Eli Zaretskii
  0 siblings, 0 replies; 9+ messages in thread
From: Eli Zaretskii @ 2019-11-14 13:58 UTC (permalink / raw)
  To: Lars Ingebrigtsen; +Cc: 38154, jidanni

> From: Lars Ingebrigtsen <larsi@gnus.org>
> Cc: 積丹尼 Dan Jacobson <jidanni@jidanni.org>,
>   38154@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.





^ permalink raw reply	[flat|nested] 9+ messages in thread

* bug#38154: Man-follow-manual-reference could be as sharp as M-x man itself
  2019-11-09 15:53 ` Eli Zaretskii
  2019-11-14  5:57   ` Lars Ingebrigtsen
@ 2019-11-17 18:59   ` 積丹尼 Dan Jacobson
  2019-11-17 19:01     ` Eli Zaretskii
  1 sibling, 1 reply; 9+ messages in thread
From: 積丹尼 Dan Jacobson @ 2019-11-17 18:59 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: 38154

>>>>> "EZ" == Eli Zaretskii <eliz@gnu.org> writes:
>> From: 積丹尼 Dan Jacobson
>> <jidanni@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





^ permalink raw reply	[flat|nested] 9+ messages in thread

* bug#38154: Man-follow-manual-reference could be as sharp as M-x man itself
  2019-11-17 18:59   ` 積丹尼 Dan Jacobson
@ 2019-11-17 19:01     ` Eli Zaretskii
  2019-11-18  9:45       ` 積丹尼 Dan Jacobson
  2019-11-18  9:55       ` 積丹尼 Dan Jacobson
  0 siblings, 2 replies; 9+ messages in thread
From: Eli Zaretskii @ 2019-11-17 19:01 UTC (permalink / raw)
  To: 積丹尼 Dan Jacobson; +Cc: 38154

> From: 積丹尼 Dan Jacobson <jidanni@jidanni.org>
> Cc: 38154@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.





^ permalink raw reply	[flat|nested] 9+ messages in thread

* bug#38154: Man-follow-manual-reference could be as sharp as M-x man itself
  2019-11-17 19:01     ` Eli Zaretskii
@ 2019-11-18  9:45       ` 積丹尼 Dan Jacobson
  2019-11-18  9:55       ` 積丹尼 Dan Jacobson
  1 sibling, 0 replies; 9+ messages in thread
From: 積丹尼 Dan Jacobson @ 2019-11-18  9:45 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: 38154

>>>>> "EZ" == Eli Zaretskii <eliz@gnu.org> writes:
>> From: 積丹尼 Dan Jacobson <jidanni@jidanni.org>
>> Cc: 38154@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.





^ permalink raw reply	[flat|nested] 9+ messages in thread

* bug#38154: Man-follow-manual-reference could be as sharp as M-x man itself
  2019-11-17 19:01     ` Eli Zaretskii
  2019-11-18  9:45       ` 積丹尼 Dan Jacobson
@ 2019-11-18  9:55       ` 積丹尼 Dan Jacobson
  2019-11-18 15:46         ` Eli Zaretskii
  1 sibling, 1 reply; 9+ messages in thread
From: 積丹尼 Dan Jacobson @ 2019-11-18  9:55 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: 38154

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





^ permalink raw reply	[flat|nested] 9+ messages in thread

* bug#38154: Man-follow-manual-reference could be as sharp as M-x man itself
  2019-11-18  9:55       ` 積丹尼 Dan Jacobson
@ 2019-11-18 15:46         ` Eli Zaretskii
  0 siblings, 0 replies; 9+ messages in thread
From: Eli Zaretskii @ 2019-11-18 15:46 UTC (permalink / raw)
  To: 積丹尼 Dan Jacobson; +Cc: 38154

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

Thank you.





^ permalink raw reply	[flat|nested] 9+ messages in thread

end of thread, other threads:[~2019-11-18 15:46 UTC | newest]

Thread overview: 9+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-11-09 11:18 bug#38154: Man-follow-manual-reference could be as sharp as M-x man itself 積丹尼 Dan Jacobson
2019-11-09 15:53 ` Eli Zaretskii
2019-11-14  5:57   ` Lars Ingebrigtsen
2019-11-14 13:58     ` Eli Zaretskii
2019-11-17 18:59   ` 積丹尼 Dan Jacobson
2019-11-17 19:01     ` Eli Zaretskii
2019-11-18  9:45       ` 積丹尼 Dan Jacobson
2019-11-18  9:55       ` 積丹尼 Dan Jacobson
2019-11-18 15:46         ` Eli Zaretskii

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).