_queue: correct SIGNAL_CHECK_INTERVAL doc comment

sigmaith · sigmaith · commit 256f2011f738 · 2026-07-12T11:45:20.000+09:00
The old comment claimed this mirrors CPython's PyThread_acquire_lock_timed,
but CPython doesn't chunk its wait either -- it makes one sem_timedwait call
and relies on the OS reporting EINTR. parking_lot's Condvar has no equivalent
signal to surface, so polling is a workaround for that gap, not a mirror of
CPython's approach.

Assisted-by: Claude
diff --git a/crates/stdlib/src/_queue.rs b/crates/stdlib/src/_queue.rs
@@ -31,8 +31,8 @@ mod _queue {
 
     const INITIAL_RING_BUF_CAPACITY: usize = 8;
 
-    /// Wait chunk size so blocking waits stay responsive to signals, mirroring
-    /// CPython's `PyThread_acquire_lock_timed`.
+    /// `parking_lot`'s `Condvar` doesn't expose a mid-wait signal to us (unlike
+    /// CPython's raw `sem_timedwait`, which reports `EINTR`), so we poll instead.
     #[cfg(feature = "threading")]
     const SIGNAL_CHECK_INTERVAL: Duration = Duration::from_millis(50);
 
