summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorCliff Click <cliffc@acm.org>2026-11-08 14:20:21 -0800
committerCliff Click <cliffc@acm.org>2026-11-12 13:48:30 -0800
commit6fb3aac50c642ed73ec78e9ceb6e04b127796abb (patch)
treeb0f3df12b85add20a34cfe839bdfdba272237d9a /docs
parent394f0aba21eb7a73a00014b3ffcf2ad21eeb8e21 (diff)
downloadSimple-6fb3aac50c642ed73ec78e9ceb6e04b127796abb.tar.gz
Simple-6fb3aac50c642ed73ec78e9ceb6e04b127796abb.zip
Start Chapter 31 from the completed Chapter 30 compiler
Diffstat (limited to 'docs')
-rw-r--r--docs/intellij.md4
-rw-r--r--docs/roadmap.ja.md4
-rw-r--r--docs/roadmap.md14
3 files changed, 11 insertions, 11 deletions
diff --git a/docs/intellij.md b/docs/intellij.md
index 378889ef..a7937f6f 100644
--- a/docs/intellij.md
+++ b/docs/intellij.md
@@ -35,8 +35,8 @@ class names occur in many chapters, so a class name alone cannot identify the
intended snapshot.
Tests that compile native code still need the C toolchain on IntelliJ's PATH.
-Tests using the native runtime or saved `sys` library in Chapters 28b and 29
-also need the Make prerequisites. Run `make -C chapter30 release CTAGS=`
+Tests using the native runtime or saved `sys` library in Chapter 28b and later
+also need the Make prerequisites. Run `make -C chapter31 release CTAGS=`
(or `chapter28b` for that snapshot) before debugging those tests. IntelliJ's Java build does not build the native runtime or library.
For the JUnit working directory and module classpath settings, see
diff --git a/docs/roadmap.ja.md b/docs/roadmap.ja.md
index 5612e0f1..9c5a8e8f 100644
--- a/docs/roadmap.ja.md
+++ b/docs/roadmap.ja.md
@@ -5,8 +5,8 @@
未完了の作業と将来の言語設計案の要約です。現在の言語仕様や実装済みの機能を
示すものではありません。詳細と最新の判断は[英語版](roadmap.md)を参照してください。
-現在の作業場所は[第30章: テキスト整形と診断](../chapter30/README.md)です。
-ASCII 三目並べを題材に、文字列補間、型別の文字列変換、1 キー入力、
+現在の作業場所は[第31章](../chapter31/README.md)で、テーマは未定です。
+第30章では ASCII 三目並べを題材に、文字列補間、型別の文字列変換、1 キー入力、
ソース位置付きの診断を実装しました。以下は残っている作業です。
## 目次
diff --git a/docs/roadmap.md b/docs/roadmap.md
index ac0ac239..48c027d7 100644
--- a/docs/roadmap.md
+++ b/docs/roadmap.md
@@ -42,7 +42,7 @@ design decisions and chapter boundaries.
### General cleanup
Keep the recursive-descent path aligned with the grammar. Review moving `TYPES`
-to `CodeGen`.
+to `CodeGen`.
Consider whether an allocation-free use of try-with-resources makes keep/unkeep
pairing clearer; this remains an experiment, not a new resource-management
@@ -170,11 +170,10 @@ bits consumers observe could keep arithmetic chains and loops narrow and
extend only at wide consumers, but requires backwards propagation through
shared uses and Phis. This is a separate analysis proposal, not part of the
local selection work. Narrow operations still occupy whole registers.
-Diagnose the current allocator retry failure before changing its input graph.
### Per-function calling conventions
-Allocate functions independently first. Later, give known direct-call targets
+Chapter 30 now allocates functions independently. Give known direct-call targets
their own machine contracts: argument/return locations, clobbered registers,
stack argument layout/alignment, and integer-extension requirements. Start
with precise clobber summaries under the existing convention, then consider
@@ -270,10 +269,11 @@ a correction to impose on earlier chapters.
- Native declarations follow the same rules. Public wrappers may deliberately
expose private bindings; `sys` has no special exemption.
-The bundled `sys/io.smp` calls `libc._exit` directly. Keep that native binding
-private, add a public `exit` wrapper in `sys/libc.smp`, and change IO to call
-the wrapper. Bitset and array helpers access their own private fields and
-remain legal. String spill fixtures with helpers outside `_String` accessing
+The resizable-array helpers call `libc._exit` directly, and `sys.io.read`
+calls `aryu8._grow`. Keep the native exit binding private, add a public `exit`
+wrapper in `sys/libc.smp`, and define a public capacity-reservation method for
+the buffer. Bitset and array helpers accessing their own private fields remain
+legal. String spill fixtures with helpers outside `_String` accessing
`_hashCode` need explicit adaptation; do not grant file-wide access merely to
keep those fixtures unchanged. Validate native execution and imported source
ownership alongside the access diagnostics.