Developer preview v1.1.2 — installation, packaging, and some platform support are still in progress. Read the status
Skip to content

Known limitations ​

Clorraine is a developer preview. This page summarises the limitations that matter when you evaluate or use it. The authoritative list, including compiler edge cases and their workarounds, is docs/known-limitations.md.

Project-wide ​

LimitationImpactGuidance
Developer previewInterfaces, packaging, and platform support may changeUse it for experiments and feedback, not production work
Linux x86_64 binary onlyWindows and macOS users must build from source or use DockerInstallers are in progress
Host-only CIThe GitHub Actions runner does not execute the Amiga legsRun make verify locally for full acceptance
Amiga gates need licensed mediaAdvanced Workbench gates cannot run on a bare machineSupply your own media; no ROM or Workbench image is distributed
clorraine-lsp is not in the binary tarballThe release tarball has clc and clorraine onlyBuild the workspace from source
VS Code extension is not publishedEditor setup is manualmake vscode-check builds and audits a VSIX

Platform profiles ​

ProfileLimitation
hosted-amigaTargets AmigaOS 2.0+ through libnix -mcrt=nix20
hosted-amiga-13A500 baseline: 68000, OCS, 512 KB chip, Kickstart 1.3; the 2.0+ modules are rejected with E11200
freestandingProvisional ABI for LorraineOS; no heap, so String and Box<T> are unavailable
hostFor development and tests; it is not an Amiga artifact

Amiga surface ​

  • RTG is Picasso96 on UAEGFX and the emulated Picasso IV. CyberGraphX, CGX4, PIP/video overlay, CLUT palette editing, hardware sprites on RTG, and RTG text/font rendering are out of scope.
  • Exec worker tasks have no DOS process context. A task created by std.amiga.exec.createTask may use arithmetic, module-level scalars, and reportTaskResult; it must not call DOS, Intuition, std.io, allocate, drop an owning value, or block. Use a message port and a DOS process for that work.
  • Some optional services are narrower than their APIs. Clipboard proves the write/update path; serial, parallel, and printer prove typed open/close; datatypes proves parsing but not visible DTM_DRAW rendering; network proves a TCP echo through tcpEcho. The full list is in the authoritative document.
  • The NDK is not redistributed. The SDK image builds from public upstream sources and verifies downloaded inputs.

Compiler edge cases ​

The compiler has a small set of accepted-source edge cases outside the robustness closeout. They are pre-existing, are not regressions, and do not appear in the validation corpus. Examples include:

  • An imported enum or handle type used as a cast can emit a C call instead of a cast.
  • A non-integer explicit enum member is accepted without a type check.
  • A runtime integer converted to a handle can fail the strict host build.
  • Some volatile-array copies and prefix-row shapes can emit memcpy into volatile storage and fail the strict build.
  • A module const that does not fold in a case label is rejected by the C compiler.

Each case has a workaround in the authoritative limitations document. If you hit one, a minimal reproduction in an issue is valuable.

v1.1 ownership surfaces ​

SurfaceLimitation
Box<T> allocationAllocation failure traps; Box<T> is not nullable. Use Box<T>? as an optional slot
Box<T> movesA boxed value cannot be moved out of its box; use boxSet or boxWith
Box<T> FFIA direct box crossing is E10105; use boxWith or a C-facing struct
Capturing closuresEphemeral and inline-only; they cannot be stored, returned, or captured again
take capturesRejected in v1

Verification limits ​

  • AddressSanitizer child programs in the SDK image may need a non-PIE link. make asan handles this automatically.
  • A known GCC 15 loop-condition warning can appear for for, do-while, or conditions whose operands are calls. The emitted C remains valid C99 and GCC 12 in the SDK image accepts it.
  • Benchmark instruction counts are guest CPU instructions, not cycle counts. They are useful for deterministic comparisons, not for claiming hardware performance.
  • ASan does not instrument the m68k-only optional C shim; that code is covered by static review, host record models, and m68k runtime gates.

Reporting a limitation ​

If a limitation is not listed, open an issue with a minimal source file, the command, the profile, and the compiler version. The project treats a failing specification test as an implementation bug, never as a reason to weaken the test.

Clorraine is an independent project. Amiga, AmigaOS, Kickstart, and Workbench are trademarks of Amiga Corporation. Not affiliated with or endorsed by Amiga Corporation or Hyperion Entertainment.