GNU bug report logs - #54424
Broken links in cookbook

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 54424 in the body.
You can then email your comments to 54424 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 links in cookbook
Date: Wed, 16 Mar 2022 11:24:52 -0400

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

1) I noticed that the following link (diff below) to "Package Reference"
looks to have changed to lowercase "package Reference" but not updated
(there is a working link closely following). Then I scanned the page and
found additional broken links:

2) The link at the end of "Go ahead, run guix install sicp and start
reading with info sicp (see Structure and Interpretation of Computer
Programs)" is an internal reference but does not appear in the cookbook?

3) The language links (I see "This manual is also available in French (see
Livre de recettes de GNU Guix) and German (see GNU-Guix-Kochbuch)" from
English) are broken and need the digraph to precede the ".html" path suffix
(but not for 'en'!).

Greg

diff --git a/doc/guix-cookbook.texi b/doc/guix-cookbook.texi
index d2ce525998..2caad5c3bb 100644
--- a/doc/guix-cookbook.texi
+++ b/doc/guix-cookbook.texi
@@ -900,7 +900,7 @@ Installed in the store and in the profile, as well as
 being present at build time.
 @end table

-@xref{Package Reference,,, guix, GNU Guix Reference Manual} for more
details.
+@xref{package Reference,,, guix, GNU Guix Reference Manual} for more
details.

 The distinction between the various inputs is important: if a dependency
can be
 handled as an @emph{input} instead of a @emph{propagated input}, it should
be done so, or

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

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

From: Ludovic Courtès <ludo <at> gnu.org>
To: Greg Hogan <code <at> greghogan.com>
Cc: 54424-done <at> debbugs.gnu.org
Subject: Re: bug#54424: Broken links in cookbook
Date: Fri, 08 Apr 2022 20:20:17 +0200

Hi,

Greg Hogan <code <at> greghogan.com> skribis:

> 1) I noticed that the following link (diff below) to "Package Reference"
> looks to have changed to lowercase "package Reference" but not updated
> (there is a working link closely following). Then I scanned the page and
> found additional broken links:
>
> 2) The link at the end of "Go ahead, run guix install sicp and start
> reading with info sicp (see Structure and Interpretation of Computer
> Programs)" is an internal reference but does not appear in the cookbook?
>
> 3) The language links (I see "This manual is also available in French (see
> Livre de recettes de GNU Guix) and German (see GNU-Guix-Kochbuch)" from
> English) are broken and need the digraph to precede the ".html" path suffix
> (but not for 'en'!).

Fixed with these three commits:

  868da34d54 doc: Fix cookbook URLs in htmlxref.cnf.
  6e747c3d50 doc: cookbook: Fix cross-reference to SICP.
  63a11f92d1 doc: cookbook: Fix cross-reference to the manual.

It should propagate to the on-line copy within an hour.

Note that SICP doesn’t have a Texinfo-compatible set of HTML pages
on-line, so that links will unfortunately remain broken.

Thanks,
Ludo’.

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

From: Greg Hogan <code <at> greghogan.com>
To: 54424 <at> debbugs.gnu.org
Subject: Re: bug#54424: closed (Re: bug#54424: Broken links in cookbook)
Date: Fri, 6 May 2022 14:29:19 -0400

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

>
> ---------- Forwarded message ----------
> From: "Ludovic Courtès" <ludo <at> gnu.org>
> To: Greg Hogan <code <at> greghogan.com>
> Cc: 54424-done <at> debbugs.gnu.org
> Bcc:
> Date: Fri, 08 Apr 2022 20:20:17 +0200
> Subject: Re: bug#54424: Broken links in cookbook
> Hi,
>
> Greg Hogan <code <at> greghogan.com> skribis:
>
> > 2) The link at the end of "Go ahead, run guix install sicp and start
> > reading with info sicp (see Structure and Interpretation of Computer
> > Programs)" is an internal reference but does not appear in the cookbook?
>
> Note that SICP doesn’t have a Texinfo-compatible set of HTML pages
> on-line, so that links will unfortunately remain broken.
>
> Thanks,
> Ludo’.


If it must remain broken then why not remove the link, but are we not able
to insert a plain @url? Is this the intended destination:
  https://mitpress.mit.edu/sites/default/files/sicp/full-text/book/book.html

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

Previous Next

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