docs/126484: libc function res-zonscut2 is not documented

[Ronald F.Guilmette]

>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: