Broken link to Geiser User Manual

DoneSubmitted by Greg Hogan.
Details
2 participants
  • Greg Hogan
  • Maxim Cournoyer
Owner
unassigned
Severity
normal
G
G
Greg Hogan wrote on 6 May 20:28 +0200
(address . bug-guix@gnu.org)
CA+3U0ZkApNa4icBWxDSJ5kqLrofPvbEfOQAHV3=i75PDDrLgMg@mail.gmail.com
M
M
Maxim Cournoyer wrote on 9 Jun 22:39 +0200
(name . Greg Hogan)(address . code@greghogan.com)(address . 55290@debbugs.gnu.org)
87a6alinbe.fsf@gmail.com
Hello Greg,

Greg Hogan <code@greghogan.com> writes:

Toggle quote (7 lines)
> At [1] the link in "see Introduction in Geiser User Manual" points to [2]
> but should link to [3].
>
> [1] https://guix.gnu.org/manual/en/html_node/The-Perfect-Setup.html
> [2] http://geiser.nongnu.org/Introduction.html#Introduction
> [3] https://geiser.nongnu.org/geiser_1.html#Introduction

Thanks for reporting this; as Ludovic hinted on #guix, this appears to
be a discrepancy between the file layout produced by makeinfo (used by
Guix) vs texi2html (used by Geiser). This problem is briefly mentioned
in info "(texinfo)HTML Xref Mismatch".

It seems 'makeinfo' should be preferred these days, since it's now
become enough configurable and appears more actively maintained. I've
sent a patch to Geiser to do the switch, if they accept it this problem
should be resolved [0].


To be followed.

Maxim
M
M
Maxim Cournoyer wrote on 16 Jun 17:19 +0200
(name . Greg Hogan)(address . code@greghogan.com)(address . 55290-done@debbugs.gnu.org)
8735g4d4ai.fsf@gmail.com
Hi,

Maxim Cournoyer <maxim.cournoyer@gmail.com> writes:

Toggle quote (25 lines)
> Hello Greg,
>
> Greg Hogan <code@greghogan.com> writes:
>
>> At [1] the link in "see Introduction in Geiser User Manual" points to [2]
>> but should link to [3].
>>
>> [1] https://guix.gnu.org/manual/en/html_node/The-Perfect-Setup.html
>> [2] http://geiser.nongnu.org/Introduction.html#Introduction
>> [3] https://geiser.nongnu.org/geiser_1.html#Introduction
>
> Thanks for reporting this; as Ludovic hinted on #guix, this appears to
> be a discrepancy between the file layout produced by makeinfo (used by
> Guix) vs texi2html (used by Geiser). This problem is briefly mentioned
> in info "(texinfo)HTML Xref Mismatch".
>
> It seems 'makeinfo' should be preferred these days, since it's now
> become enough configurable and appears more actively maintained. I've
> sent a patch to Geiser to do the switch, if they accept it this problem
> should be resolved [0].
>
> [0] https://gitlab.com/emacs-geiser/geiser/-/merge_requests/8
>
> To be followed.

Fixed. The Geiser documentation is now generated via 'makeinfo' rather
than 'texi2html'.

Thanks for the report!

Closing.

Maxim
Closed
?
Your comment

This issue is archived.

To comment on this conversation send email to 55290@debbugs.gnu.org