diff --git a/lib/std/mem/Allocator.zig b/lib/std/mem/Allocator.zig
index 1d1653d3a0..72581236e6 100644
--- a/lib/std/mem/Allocator.zig
+++ b/lib/std/mem/Allocator.zig
@@ -303,7 +303,8 @@ fn allocBytesWithAlignment(
 /// It is guaranteed to not move the pointer, however the allocator
 /// implementation may refuse the resize request by returning `false`.
 ///
-/// `allocation` may be an empty slice, in which case a new allocation is made.
+/// `allocation` may be an empty slice, in which case `false` is returned,
+/// unless `new_len` is also 0, in which case `true` is returned.
 ///
 /// `new_len` may be zero, in which case the allocation is freed.
 pub fn resize(self: Allocator, allocation: anytype, new_len: usize) bool {