NetBSD Problem Report #59030

From martin@aprisoft.de  Sat Jan 25 16:06:22 2025
Return-Path: <martin@aprisoft.de>
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)
	 key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256
	 client-signature RSA-PSS (2048 bits) client-digest SHA256)
	(Client CN "mail.NetBSD.org", Issuer "mail.NetBSD.org CA" (not verified))
	by mollari.NetBSD.org (Postfix) with ESMTPS id 090081A923B
	for <gnats-bugs@gnats.NetBSD.org>; Sat, 25 Jan 2025 16:06:21 +0000 (UTC)
Message-Id: <20250125160612.AA4805CC7DB@emmas.aprisoft.de>
Date: Sat, 25 Jan 2025 17:06:12 +0100 (CET)
From: martin@NetBSD.org
Reply-To: martin@NetBSD.org
To: gnats-bugs@NetBSD.org
Subject: mdnsd(8) needs a man page rewrite
X-Send-Pr-Version: 3.95

>Number:         59030
>Category:       bin
>Synopsis:       mdnsd(8) needs a man page rewrite
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    bin-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sat Jan 25 16:10:00 +0000 2025
>Originator:     Martin Husemann
>Release:        NetBSD 10.99.12
>Organization:
The NetBSD Foundation, Inc.
>Environment:
System: NetBSD big-apple.aprisoft.de 10.99.12 NetBSD 10.99.12 (POWERMAC_G5.MP) #123: Fri Jan 3 10:42:38 CET 2025 martin@seven-days-to-the-wolves.aprisoft.de:/work/src/sys/arch/macppc/compile/POWERMAC_G5.MP macppc
Architecture: powerpc
Machine: macppc
>Description:

Reading "man mdnsd" is not very helpfull, the document seems to be a very
generic description and does not answer most questions I would expect a
NetBSD man page to answer. Starting with the incorrect synopsis and
the statement that I (as a user) should not run mdnsd manually - but not
stating how it should be run at all, where [on what machine on my netwrok,
if that question even makes sense] and why.

It has pointers to lots of other documentation (some of them as URLs, some
only as phrases most likely unknown to the reader like "apple radar"),
but no valuable documentation in the page itself.

It does not point to the NetBSD specific integration or knobs/configurations
you might want to tune on NetBSD to make use of this software (rc.conf,
nsswitch.conf, whatever else is needed/usefull).

>How-To-Repeat:
read the man page.

>Fix:
n/a

Home	PR Database Search