From 028af92ce3876ce1627163ce777f516b8218b410 Mon Sep 17 00:00:00 2001
From: Uzair Aftab <git@uzaaft.me>
Date: Mon, 31 Aug 2026 16:27:38 +0200
Subject: [PATCH] terminal: clarify page allocator fallback

---
 src/terminal/PageList.zig | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/terminal/PageList.zig b/src/terminal/PageList.zig
index 9f013608b..1e818efcf 100644
--- a/src/terminal/PageList.zig
+++ b/src/terminal/PageList.zig
@@ -540,7 +540,11 @@ fn initialCapacity(cols: size.CellCountInt) Capacity {
     return cap;
 }
 
-/// This is the allocator we'll use for all our underlying page allocations.
+/// Returns the allocator used for underlying page allocations.
+///
+/// `alloc` is the caller-provided allocator. It is used on native freestanding
+/// targets, where no OS page allocator is available. Other targets select a
+/// platform-specific allocator below.
 inline fn pageAllocator(alloc: Allocator) Allocator {
     // In tests we use our testing allocator so we can detect leaks.
     if (builtin.is_test) return std.testing.allocator;