Re: misc/57116: misleading description about timeout in poll man page

[mlelstv%serpens.de@localhost (Michael van Elst)]

The following reply was made to PR misc/57116; it has been noted by GNATS.

From: mlelstv%serpens.de@localhost (Michael van Elst)
To: gnats-bugs%netbsd.org@localhost
Cc: 
Subject: Re: misc/57116: misleading description about timeout in poll man page
Date: Sun, 18 Dec 2022 09:51:26 -0000 (UTC)

 yamt9999%gmail.com@localhost writes:
 
 >> If timeout is neither zero nor INFTIM (-1), it specifies a maximum
 >> inter-val to wait for any file descriptor to become ready, in
 >> milliseconds.
 
 >the text makes me think "it's ok to round it down".
 >but i believe it's the opposite.
 >ie. it's ok to sleep longer. but it isn't ok to sleep shorter.
 
 It does not talk about timer resolution or whatever side effects
 make your program delay but about the poll(2) functionality, i.e.
 wait for a descriptor to become ready but don't wait more than the
 specified timeout.
 
 You could copy the BUGS section from nanosleep(2).