From a136890accfc3b269b6eaa9139bae829ef36cc6b Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Tue, 6 Jan 2026 14:49:22 -0800 Subject: [PATCH] std.Io.random: clarify doc comments --- lib/std/Io.zig | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/lib/std/Io.zig b/lib/std/Io.zig index f76bbbcb6e8c1bc6eca2eba776620b42b8621e26..1afef866013e645e41a169d03a2145e5ada85125 100644 --- a/lib/std/Io.zig +++ b/lib/std/Io.zig @@ -2246,13 +2246,14 @@ pub fn unlockStderr(io: Io) void { return io.vtable.unlockStderr(io.userdata); } -/// Obtains entropy. +/// Obtains entropy from a cryptographically secure pseudo-random number +/// generator. /// /// The implementation *may* store RNG state in process memory and use it to /// fill `buffer`. /// -/// The degree to which the entropy is cryptographically secure is determined -/// by the `Io` implementation. +/// The randomness is seeded by `randomSecure`, or a less secure mechanism upon +/// failure. /// /// Threadsafe. /// -- 2.54.0