bin/59030: mdnsd(8) needs a man page rewrite

[martin%NetBSD.org@localhost]

>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@localhost:/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