bug#54424: Broken links in cookbook

bug#54424: Broken links in cookbook

[Greg Hogan]

[-- Attachment #1: Type: text/plain, Size: 1315 bytes --]

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

[-- Attachment #2: Type: text/html, Size: 1540 bytes --]

bug#54424: Broken links in cookbook

[Ludovic Courtès]

Hi,

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

bug#54424: closed (Re: bug#54424: Broken links in cookbook)

[Greg Hogan]

[-- Attachment #1: Type: text/plain, Size: 924 bytes --]

>
> ---------- Forwarded message ----------
> From: "Ludovic Courtès" <ludo@gnu.org>
> To: Greg Hogan <code@greghogan.com>
> Cc: 54424-done@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@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

[-- Attachment #2: Type: text/html, Size: 1600 bytes --]