From 2a49d6fba21ce6227053eb1938cb42cbacf6c78c Mon Sep 17 00:00:00 2001
From: Sunrisepeak <speakshen@163.com>
Date: Sun, 15 Nov 2026 10:07:13 +0900
Subject: [PATCH] docs: the 32-bit rows of openkal-platform 0.28.0 are served
 when a project states the platform; the built-in table keeps them planned

---
 CHANGELOG.md                              | 12 +++++++-----
 modules/toolchain-model/data/builtin.toml | 11 ++++++-----
 2 files changed, 13 insertions(+), 10 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index a1643cf5e..0979fea39 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -26,11 +26,13 @@
 ### Changed
 
 - The built-in platform of the ok images and of the musl identities is
-  openkal-platform 0.28.0 (was 0.27.1): the group on openkal 0.25.3, and the
-  rows `i686-linux-musl`, `i686-openkal`, `x86_64-uefi` and `i686-dos-musl`
-  (a technical experiment). A project that names openkal 0.25.3 builds for
-  `x86_64-openkal` without stating a platform; with 0.27.1 the group's openkal
-  0.25.0 refused it.
+  openkal-platform 0.28.0 (was 0.27.1), the group on openkal 0.25.3. A project
+  that names openkal 0.25.3 builds for `x86_64-openkal` without stating a
+  platform; with 0.27.1 the group's openkal 0.25.0 refused it. The release's
+  rows `i686-linux-musl`, `i686-openkal`, `x86_64-uefi` and `i686-dos-musl` (a
+  technical experiment) are planned in the built-in table and are served when a
+  project states the platform (`[target.'cfg(os = "linux")'] platform =
+  "openkal-platform@0.28.0"`).
 - `mcpp new` scaffolds tests with mtest 0.9.0, the version this package's own
   tests use, so a new package's long cases are divisible by the cases they
   declare.
diff --git a/modules/toolchain-model/data/builtin.toml b/modules/toolchain-model/data/builtin.toml
index 85836fd32..ef4cdf9b9 100644
--- a/modules/toolchain-model/data/builtin.toml
+++ b/modules/toolchain-model/data/builtin.toml
@@ -163,11 +163,12 @@ standard = true
 
 # 32-BIT ROWS (E11): registered intent, refused until served. No payload of the
 # index targets them. openkal states its 32-bit class (0.25.1, clause 5.5), and
-# openkal-platform 0.28.0, the engine's pin, serves `i686-linux-musl` and
-# `i686-openkal` with the LLVM toolchain: a planned row its targets name is
-# served by the platform (2026.11.14.1). The rows stay planned here, as a row
-# no payload of the index serves; an explicit `[target.<row>] toolchain` opts
-# in as well.
+# openkal-platform 0.28.0 serves `i686-linux-musl` and `i686-openkal` with the
+# LLVM toolchain when a project states it (`[target.<sel>] platform`): a
+# planned row the stated platform's targets name is served by it
+# (2026.11.14.1). The built-in platform does not serve a planned row, so the
+# rows stay planned here; an explicit `[target.<row>] toolchain` opts in as
+# well.
 [[platform.define]]
 triple   = "i686-linux-musl"
 loader   = "/lib/ld-musl-i386.so.1"