Hi Nanno, On Mon, Jan 19, 2009 at 1:09 PM, Nanno Langstraat <nlcom_os@xxxxx> wrote: > Michael Kerrisk wrote: >> The version of the page that is currently committed for release in >> man-pages-3.17 is shown below. Let me know if you see anything >> that needs fixing. >> >> .SH "CONFORMING TO" >> These functions are non-standard, but present on the BSDs, >> where the required header file is >> .I <sys/endian.h> >> instead of >> .IR <endian.h> . >> > > Alright, so it turns out that this is not accurate because of Ulrich > Drepper's beNtoh() versus OpenBSD's betohN() deviation. Yes, see my previous mail. > (and FreeBSD into the mix is even more muddled: they got an earful from > Theo de Raadt over this issue) Muddled in what sense? (See my comparisons of the names below.) > Suggestion: > > .SH "CONFORMING TO" > These functions are non-standard. The BSDs contain similar but not wholly identical functions in header file > .I <sys/endian.h> > (instead of glibc's > .IR <endian.h> ). Unless I've missed something, the situtation seems to be this: * FreeBSD, NetBSD, and glibc all use *exactly) the same naming convention, so that they have, e.g., le16toh. * OpenBSD uses a different convention, so that they have, e.g., letoh16. (This naming convention seems to me a little more sensible.) I'm guessing that the order of events went like this: 1) OpenBSD provided the first implementation. 2) the other BSDs added the interfaces but changed the naming convention. 3) Ulrich Drepper opted to follow FreeBSD's naming convention (which seems a reasonable thing to do, given that that is the dominat BSD). Do you know if that is the order in which things happened? Cheers, Michael > It grates that this mealy-mouthed text is longer than the source changes > required to fix the differences, but hey. > > Nanno > > -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ git://git.kernel.org/pub/scm/docs/man-pages/man-pages.git man-pages online: http://www.kernel.org/doc/man-pages/online_pages.html Found a bug? http://www.kernel.org/doc/man-pages/reporting_bugs.html -- 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
