Date: Tue, 12 Aug 2008 13:46:07 -0700 (PDT) From: "Ronald F.Guilmette" <rfg@tristatelogic.com> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/126484: libc function res-zonscut2 is not documented Message-ID: <20080812204607.56587BDC36@segfault.tristatelogic.com> Resent-Message-ID: <200808122050.m7CKo1Y6064351@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 126484 >Category: docs >Synopsis: libc function res-zonscut2 is not documented >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue Aug 12 20:50:01 UTC 2008 >Closed-Date: >Last-Modified: >Originator: Ronald F. Guilmette >Release: FreeBSD 7.0-RELEASE i386 >Organization: Infinite Monkeys & Co. LLC >Environment: System: FreeBSD 7.0-RELEASE >Description: The resolver library routine called res_findzonecut2 which is part of libc isn't documented on any man page... at least none that I've found. But this is a useful function, and should have a man page. >How-To-Repeat: man res_findzonecut2 man res_findzonecut man 3 resolver (The first two commands above just produce errors. The third shows that the man page which documents all of the other res_* resolver library routines fails to even mention res_findzonecut. >Fix: The man page for resolver(3) should be enhanced so as to also document res_findzonecut2. Depending on how the folks at IBM feel about it, you could probably just snatch most of the verbage necessary to document this function from the following URL: http://publib.boulder.ibm.com/infocenter/iseries/v5r3/index.jsp?topic=/apis/resfindzonecut.htm ...where IBM seems to have already done a pretty Nice Job of documenting the original res_findzonecut function. Note however that in the res_findzonecut2 function, the 7th parameter has type (union res_sockaddr_union *) rather than type (struct in_addr *) as for the original function, res_findzonecut. >Release-Note: >Audit-Trail: >Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20080812204607.56587BDC36>