Bug 248927

Summary: Manual page of port x11-wm/twm on www.freebsd.org/man.cgi displays incorrect system.twmrc path
Product: Services Reporter: Newton Terry <newton.ja.terry>
Component: FTP/WWW Sites & MirrorsAssignee: Wolfram Schneider <wosch>
Status: Closed FIXED    
Severity: Affects Many People CC: grembo, pi, x11
Priority: ---    
Version: unspecified   
Hardware: Any   
OS: Any   
URL: https://www.freebsd.org/cgi/man.cgi?query=twm&arch=default&format=html

Description Newton Terry 2020-08-26 10:31:06 UTC
The online twm(1) manual generated by man.cgi of port x11-wm/twm displays incorrect system.twmrc path in the FILES section:

FILES
       $HOME/.twmrc._screen number_
       $HOME/.twmrc
       /usr/local/lib/X11/twm/system.twmrc
                  ^^^

The path should be /usr/local/share/X11/twm/system.twmrc as correct displayed
                              ^^^^^
in the CUSTOMIZATION section.

https://www.freebsd.org/cgi/man.cgi?query=twm&arch=default&format=html

The twm(1) manual installed by the port on system displays for all system.twmrc occurrences the correct path.
Comment 1 Mark Linimon freebsd_committer freebsd_triage 2020-08-26 11:34:24 UTC
^Triage: change to Individual Ports.  The Manual Page classification is only for code from the FreeBSD base system (grep(1), fstab(5), and so on.)
Comment 2 Newton Terry 2020-08-26 13:41:28 UTC
There seems to be an misunderstanding due to a poor phrasing of the original summery on my part I suppose ( FreeBSD Manual Pages - man.cgi - Manual of port x11-wm/twm displays incorrect system.twmrc path ).


The manual page twm(1) of port x11-wm/twm, build and installed on a system, is NOT affected as the current summary suggests!


What affected is the cgi ( man.cgi script ) generated twm(1) online manual at https://www.freebsd.org/cgi/man.cgi?query=twm&arch=default&format=html. 

The issue is with the "FreeBSD Manual Pages" website, https://www.freebsd.org/cgi/man.cgi , not with the port.

Under these circumstances which "Product" and "Component" should be chosen?
Comment 3 Michael Gmelin freebsd_committer freebsd_triage 2020-08-26 14:07:08 UTC
This was corrected in the port in https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=246127 https://svnweb.freebsd.org/ports?view=revision&revision=533777 three months ago, so it's definitely on the quarterly branch by now.

So the question is:
- How often are man.cgi pages regenerated?
- What does that process look like (is it documented anywhere)?
Comment 4 Kurt Jaeger freebsd_committer freebsd_triage 2020-08-26 14:42:25 UTC
According to
https://www.freebsd.org/cgi/man.cgi/help.html
wosch knows more about the setup.
Comment 5 Kurt Jaeger freebsd_committer freebsd_triage 2020-08-26 14:46:46 UTC
The code for man.cgi is in en_US.ISO8859-1/htdocs/cgi/man.cgi.

So as soon as a new release is done, the script uses that release and ports tree for the results. As long as the update is not yet in any release, the old man page will be displayed.
Comment 6 Kurt Jaeger freebsd_committer freebsd_triage 2020-08-26 14:47:51 UTC
And: there's no page to display the manuals of the head of the ports tree or
from the quarterly tree.
Comment 7 Wolfram Schneider freebsd_committer freebsd_triage 2020-09-01 19:25:17 UTC
I just updated the ports manpages for 12.1-RELEASE