c562fe236d
Two new workstreams:
- ASM: inline assembly — asm { "tmpl", "=r" -> T, "r" = expr, clobbers(.…) },
multi-return tuples; lowers via the existing llvm_api.c (no shim).
- FFI-linkage: add extern/export postfix keywords, migrate every #foreign onto
them, then purge 'foreign' from the tree (end-state invariant).
Drop current/ from .gitignore so plans + checkpoints are tracked normally
(the dir was ignored; only checkpoints had been force-added). Includes
docs/inline-asm-design.md. specs.md change left uncommitted.
36 lines
1.6 KiB
Markdown
36 lines
1.6 KiB
Markdown
# sx `extern`/`export` + `#foreign` retirement — Checkpoint (FFI-linkage stream)
|
|
|
|
Companion to `current/PLAN-EXTERN-EXPORT.md` — one merged plan: **Part A** adds
|
|
`extern`/`export`, **Part B** migrates `#foreign` and purges `foreign`. Update after
|
|
every commit, one step at a time per the cadence rule.
|
|
|
|
## Last completed step
|
|
None — plan authored, not yet started. (Merged the former EXTERN-EXPORT +
|
|
FOREIGN-MIGRATION plans into this single plan.)
|
|
|
|
## Current state
|
|
Syntax decided + ratified: bare `extern`/`export`, postfix in the `callconv(.c)`
|
|
slot, `extern ⇒ callconv(.c)`, library separate. Touch-points mapped — token
|
|
`token.zig:45,282`; parser `1950,3669,316,425,1305`; lowering
|
|
`decl.zig:1123,387,2110,2382,2514`; IR/emit already capable (no codegen change).
|
|
Export gap = 4 lowering conditions. Part B `foreign` footprint to purge: 643 lines /
|
|
~57 identifiers in `src/` + 28 doc lines. End-state invariant: **zero `foreign`** in
|
|
the live tree (Phase 9.4 gate). No code written.
|
|
|
|
## Next step
|
|
**Phase 0.0** — add `kw_extern`/`kw_export` tokens + keyword-map entries (beside
|
|
`kw_callconv`) + unit lex test. Then 0.1 (parser plumbing, unconsumed), then Phase 1
|
|
(`extern` working). See the plan's **"Kickoff prompt"** section.
|
|
|
|
## Open decisions
|
|
Part A ratified (bare / postfix / `⇒ callconv(.c)` / lib-separate). Part B (confirm
|
|
before Phase 9): runtime-class rename target — `Runtime*Class*` (recommended);
|
|
historical carve-out — keep `issues/*.md` provenance, gate the live tree only.
|
|
|
|
## Log
|
|
- (init) Plan written; FFI-linkage stream opened.
|
|
- (merge) Folded FOREIGN-MIGRATION in as Part B; deleted the split plan + checkpoint.
|
|
|
|
## Known issues
|
|
None yet.
|