> -    <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.

-Rasmus

Reply via email to