GNU bug report logs - #29593
[web site] Broken links in the HTML 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 29593 in the body.
You can then email your comments to 29593 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: Tobias Geerinckx-Rice <me <at> tobias.gr>
To: bug-guix <at> gnu.org
Subject: [web site] Broken links in the HTML manual
Date: Wed, 6 Dec 2017 20:35:37 +0100

Guix,

[Opening a new bug for these, rather than further overloading #29591.]

I'm celebrating the new Guix web with a quick and certainly incomplete
sweep for dead links in the HTML manual at gnu.org. I think (though I
have no data to back this up) that a significant number of newer users
are far more likely to use this version than any copy shipped with Guix.
Young people and their webs and all that.

So far, I've found the following:

- Defining Packages[0]:
  “GNU configuration triplets” is broken.
  It points inside the Guix manual, not autoconf's.

- Package Management[1]:
  “The Emacs-Guix Reference Manual” is broken.
  It points to a URI with duplicate ‘/index.html’s.

- Using the Offload Facility[2]:
  “Converting keys” points to #Converting-keys, the target site uses
  #Converting%20keys. I don't know who's right. The page still loads
  so the user can navigate manually, but it would still be nice to fix.

- Formatting Code[3]:
  Similarly points to ‘index.html/Development.html’ when it should use
  only ‘Development.html’.

- Networking Services[4]:
  “lsh-make-seed” and “lshd basics” also use bad anchors, so the user
  has to search and scroll.

- The Perfect Setup[5]:
  “Introduction in the Geiser User Manual” is a broken link.

- Continuous Integration[6]:
  “Associations Lists in GNU Guile Reference Manual” is broken.
  It points inside the Guix manual, not Guile's.

- Mapped Devices[7]:
  “Translators in The GNU Hurd Reference Manual” is broken.
  It points inside the Guix manual, not The Hurd's.

- Documentation[8]:
  “Getting Started in Info: An Introduction” is broken.

Even without any Texinfo knowledge, I thought this would be easy to
quickly fix myself. I had no such luck.

Kind regards,

T G-R

[0]:
https://www.gnu.org/software/guix/manual/html_node/Defining-Packages.html
[1]:
https://www.gnu.org/software/guix/manual/html_node/Package-Management.html
[2]:
https://www.gnu.org/software/guix/manual/html_node/Daemon-Offload-Setup.html
[3]: https://www.gnu.org/software/guix/manual/html_node/Formatting-Code.html
[4]:
https://www.gnu.org/software/guix/manual/html_node/Networking-Services.html
[5]:
https://www.gnu.org/software/guix/manual/html_node/The-Perfect-Setup.html
[6]:
https://www.gnu.org/software/guix/manual/html_node/Continuous-Integration.html
[7]: https://www.gnu.org/software/guix/manual/html_node/Mapped-Devices.html
[8]: https://www.gnu.org/software/guix/manual/html_node/Documentation.html

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

From: ludo <at> gnu.org (Ludovic Courtès)
To: Tobias Geerinckx-Rice <me <at> tobias.gr>
Cc: 29593 <at> debbugs.gnu.org
Subject: Re: bug#29593: [web site] Broken links in the HTML manual
Date: Thu, 07 Dec 2017 22:11:19 +0100

Hello!

Tobias Geerinckx-Rice <me <at> tobias.gr> skribis:

> I'm celebrating the new Guix web with a quick and certainly incomplete
> sweep for dead links in the HTML manual at gnu.org. I think (though I
> have no data to back this up) that a significant number of newer users
> are far more likely to use this version than any copy shipped with Guix.
> Young people and their webs and all that.

I’ll see if I can get around to fixing those, but for the record, most
of them are Texinfo links derived from what doc/htmlxref.cnf specifies.

Thanks for the list!

Ludo’.

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

From: Tobias Geerinckx-Rice <me <at> tobias.gr>
To: ludo <at> gnu.org
Cc: 29593 <at> debbugs.gnu.org
Subject: Re: bug#29593: [web site] Broken links in the HTML manual
Date: Thu, 7 Dec 2017 23:52:03 +0100

Ludo',

Ludovic Courtès wrote on 07/12/17 at 22:11:
> most of them are Texinfo links derived from what doc/htmlxref.cnf specifies.

Thanks! I thought as much. I thought these would be trivial to fix, but
it's a bit more involved than just twiddling some URIs. I'll take
another look.

> I’ll see if I can get around to fixing those

This bug serves mainly to keep track of what needs fixing and remind
myself to do so. I don't expect anyone to jump.

Kind regards,

T G-R

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

From: zimoun <zimon.toutoune <at> gmail.com>
To: 29593 <at> debbugs.gnu.org, Ludovic Courtès <ludo <at> gnu.org>, 
 Tobias Geerinckx-Rice <me <at> tobias.gr>
Subject: Bug #29593 Hunting: status?
Date: Tue, 12 Nov 2019 21:57:31 +0100

Hi Tobias,

From my quick tests, the 9 broken links that you reported are now fixed.

> This bug serves mainly to keep track of what needs fixing and remind
> myself to do so. I don't expect anyone to jump.

Does it make sense to close it?

Thanks in advance for any comments.


All the best,
simon

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

From: zimoun <zimon.toutoune <at> gmail.com>
To: 29593 <at> debbugs.gnu.org, Ludovic Courtès <ludo <at> gnu.org>, 
 Tobias Geerinckx-Rice <me <at> tobias.gr>
Subject: Bug #29593 Hunting: Broken links in the HTML manual
Date: Thu, 21 Nov 2019 17:03:22 +0100

Hi Tobias,

My quick tests were really quick! ;-)

These links remains broken. Do you have any patch fixing them that you
forgot to push?
Or do I invest more time to propose a patch?


Thank you in advance.

Cheers,
simon


Same with the online "manual/devel".


- Package Management[1]:
  “The Emacs-Guix Reference Manual” is broken.
  It points to a URI with duplicate ‘/index.html’s.

This link [1b] is still broken.

[1]  https://www.gnu.org/software/guix/manual/html_node/Package-Management.html
[1b] https://guix.gnu.org/manual/en/emacs-guix/index.html#Top

Seems broken in Info too.

Related to Formatting Code [3].
  Similarly points to ‘index.html/Development.html’ when it should use
  only ‘Development.html’.

[3]  https://www.gnu.org/software/guix/manual/html_node/Formatting-Code.html
[3b] https://guix.gnu.org/manual/en/emacs-guix/Development.html#Development

contributing.texi:
@pxref{Development,,, emacs-guix, The Emacs-Guix Reference Manual}


- Using the Offload Facility[2]:
  “Converting keys” points to #Converting-keys, the target site uses
  #Converting%20keys. I don't know who's right. The page still loads
  so the user can navigate manually, but it would still be nice to fix.

The manual (texi entry: @pxref{Converting keys,,, lsh, LSH Manual}) points to
[2b] and the working link is [2c].

[2]  https://www.gnu.org/software/guix/manual/html_node/Daemon-Offload-Setup.html
[2b] http://www.lysator.liu.se/~nisse/lsh/lsh.html#Converting-keys
[2c] http://www.lysator.liu.se/~nisse/lsh/lsh.html#Converting%20keys


How to fix it?



- Networking Services[4]:
  “lsh-make-seed” and “lshd basics” also use bad anchors, so the user
  has to search and scroll.

Idem as previous.

[4]  https://www.gnu.org/software/guix/manual/html_node/Networking-Services.html
[4b] http://www.lysator.liu.se/~nisse/lsh/lsh.html#lsh_002dmake_002dsede
[4c] http://www.lysator.liu.se/~nisse/lsh/lsh.html#lshd%20basics


- The Perfect Setup[5]:
  “Introduction in the Geiser User Manual” is a broken link.

The entry is @pxref{Introduction,,, geiser, Geiser User Manual} which works in
Info but is broken online.

[5]  https://www.gnu.org/software/guix/manual/html_node/The-Perfect-Setup.html
[5b] https://guix.gnu.org/manual/en/geiser/Introduction.html#Introduction
[5c] http://nongnu.org/geiser/geiser_1.html#Introduction


- Continuous Integration[6]:
  “Associations Lists in GNU Guile Reference Manual” is broken.
  It points inside the Guix manual, not Guile's.

The page [6] points to [6b] which is broken.

[6]  https://www.gnu.org/software/guix/manual/html_node/Continuous-Integration.html
[6b] https://www.gnu.org/software/guile/manual/html_node/Associations-Lists.html#Associations-Lists


Is the link also broken with Info?


- Mapped Devices[7]:
  “Translators in The GNU Hurd Reference Manual” is broken.
  It points inside the Guix manual, not The Hurd's.

Idem as previous.

[7]  https://www.gnu.org/software/guix/manual/html_node/Mapped-Devices.html
[7b] https://guix.gnu.org/manual/en/hurd/Translators.html#Translators


- Documentation[8]:
  “Getting Started in Info: An Introduction” is broken.

Idem.

[8]  https://www.gnu.org/software/guix/manual/html_node/Documentation.html
[8b] https://guix.gnu.org/manual/en/info/Getting-Started.html#Getting-Started

Previous Next

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