From f9053f38e5ca29c23d2328ed06293727cd1fe8d4 Mon Sep 17 00:00:00 2001
From: Andrew Kelley <andrew@ziglang.org>
Date: Fri, 20 Feb 2026 16:57:48 -0800
Subject: [PATCH] std.Io.Select: add documentation

---
 lib/std/Io.zig | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/lib/std/Io.zig b/lib/std/Io.zig
index 6d8fbc4536..6eea9789b4 100644
--- a/lib/std/Io.zig
+++ b/lib/std/Io.zig
@@ -1173,10 +1173,19 @@ pub fn checkCancel(io: Io) Cancelable!void {
     return io.vtable.checkCancel(io.userdata);
 }
 
+/// Executes tasks together, providing a mechanism to wait until one or more
+/// tasks complete. Similar to `Batch` but operates at the higher level task
+/// abstraction layer rather than lower level `Operation` abstraction layer.
+///
+/// The provided tagged union will be used as the return type of the await
+/// function. When calling async or concurrent, one specifies which union field
+/// the called function's result will be placed into upon completion.
 pub fn Select(comptime U: type) type {
     return struct {
         io: Io,
         group: Group,
+        /// The queue is never closed because there may be live resources
+        /// inserted into it which would otherwise leak.
         queue: Queue(U),
 
         const S = @This();