[web site] Broken links in the HTML manual

OpenSubmitted by Tobias Geerinckx-Rice.
Details
3 participants
  • Ludovic Courtès
  • Tobias Geerinckx-Rice
  • zimoun
Owner
unassigned
Severity
normal
T
T
Tobias Geerinckx-Rice wrote on 6 Dec 2017 20:35
(address . bug-guix@gnu.org)
37135336-fd51-fd6b-8e3a-e645c29c69b8@tobias.gr
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]:
[1]:
[2]:
[4]:
[5]:
[6]:
L
L
Ludovic Courtès wrote on 7 Dec 2017 22:11
(name . Tobias Geerinckx-Rice)(address . me@tobias.gr)(address . 29593@debbugs.gnu.org)
87a7yuckg8.fsf@gnu.org
Hello!

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

Toggle quote (6 lines)
> 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’.
T
T
Tobias Geerinckx-Rice wrote on 7 Dec 2017 23:52
(address . ludo@gnu.org)(address . 29593@debbugs.gnu.org)
daff4c12-cef4-2fac-ef7c-305710865607@tobias.gr
Ludo',

Ludovic Courtès wrote on 07/12/17 at 22:11:
Toggle quote (2 lines)
> 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.

Toggle quote (2 lines)
> 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
Z
Z
zimoun wrote on 12 Nov 2019 21:57
Bug #29593 Hunting: status?
CAJ3okZ19ARFznp4QdHqecmXwJd9qYwB_AX3gtvtMuChPF8O6sg@mail.gmail.com
Hi Tobias,

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

Toggle quote (3 lines)
> 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
Z
Z
zimoun wrote on 21 Nov 2019 17:03
Bug #29593 Hunting: Broken links in the HTML manual
CAJ3okZ04ocfaaCVODYQMy8HXZ--pHF0TMxk42mrKEpwPbiohyw@mail.gmail.com
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.


Seems broken in Info too.

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


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].



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.



- 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.



- 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.



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.



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

Idem.

?