NetBSD Problem Report #57347

From www@netbsd.org  Thu Apr 13 01:33:20 2023
Return-Path: <www@netbsd.org>
Received: from mail.netbsd.org (mail.netbsd.org [199.233.217.200])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	(Client CN "mail.NetBSD.org", Issuer "mail.NetBSD.org CA" (not verified))
	by mollari.NetBSD.org (Postfix) with ESMTPS id A36931A9239
	for <gnats-bugs@gnats.NetBSD.org>; Thu, 13 Apr 2023 01:33:20 +0000 (UTC)
Message-Id: <20230413013319.860C81A923A@mollari.NetBSD.org>
Date: Thu, 13 Apr 2023 01:33:19 +0000 (UTC)
From: jspath55@gmail.com
Reply-To: jspath55@gmail.com
To: gnats-bugs@NetBSD.org
Subject: Several man pages have obsolete file location references under /usr/share/doc
X-Send-Pr-Version: www-1.0

>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:    dholland
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Thu Apr 13 01:35:00 +0000 2023
>Last-Modified:  Thu Apr 13 02:30:01 +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:/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

>Release-Note:

>Audit-Trail:

Responsible-Changed-From-To: misc-bug-people->dholland
Responsible-Changed-By: mrg@NetBSD.org
Responsible-Changed-When: Thu, 13 Apr 2023 02:30:01 +0000
Responsible-Changed-Why:
David asked to be assigned this PR.


>Unformatted:

Home	PR Database Search