https://manpages.debian.org/ - PARTIAL breakage

[Javier Fernandez-Sanguino]

(Note: copying debian-doc as this is where we discuss any issues with
the manpages service)

I just went to https://manpages.debian.org/ and entered chroot in the search
box.
It sent me to
https://manpages.debian.org/jessie/manpages-es-extra/chroot.1.es.html .

The redirector tries to find the "best" manpage and forwards you to
that one. Unfortunatley, this seems to be a bug in the
manpages-es-extra manpage, which provides a chroot manpage in section
1 (instead of section 8, where it should be), and confuses the
redirector.

Anyway, if you want to see the English manpage in section 8 you can
access it by going to: https://manpages.debian.org/8/chroot

https://manpages.debian.org/jessie/debootstrap/debootstrap.8.en.html .
Following the structural example of that URL I attempted to go to
https://manpages.debian.org/jessie/chroot/chroot.8.en.html .
That sent me to
https://dyn.manpages.debian.org/jessie/chroot/chroot.8.en.html?

The actual URL you should have used is
https://manpages.debian.org/jessie/coreutils/chroot.8.en.html

The URL structure is
/<distribution_name>/<package_name>/<manual_page>. In the URI you
tried, the service tried to look for a chroot manpage in the chroot
package. But there is no chroot package (it is coreutils), thus the
error you received.

Best regards


Javier

[Paul Wise]

Post by Javier Fernandez-Sanguino
The redirector tries to find the "best" manpage and forwards you to
that one. Unfortunatley, this seems to be a bug in the
manpages-es-extra manpage, which provides a chroot manpage in section
1 (instead of section 8, where it should be), and confuses the
redirector.

That still sounds like a bug in the redirector, it should not prefer a
Spanish manual page when English is the only requested language.

[Michael Stapelberg]

It doesn’t unconditionally prefer Spanish pages over English pages. What
you’re seeing is that it picks a section first (1 instead of 8, in this
case) and sticks to it. In section 1, the best match for an English request
is the Spanish page, because there is no English page.

The rationale behind this logic is that it’s better to serve the manpage of
the correct section, even if the language doesn’t match. If the user
requested e.g. crontab(5), they won’t be happy with crontab(1) only because
there is a crontab(1) version in their preferred language.

Post by Paul Wise

Post by Javier Fernandez-Sanguino
The redirector tries to find the "best" manpage and forwards you to
that one. Unfortunatley, this seems to be a bug in the
manpages-es-extra manpage, which provides a chroot manpage in section
1 (instead of section 8, where it should be), and confuses the
redirector.

That still sounds like a bug in the redirector, it should not prefer a
Spanish manual page when English is the only requested language.
--
bye,
pabs
https://wiki.debian.org/PaulWise

[Paul Wise]

It doesn’t unconditionally prefer Spanish pages over English pages. What
you’re seeing is that it picks a section first (1 instead of 8, in this
case) and sticks to it. In section 1, the best match for an English request
is the Spanish page, because there is no English page.
The rationale behind this logic is that it’s better to serve the manpage of
the correct section, even if the language doesn’t match. If the user
requested e.g. crontab(5), they won’t be happy with crontab(1) only because
there is a crontab(1) version in their preferred language.

In this case the user hasn't selected a section, so it seems like a
bug to choose a section for them.

[Michael Stapelberg]

It’s definitely not a bug to choose a section for the user, since we can’t
serve pages without choosing :).

What you’re trying to say is that section choice should happen after
language matching. This might work. I’ve filed
https://github.com/Debian/debiman/issues/63 for it.

Post by Paul Wise

Post by Michael Stapelberg
It doesn’t unconditionally prefer Spanish pages over English pages. What
you’re seeing is that it picks a section first (1 instead of 8, in this
case) and sticks to it. In section 1, the best match for an English

request

Post by Michael Stapelberg
is the Spanish page, because there is no English page.
The rationale behind this logic is that it’s better to serve the manpage

of

Post by Michael Stapelberg
the correct section, even if the language doesn’t match. If the user
requested e.g. crontab(5), they won’t be happy with crontab(1) only

because

Post by Michael Stapelberg
there is a crontab(1) version in their preferred language.

In this case the user hasn't selected a section, so it seems like a
bug to choose a section for them.
--
bye,
pabs
https://wiki.debian.org/PaulWise