Broken link to Geiser User Manual

  • Done
  • quality assurance status badge
Details
2 participants
  • Greg Hogan
  • Maxim Cournoyer
Owner
unassigned
Submitted by
Greg Hogan
Severity
normal
G
M
M
Maxim Cournoyer wrote on 9 Jun 2022 22:39
(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 2022 17:19
(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 an email to 55290@debbugs.gnu.org

To respond to this issue using the mumi CLI, first switch to it
mumi current 55290
Then, you may apply the latest patchset in this issue (with sign off)
mumi am -- -s
Or, compose a reply to this issue
mumi compose
Or, send patches to this issue
mumi send-email *.patch