Hi, I believe the attached file is the page I converted from libbind docs for resolver.3; I had to spend some time looking for it. It's been 5 years, so I don't remember too many details, so please don't be too harsh :). I lifted and converted the man page from BIND 8.2.3, which was quite recent at the time (and I don't think the API changed much until 8.4.x). Thanks, Stefan. On Mon, Jul 4, 2011 at 12:48 PM, Stefan Puiu <stefan.puiu@xxxxxxxxx> wrote: > Hi, > > On Mon, Jul 4, 2011 at 12:37 PM, Jonathan Nieder <jrnieder@xxxxxxxxx> wrote: > [...] >>> Ages ago I >>> stole the info from their resolver.3 page and merged it with the page >>> distributed with glibc (the current version is taken from there as >>> well, IIRC). The patch got somehow lost through the cracks, I think... >>> >>> Or do you see any licensing issues with doing that? >> >> libbind's manpages are permissively (ISC) licensed and so pretty much >> hassle-free to reuse. Could you send a link or other pointer (e.g., >> message-id) to your patch? > > That was before there was a linux-man mailing list; I still have > Michael's replies, but apparently I don't the one I sent. I will check > my home computer, maybe I have a copy of it there. I'll get back with > a reply if I manage to find it. > > On re-reading Michael's replies, I see there was a problem with the > format of the man pages - the one from libbind is using mdoc, while > the one in man-pages uses the newer man(7) format. Just a heads up. > >> >>> OTOH, if you want to keep your approach and add another page for the >>> reentrant functions, you might want to add a pointer in resolver.3 so >>> people know there's another page as well :). >> >> I snuck in a link in the SEE ALSO section. If you have ideas for >> where to broach the subject elsewhere (maybe in the paragraph >> discussing _res?), I'd be happy to take them. :) > > Maybe at the beginning you could say that the man page documents only > the non-reentrant functions? OTOH, as far as I can make of the old > email exchange, the current man page is based on what BIND > 4.9.something was shipping, probably before anybody started thinking > about multithreading :). > >> >> Thanks for looking it over. >> Jonathan >> >
Attachment:
resolver.3
Description: Binary data
