Date: Mon, 15 Sep 1997 12:38:44 +0200 (MET DST) From: Luigi Rizzo <luigi@labinfo.iet.unipi.it> To: bde@zeta.org.au (Bruce Evans) Cc: mike@smith.net.au, cvs-all@FreeBSD.ORG, cvs-committers@FreeBSD.ORG, cvs-sys@FreeBSD.ORG, jmg@FreeBSD.ORG Subject: Re: cvs commit: src/sys/i386/isa/snd - Imported sources Message-ID: <199709151038.MAA02405@labinfo.iet.unipi.it> In-Reply-To: <199709150922.TAA08480@godzilla.zeta.org.au> from "Bruce Evans" at Sep 15, 97 07:22:19 pm
next in thread | previous in thread | raw e-mail | index | archive | help
> >I am trying to figure out the difference between select and poll,
> >it does not appear to be anything substantial, i.e. just a change
> >in arguments in ("events" instead of "rw") and out ("revents"
> >instead of 0/1). Is there any documentation somewhere ?
>
> There are many examples in *.c.
The initial reason why I used FreeBSD was that it was _documented_ in
the 4.3 BSD book, and now 4.4 BSD book. I can study how a kernel
mechanism or interface is supposed to work, compare the description in
the book with actual code samples, etc.
Code alone is not enough, it might be broken and what is worse, people
might use it as a reference and duplicate it.
As an example, the select->poll change to asc.c has a missing
return (revents)
in this case it is relatively easy to spot it out but this is not
always the case.
Documentation is of fundamental importance, especially for basic
mechanisms of large use.
> selrecord() is a BSD4.4Lite interface. The above drivers apparently
> haven't been converted to it yet.
I have just filed a PR :)
Cheers
Luigi
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199709151038.MAA02405>