Add new warning about sleep's limitation on Windows

This also came up recently in [perl #33096]. On Windows, sleep's unsigned
int argument range is effectively reduced by a factor of 1000 because the
emulation uses milliseconds rather than seconds.

1 files changed, 6 insertions, 0 deletions

diff --git a/pod/perldiag.pod b/pod/perldiag.pod
index e579b11f54..fee150635d 100644
--- a/pod/perldiag.pod
+++ b/pod/perldiag.pod
@@ -4499,6 +4499,12 @@ Perhaps you put it into the wrong package?
 internal bookkeeping of op trees.  An op tree needed to be freed after
 a compilation error, but could not be found, so it was leaked instead.
 
+=item sleep(%u) too large
+
+(W overflow) You called C<sleep> with a number that was larger than
+it can reliably handle and C<sleep> probably slept for less time than
+requested.
+
 =item Smart matching a non-overloaded object breaks encapsulation
 
 (F) You should not use the C<~~> operator on an object that does not