[Pkg-doc-linux-devel] Bug#325228: HOWTO/en-html: don't assume web server

[Dan Jacobson]

Package: doc-linux-html
Version: 2005.07-1
Severity: minor

In e.g.,
/usr/share/doc/HOWTO/en-html/PalmOS-HOWTO.html
we still find
HTTP-EQUIV=REFRESH CONTENT="0; URL=./PalmOS-HOWTO/"
This does not work if one is not running a web server!
Please link directly to the index.html like the other HOWTOs do!

One seems to find lots of these:
$ cd /usr/share/doc/HOWTO/en-html
$ find *.html -size 1|xargs grep -l HTTP-EQUIV=REFRESH|wc -l
63
but in fact it seems many are just orphans left over from some earlier
worse situation! E.g.,
/usr/share/doc/HTML/HOWTO/index.html
correctly links to
../../HOWTO/en-html/SLIP-PPP-Emulator/index.html
even though there is a
/usr/share/doc/HOWTO/en-html/SLIP-PPP-Emulator.html
still sitting on the disk. For what I do not know.

Apparently the link to PalmOS-HOWTO.html
in /usr/share/doc/HTML/HOWTO/index.html is one of the last bad links
still left, and I just happened to stumble upon it.
This should be a link to PalmOS-HOWTO/index.html.

So, 1. make sure all links don't depend on HTTP-EQUIV=REFRESH.
Some still do. 2. remove the orphaned HTTP-EQUIV=REFRESH files.
Most are apparently already just sitting there bypassed.

P.S., names are still cut short in
/usr/share/doc/HTML/HOWTO/index.html. E.g.,:
Motorola Surfboard 4100 + 4200 Series USB Cable M
LinuxGL (GLX) QuakeWorld Client compile mini-HOWT