From owner-freebsd-hackers@freebsd.org Sat Apr 18 18:22:50 2020 Return-Path: Delivered-To: freebsd-hackers@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id EF16A2A98B6 for ; Sat, 18 Apr 2020 18:22:50 +0000 (UTC) (envelope-from eugen@grosbein.net) Received: from mailman.nyi.freebsd.org (unknown [127.0.1.3]) by mx1.freebsd.org (Postfix) with ESMTP id 494Lt23VYxz4fqG for ; Sat, 18 Apr 2020 18:22:50 +0000 (UTC) (envelope-from eugen@grosbein.net) Received: by mailman.nyi.freebsd.org (Postfix) id 7810D2A98B4; Sat, 18 Apr 2020 18:22:50 +0000 (UTC) Delivered-To: hackers@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 77D692A98B3 for ; Sat, 18 Apr 2020 18:22:50 +0000 (UTC) (envelope-from eugen@grosbein.net) Received: from hz.grosbein.net (hz.grosbein.net [IPv6:2a01:4f8:c2c:26d8::2]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "hz.grosbein.net", Issuer "hz.grosbein.net" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 494Lt10LmFz4fqD for ; Sat, 18 Apr 2020 18:22:48 +0000 (UTC) (envelope-from eugen@grosbein.net) Received: from eg.sd.rdtc.ru (eg.sd.rdtc.ru [IPv6:2a03:3100:c:13:0:0:0:5]) by hz.grosbein.net (8.15.2/8.15.2) with ESMTPS id 03IIMYXn087162 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Sat, 18 Apr 2020 18:22:35 GMT (envelope-from eugen@grosbein.net) X-Envelope-From: eugen@grosbein.net X-Envelope-To: phk@phk.freebsd.dk Received: from [10.58.0.10] (dadvw [10.58.0.10]) by eg.sd.rdtc.ru (8.15.2/8.15.2) with ESMTPS id 03IIMYH5033942 (version=TLSv1.2 cipher=DHE-RSA-AES128-SHA bits=128 verify=NOT); Sun, 19 Apr 2020 01:22:34 +0700 (+07) (envelope-from eugen@grosbein.net) Subject: Re: orphan .Xr in manual pages To: Poul-Henning Kamp , hackers@freebsd.org References: <30493.1586018580@critter.freebsd.dk> From: Eugene Grosbein Message-ID: <430119cd-2ef1-75c8-4922-c9f47d026880@grosbein.net> Date: Sun, 19 Apr 2020 01:22:28 +0700 User-Agent: Mozilla/5.0 (Windows NT 6.3; WOW64; rv:45.0) Gecko/20100101 Thunderbird/45.8.0 MIME-Version: 1.0 In-Reply-To: <30493.1586018580@critter.freebsd.dk> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=0.3 required=5.0 tests=BAYES_00,LOCAL_FROM, SPF_HELO_NONE,SPF_PASS autolearn=no autolearn_force=no version=3.4.2 X-Spam-Report: * -2.3 BAYES_00 BODY: Bayes spam probability is 0 to 1% * [score: 0.0000] * 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record * -0.0 SPF_PASS SPF: sender matches SPF record * 2.6 LOCAL_FROM From my domains X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on hz.grosbein.net X-Rspamd-Queue-Id: 494Lt10LmFz4fqD X-Spamd-Bar: --- Authentication-Results: mx1.freebsd.org; dkim=none; dmarc=none; spf=permerror (mx1.freebsd.org: domain of eugen@grosbein.net uses mechanism not recognized by this client) smtp.mailfrom=eugen@grosbein.net X-Spamd-Result: default: False [-3.98 / 15.00]; ARC_NA(0.00)[]; NEURAL_HAM_MEDIUM(-1.00)[-1.000,0]; FROM_HAS_DN(0.00)[]; TO_DN_SOME(0.00)[]; NEURAL_HAM_LONG(-1.00)[-1.000,0]; MIME_GOOD(-0.10)[text/plain]; DMARC_NA(0.00)[grosbein.net]; RCVD_COUNT_THREE(0.00)[3]; TO_MATCH_ENVRCPT_SOME(0.00)[]; R_SPF_PERMFAIL(0.00)[]; RCPT_COUNT_TWO(0.00)[2]; IP_SCORE(-1.88)[ip: (-5.23), ipnet: 2a01:4f8::/29(-2.63), asn: 24940(-1.53), country: DE(-0.02)]; FROM_EQ_ENVFROM(0.00)[]; R_DKIM_NA(0.00)[]; MIME_TRACE(0.00)[0:+]; ASN(0.00)[asn:24940, ipnet:2a01:4f8::/29, country:DE]; MID_RHS_MATCH_FROM(0.00)[]; RCVD_TLS_ALL(0.00)[] X-BeenThere: freebsd-hackers@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Technical Discussions relating to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 18 Apr 2020 18:22:51 -0000 04.04.2020 23:43, Poul-Henning Kamp пишет: > I saw opencsd flitter by in the output of buildworld, so I did > apropos(1), found tcsd(8) which cross-references to tcsd.conf(5) > which doesn't seem to get installed. > > Similar annoyances have happened a couple of times in recent > months, so while I waited for the buildworld to complete, I > threw together a small script to report orphan .Xr's in the > manual pages (attached). > > It transpires we have a lot of those, and from basic principles > of POLA, that is bad. > > Some of them are typo-ish, Xr'ing zfs(1) instead of zfs(8) > > Some of them point to stuff in ports, for instance dma(8) -> postfix(1), > which I guess is semi-sensible, but maybe they should say which port ? > > But a LOT of them are simply bogus. > > List from a pretty virgin 12.1 system here: [skip] > ./man8/mdconfig.8 .Xr vnconfig 8 not found How should we deal with similar historic cases? HISTORY The mdconfig utility first appeared in FreeBSD 5.0 as a cleaner replacement for the vn(4) and vnconfig(8) combo. For now, vn(4) is an alias for md(4) and vnconfig(8) is an alias for mdconfig(8), so they are not exactly "broken links".