Add documentation to blocked.

Author: ioquatix

ext/io/event/selector/epoll.c

@@ -38,6 +38,10 @@ struct IO_Event_Selector_EPoll
 {
 	struct IO_Event_Selector backend;
 	int descriptor;
+	
+	// Flag indicating whether the selector is currently blocked in a system call.
+	// Set to 1 when blocked in epoll_wait() without GVL, 0 otherwise.
+	// Used by wakeup() to determine if an interrupt signal is needed.
 	int blocked;
 
 	struct timespec idle_duration;

ext/io/event/selector/kqueue.c

@@ -47,6 +47,10 @@ struct IO_Event_Selector_KQueue
 {
 	struct IO_Event_Selector backend;
 	int descriptor;
+	
+	// Flag indicating whether the selector is currently blocked in a system call.
+	// Set to 1 when blocked in kevent() without GVL, 0 otherwise.
+	// Used by wakeup() to determine if an interrupt signal is needed.
 	int blocked;
 
 	struct timespec idle_duration;

ext/io/event/selector/uring.c

@@ -30,6 +30,10 @@ struct IO_Event_Selector_URing
 	struct IO_Event_Selector backend;
 	struct io_uring ring;
 	size_t pending;
+	
+	// Flag indicating whether the selector is currently blocked in a system call.
+	// Set to 1 when blocked in io_uring_wait_cqe_timeout() without GVL, 0 otherwise.
+	// Used by wakeup() to determine if an interrupt signal is needed.
 	int blocked;
 
 	struct timespec idle_duration;

lib/io/event/selector/select.rb

@@ -17,6 +17,9 @@ def initialize(loop)
 
 				@waiting = Hash.new.compare_by_identity
 
+				# Flag indicating whether the selector is currently blocked in a system call.
+				# Set to true when blocked in ::IO.select, false otherwise.
+				# Used by wakeup() to determine if an interrupt signal is needed.
 				@blocked = false
 
 				@ready = Queue.new