GNU bug report logs - #55290
Broken link to Geiser User Manual

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 55290 in the body.
You can then email your comments to 55290 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Greg Hogan <code <at> greghogan.com>
To: bug-guix <at> gnu.org
Subject: Broken link to Geiser User Manual
Date: Fri, 6 May 2022 14:28:39 -0400

[Message part 1 (text/plain, inline)]

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

[Message part 2 (text/html, inline)]

Message #8 received at 55290 <at> debbugs.gnu.org (full text, mbox):

From: Maxim Cournoyer <maxim.cournoyer <at> gmail.com>
To: Greg Hogan <code <at> greghogan.com>
Cc: 55290 <at> debbugs.gnu.org
Subject: Re: bug#55290: Broken link to Geiser User Manual
Date: Thu, 09 Jun 2022 16:39:17 -0400

Hello Greg,

Greg Hogan <code <at> 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.

Maxim

Message #13 received at 55290-done <at> debbugs.gnu.org (full text, mbox):

From: Maxim Cournoyer <maxim.cournoyer <at> gmail.com>
To: Greg Hogan <code <at> greghogan.com>
Cc: 55290-done <at> debbugs.gnu.org
Subject: Re: bug#55290: Broken link to Geiser User Manual
Date: Thu, 16 Jun 2022 11:19:33 -0400

Hi,

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

> Hello Greg,
>
> Greg Hogan <code <at> 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

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.