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