* bug#29593: [web site] Broken links in the HTML manual
@ 2017-12-06 19:35 Tobias Geerinckx-Rice
2017-12-07 21:11 ` Ludovic Courtès
2019-11-12 20:57 ` bug#29593: Bug #29593 Hunting: status? zimoun
0 siblings, 2 replies; 5+ messages in thread
From: Tobias Geerinckx-Rice @ 2017-12-06 19:35 UTC (permalink / raw)
To: 29593
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
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#29593: [web site] Broken links in the HTML manual
2017-12-06 19:35 bug#29593: [web site] Broken links in the HTML manual Tobias Geerinckx-Rice
@ 2017-12-07 21:11 ` Ludovic Courtès
2017-12-07 22:52 ` Tobias Geerinckx-Rice
2019-11-12 20:57 ` bug#29593: Bug #29593 Hunting: status? zimoun
1 sibling, 1 reply; 5+ messages in thread
From: Ludovic Courtès @ 2017-12-07 21:11 UTC (permalink / raw)
To: Tobias Geerinckx-Rice; +Cc: 29593
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’.
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#29593: [web site] Broken links in the HTML manual
2017-12-07 21:11 ` Ludovic Courtès
@ 2017-12-07 22:52 ` Tobias Geerinckx-Rice
0 siblings, 0 replies; 5+ messages in thread
From: Tobias Geerinckx-Rice @ 2017-12-07 22:52 UTC (permalink / raw)
To: ludo; +Cc: 29593
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
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#29593: Bug #29593 Hunting: status?
2017-12-06 19:35 bug#29593: [web site] Broken links in the HTML manual Tobias Geerinckx-Rice
2017-12-07 21:11 ` Ludovic Courtès
@ 2019-11-12 20:57 ` zimoun
2019-11-21 16:03 ` bug#29593: Bug #29593 Hunting: Broken links in the HTML manual zimoun
1 sibling, 1 reply; 5+ messages in thread
From: zimoun @ 2019-11-12 20:57 UTC (permalink / raw)
To: 29593, Ludovic Courtès, Tobias Geerinckx-Rice
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
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#29593: Bug #29593 Hunting: Broken links in the HTML manual
2019-11-12 20:57 ` bug#29593: Bug #29593 Hunting: status? zimoun
@ 2019-11-21 16:03 ` zimoun
0 siblings, 0 replies; 5+ messages in thread
From: zimoun @ 2019-11-21 16:03 UTC (permalink / raw)
To: 29593, Ludovic Courtès, Tobias Geerinckx-Rice
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
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2019-11-21 16:04 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2017-12-06 19:35 bug#29593: [web site] Broken links in the HTML manual Tobias Geerinckx-Rice
2017-12-07 21:11 ` Ludovic Courtès
2017-12-07 22:52 ` Tobias Geerinckx-Rice
2019-11-12 20:57 ` bug#29593: Bug #29593 Hunting: status? zimoun
2019-11-21 16:03 ` bug#29593: Bug #29593 Hunting: Broken links in the HTML manual zimoun
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/guix.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.