[fpc-devel] request for a small but important addition to the docs

[Michael Schnell]

On 09/18/2013 10:30 AM, Thaddy wrote:
>
> Why document a given?
>

A timeout = 0 can mean either of

"Wait up to forever but return when something happens"   or

"Do what is to do and return at once even if there is nothing to do "    or

"Never Return. When something happens do the appropriate and go on 
waiting for the next"


I saw all three variants in some libraries.

Also sometimes a value of -1 or $FFFFFFFF denotes one of the three 
alternatives.



A "normal" number can mean:

"return if something happens or the timeout is hit"   or

"Stay in the function until the timeout is hit and during that time do 
what is to be done" (rather unusual but not completely senseless.)


-Michael
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.freepascal.org/pipermail/fpc-devel/attachments/20130918/6f19f0ab/attachment.html>