Re: lib/60793: libwrap documentation may need updating

["Valery Ushakov via gnats" <gnats-admin%NetBSD.org@localhost>]

The following reply was made to PR lib/60793; it has been noted by GNATS.

From: Valery Ushakov <uwe%stderr.spb.ru@localhost>
To: gnats-bugs%netbsd.org@localhost
Cc: 
Subject: Re: lib/60793: libwrap documentation may need updating
Date: Wed, 30 Sep 2026 01:58:49 +0300

 The man page is part of the package (it's written in old classic man,
 not mandoc), so it is better handled upstream.
 
 On Fri, Sep 25, 2026 at 20:45:01 +0000, he%NetBSD.org@localhost via gnats wrote:
 
 > 	1) the hosts_access(3) man page does not mention which library
 > 	   should be used (-lwrap)
 
 It's literally the first sentence :)
 
   | DESCRIPTION
   |   The routines described in this document are part of the libwrap.a
 
 
 Since the man page comes from upstream and is no in mdoc, it doesn't
 follow our convention of using LIBRARY section.
 
 
 > 	2) The hosts_access(3) man page refers to "tcpd.h".  Should that
 > 	   not be <tcpd.h>?
 
 Probably, but that doesn't matter too much.
 
 
 > 	3) Among all the symbols referred to in <tcpd.h> as globbal
 > 	   variables, "allow_severity" and "deny_severity" do not appear
 > 	   to have a definition in libwrap.a:
 
 This should be supplied by the program.  The man page says:
 
   | The allow_severity and deny_severity variables determine how
   | accepted and rejected requests may be logged.  They must be
   | provided by the caller and may be modified by rules in the access
   | control tables.
 
 
 So I'd really say all these are not bugs.
 
 -uwe