> > - <para> > > - On exit, the arrays are modified to indicate which socket resource > > - actually changed status. > > - </para> > > + <warning> > > + <para> > > + On exit, the arrays are modified to indicate which socket resource > > + actually changed status. > > + </para> > > + </warning> > > If only this was actually true. This doesn't adequately describe how it > works at all. Something more along the lines of: > > On exit, the arrays will only contain the socket resources that actually > changed status. You will therefore have to maintain a copy of the > original array for any subsequent calls to socket_select(). > > But, I don't suggest documenting it this way because I think it is a > horrible interface.
Anyway, it should be documented how it works. It's not up to us how it works, it's a devel stuff. IMHO it's written to work this way, so it should be documented, that it works this way. Goba
