<html>
<head>
<meta content="text/html; charset=ISO-8859-1"
http-equiv="Content-Type">
</head>
<body bgcolor="#FFFFFF" text="#000000">
<div class="moz-cite-prefix">On 09/18/2013 10:30 AM, Thaddy wrote:<br>
</div>
<blockquote cite="mid:5239648E.7080900@thaddy.com" type="cite">
<meta content="text/html; charset=ISO-8859-1"
http-equiv="Content-Type">
<br>
Why document a given?<br>
<br>
</blockquote>
<br>
A timeout = 0 can mean either of<br>
<br>
"Wait up to forever but return when something happens" or <br>
<br>
"Do what is to do and return at once even if there is nothing to do
" or <br>
<br>
"Never Return. When something happens do the appropriate and go on
waiting for the next"<br>
<br>
<br>
I saw all three variants in some libraries.<br>
<br>
Also sometimes a value of -1 or $FFFFFFFF denotes one of the three
alternatives.<br>
<br>
<br>
<br>
A "normal" number can mean: <br>
<br>
"return if something happens or the timeout is hit" or<br>
<br>
"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.)<br>
<br>
<br>
-Michael<br>
</body>
</html>