misc/60529: resolver(5) man page is badly out of date

[Pekka Savola]

>Number:         60529
>Category:       misc
>Synopsis:       resolver(5) man page is badly out of date
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Dec 23 11:10:16 PST 2003
>Closed-Date:
>Last-Modified:
>Originator:     Pekka Savola
>Release:        5.2-RC
>Organization:
-
>Environment:
FreeBSD gap.netcore.fi 5.2-RC FreeBSD 5.2-RC #2: Sun Dec 21 23:55:10 EET 2003     root at gap.netcore.fi:/usr/obj/usr/src/sys/GAP  i386

>Description:
resolver(5) aka resolv.conf(5) is extremely badly out of date.  The resolver code has been updated from Bind a number of times, but this particular piece of documentation has not been synced in a while.

See:
 resolver(3)
 src/contrib/bind/doc/man/resolver.5 (this is missing some stuff too, though)
 http://cvsweb.netbsd.org/bsdweb.cgi/src/share/man/man5/resolv.conf.5

In particular, the most important missing options are:
 - edns0 
 - insecure1
 - insecure2

>How-To-Repeat:
man 3 resolver
man 5 resolver
less /usr/src/lib/libc/net/res_init.c
nroff -mandoc /usr/src/contrib/bind/doc/man/resolver.5 | less
>Fix:
Sync up the descriptions, and add insecure1/insecure2/edns0.

(I would have made the patch, but I don't know what's the copyright policy because the boilerplates with local and bind's resolver.5 don't match...)
>Release-Note:
>Audit-Trail:
>Unformatted: