From owner-freebsd-doc@FreeBSD.ORG Tue Aug 12 20:50:01 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id EAEA0106564A for ; Tue, 12 Aug 2008 20:50:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id D2D418FC1F for ; Tue, 12 Aug 2008 20:50:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.2/8.14.2) with ESMTP id m7CKo1lr064352 for ; Tue, 12 Aug 2008 20:50:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.2/8.14.1/Submit) id m7CKo1Y6064351; Tue, 12 Aug 2008 20:50:01 GMT (envelope-from gnats) Resent-Date: Tue, 12 Aug 2008 20:50:01 GMT Resent-Message-Id: <200808122050.m7CKo1Y6064351@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, "Ronald F.Guilmette" Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id DEEB9106564A for ; Tue, 12 Aug 2008 20:46:08 +0000 (UTC) (envelope-from rfg@tristatelogic.com) Received: from segfault-outgoing-helo.tristatelogic.com (112.171-60-66-fuji-dsl.static.surewest.net [66.60.171.112]) by mx1.freebsd.org (Postfix) with ESMTP id BE0728FC14 for ; Tue, 12 Aug 2008 20:46:08 +0000 (UTC) (envelope-from rfg@tristatelogic.com) Received: by segfault.tristatelogic.com (Postfix, from userid 1237) id 56587BDC36; Tue, 12 Aug 2008 13:46:07 -0700 (PDT) Message-Id: <20080812204607.56587BDC36@segfault.tristatelogic.com> Date: Tue, 12 Aug 2008 13:46:07 -0700 (PDT) From: "Ronald F.Guilmette" To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/126484: libc function res-zonscut2 is not documented X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: "Ronald F.Guilmette" List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 12 Aug 2008 20:50:02 -0000 >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: