diff options
| author | Cliff Click <cliffc@acm.org> | 2026-11-08 14:20:21 -0800 |
|---|---|---|
| committer | Cliff Click <cliffc@acm.org> | 2026-11-12 13:48:30 -0800 |
| commit | 6fb3aac50c642ed73ec78e9ceb6e04b127796abb (patch) | |
| tree | b0f3df12b85add20a34cfe839bdfdba272237d9a /docs | |
| parent | 394f0aba21eb7a73a00014b3ffcf2ad21eeb8e21 (diff) | |
| download | Simple-6fb3aac50c642ed73ec78e9ceb6e04b127796abb.tar.gz Simple-6fb3aac50c642ed73ec78e9ceb6e04b127796abb.zip | |
Start Chapter 31 from the completed Chapter 30 compiler
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/intellij.md | 4 | ||||
| -rw-r--r-- | docs/roadmap.ja.md | 4 | ||||
| -rw-r--r-- | docs/roadmap.md | 14 |
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. |
