Date: Wed, 18 May 2022 00:36:22 +0000 From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 264054] Man page display on web site is confusing Message-ID: <bug-264054-9@https.bugs.freebsd.org/bugzilla/>
next in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D264054 Bug ID: 264054 Summary: Man page display on web site is confusing Product: Documentation Version: Latest Hardware: Any OS: Any Status: New Severity: Affects Many People Priority: --- Component: Website Assignee: doc@FreeBSD.org Reporter: grog@FreeBSD.org This is a resubmission of part of https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D264036 Currently the man page choice on the web site (https://www.freebsd.org/cgi/man.cgi) defaults to =E2=80=9D13-1-RELEASE and= Ports=E2=80=9D.=20 This causes several issues, illustrated by a search for the man page gpart(= 8): 1. Ports can have priority over the base system, so unless the person searc= hing for a man page in the base system knows the section number, he could end up with the man page for a port. 2. There's no way for the user to know which port he has found. In this example, the man page carries the title =E2=80=9CScotch user's manual=E2=80= =9D, but that's the only clue. 3. There's no way for the user to know that there are more man pages with t= he same name in different sections. My suggestion: 1. In the short term, update the man page display to explain this situatio= n, something like There may be more than one man page with this name. If you don't find what you're looking for, try 13.1-RELEASE without ports, or try selecting a specific section of the manual. 2. Longer term, rearrange the priorities: base system first, then ports. 3. When displaying port man pages, include information on the name of the port. --=20 You are receiving this mail because: You are the assignee for the bug.=
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-264054-9>