misc/57347: Several man pages have obsolete file location references under /usr/share/doc

[jspath55%gmail.com@localhost]

>Number:         57347
>Category:       misc
>Synopsis:       Several man pages have obsolete file location references under /usr/share/doc
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Thu Apr 13 01:35:00 +0000 2023
>Originator:     Jim Spath
>Release:        10.0_BETA
>Organization:
>Environment:
NetBSD notabene 10.0_BETA NetBSD 10.0_BETA (GENERIC64) #0: Fri Jan 13 19:15:32 UTC 2023  mkrepro%mkrepro.NetBSD.org@localhost:/usr/src/sys/arch/evbarm/compile/GENERIC64 evbarm

>Description:
I found the man page for atf includes file references to previous locations. Apparently the "big reorg" of 2014 (src/share/doc/README.docdirs) left some behind, or they have migrated from elsewhere.

Example sources of interest:

"For more details on this subject, please see:
.Bd -literal -offset indent
.Pa /usr/share/doc/atf/NEWS
.Pa /usr/share/doc/atf/ROADMAP

.Bd -literal -offset indent
.Pa /usr/share/doc/atf/AUTHORS"

Current locations:
/usr/share/doc/reference/ref1/atf/

Complete list I found:

$ grep -in ".Pa /usr/share/doc" man*/* |grep -v /usr/share/doc/reference/
man4/options.4:1408:.Pa /usr/share/doc/html/ntp .
man5/mk.conf.5:410:.Sy DESTDIR Ns Pa /usr/share/doc
man5/ntp.conf.5:56:.Pa /usr/share/doc/ntp )
man5/ntp.conf.5:198:.Pa /usr/share/doc/ntp ) .
man5/ntp.conf.5:361:.Pa /usr/share/doc/ntp )
man5/ntp.conf.5:1448:.Pa /usr/share/doc/ntp ) .
man5/ntp.conf.5:2134:.Pa /usr/share/doc/ntp ) .
man5/ntp.conf.5:2143:.Pa /usr/share/doc/ntp ) .
man5/ntp.conf.5:2150:.Pa /usr/share/doc/ntp ) .
man5/ntp.conf.5:2160:.Pa /usr/share/doc/ntp ) .
man5/ntp.conf.5:2228:.Pa /usr/share/doc/ntp )
man5/ntp.conf.5:2306:.Pa /usr/share/doc/ntp )
man5/ntp.conf.5:2386:.Pa /usr/share/doc/ntp ) .
man5/ntp.conf.5:2396:.Pa /usr/share/doc/ntp ).
man5/ntp.conf.5:3284:.Pa /usr/share/doc/ntp .
man7/atf.7:74:.Pa /usr/share/doc/atf/COPYING
man7/atf.7:183:.Pa /usr/share/doc/atf/NEWS
man7/atf.7:184:.Pa /usr/share/doc/atf/ROADMAP
man7/atf.7:191:.Pa /usr/share/doc/atf/AUTHORS
man8/ntpd.8:638:.Pa /usr/share/doc/ntp ) .
man8/ntpd.8:843:.Pa /usr/share/doc/ntp .
man8/ntpdc.8:691:.Pa /usr/share/doc/ntp )
man8/ntptime.8:23:.Pa /usr/share/doc/html/ntp/kern.html .

Checks:

$ ls  /usr/share/doc/html/ntp
ls: /usr/share/doc/html/ntp: No such file or directory

$ ls  /usr/share/doc/ntp
ls: /usr/share/doc/ntp: No such file or directory

$ ls -l /usr/share/doc/html/ntp/kern.html
ls: /usr/share/doc/html/ntp/kern.html: No such file or directory

>How-To-Repeat:
For example:

$ man atf 
>Fix:
Source doc changes to match current locations