bug#29593: [web site] Broken links in the HTML manual

bug#29593: [web site] Broken links in the HTML manual

[Tobias Geerinckx-Rice]

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

bug#29593: [web site] Broken links in the HTML manual

[Ludovic Courtès]

Hello!

Tobias Geerinckx-Rice <me@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’.

bug#29593: [web site] Broken links in the HTML manual

[Tobias Geerinckx-Rice]

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

bug#29593: Bug #29593 Hunting: status?

[zimoun]

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

bug#29593: Bug #29593 Hunting: Broken links in the HTML manual

[zimoun]

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