Re: [PATCH/RFC] resolver_r.3: New page documenting res_ninit() et al

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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
>
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux