Bug 264036 - Man page interface is broken
Summary: Man page interface is broken
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Website (show other bugs)
Version: Latest
Hardware: Any Any
: Normal Affects Many People
Assignee: Wolfram Schneider
URL:
Keywords:
: 262778 (view as bug list)
Depends on:
Blocks:
 
Reported: 2022-05-17 03:45 UTC by Greg Lehey
Modified: 2022-05-18 00:40 UTC (History)
2 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Greg Lehey freebsd_committer freebsd_triage 2022-05-17 03:45:26 UTC
The man page search does not work correctly.  A search for (in my case) geom or glabel fails, gpart is redirected to a man page for gmap ("Scotch user's manual").  In each case the selection is "FreeBSD 13.1-RELEASE and Ports", and while this can be overridden, the web interface forces it, so https://www.freebsd.org/cgi/man.cgi?query=gpart&apropos=0&sektion=0&manpath=FreeBSD%2b13.0-RELEASE&arch=default&format=html (which works) is automatically changed to https://www.freebsd.org/cgi/man.cgi?query=glabel&apropos=0&sektion=8&manpath=FreeBSD%2b13.0&arch=default&format=html
Comment 1 Wolfram Schneider freebsd_committer freebsd_triage 2022-05-17 09:01:50 UTC
There was a missing symlink on the server after 13.1-RELEASE came out. No system manual pages where found. I fixed it, please try it again.
Comment 2 Wolfram Schneider freebsd_committer freebsd_triage 2022-05-17 09:03:37 UTC
There are manual pages for "FreeBSD 13.0-RELEASE", "FreeBSD ports r13.0-RELEASE", and both "FreeBSD 13.0-RELEASE and Ports".

By default we offer both. This was on popular demand, most users expected the system and the ports manual pages together.

In your example gpart(1) (aka gmap) from the ports manual pages wins because section "1" is higher ranked than section "8"

see
https://www.freebsd.org/cgi/man.cgi?query=gpart&apropos=0&sektion=8&manpath=FreeBSD+13.0-RELEASE+and+Ports&arch=default&format=html
Comment 3 Graham Perrin freebsd_committer freebsd_triage 2022-05-17 18:32:11 UTC
See also: bug 262778
Comment 4 Glen Barber freebsd_committer freebsd_triage 2022-05-17 18:37:50 UTC
*** Bug 262778 has been marked as a duplicate of this bug. ***
Comment 5 Greg Lehey freebsd_committer freebsd_triage 2022-05-18 00:37:47 UTC
Thanks for the quick response.  A couple of points:

1. Yes, it now "works for me", as long as I specify the section.

2. The response doesn't address the fact that some man pages can't be found with the defaults.  I've added bug 263797 to discuss this matter.
Comment 6 Greg Lehey freebsd_committer freebsd_triage 2022-05-18 00:40:12 UTC
Thanks for the quick response.  A couple of points:

1. Yes, it now "works for me", as long as I specify the section.

2. The response doesn't address the fact that some man pages can't be found with the defaults.  I've added bug 264054 to discuss this matter.