Repository navigation
Releases
Clorraine v1.1.2
Clorraine v1.1.2
Clorraine is a compiler for the frozen v1.0 language with the approved v1.1
language surfaces, plus a build/run driver for the host, hosted-amiga,
hosted-amiga-13, and freestanding profiles. v1.1.2 is a patch release; the
language and command-line surface are unchanged.
Highlights
- Eligible constant arrays become data. A module-level fixed array with a
2- or 4-byte non-float scalar leaf, a complete guard-free constant list, at
least 16 elements and 64 bytes, and novolatilenow emits one read-only
data template and one copy instead of one store per element. Byte,
short/empty lists,const, fill, multi-extent, struct/view/float, and
freestanding arrays keep the stores; the conditions are recorded indocs/known-limitations.md§13.
On thelookupbenchmark, isolated under the previous flags, net
instructions fell 13,653 → 9,470 (−30.6%),.text
117,440 → 92,976 (−20.8%), and emitted C 474,430 → 340,503 bytes (−28.2%). - Much smaller release programs. Release programs on Linux host,
hosted-amiga, andhosted-amiga-13now use section garbage collection and
release stripping:
-O2 -ffunction-sections -fdata-sections -Wl,--gc-sections -s. Measured
with one compiler and the same sources, the fivehosted-amigascored
benchmarks are.text57.1–69.3% smaller and their stripped binaries
64.2–74.7% smaller; host stripped release binaries fall 20.6–36.5%; the
hosted-amiga-13audit set falls 49.1–88.9% in.text; calibration falls
3,372 → 2,928 instructions on 2.0 and 3,348 → 2,947 on 1.3. The two GCC
release rows in the frozen compile matrix match the new commands. - Release programs are stripped; tools and debug builds are not. The
clcandclorrainebinaries keep their symbols. Debug builds keep
symbols. Freestanding and non-Linux host program builds keep the-O2line
and symbols. Use a debug build when you need to diagnose a release program. - No collision with user
ffisymbols. The new data template uses a
collision-free symbol; it cannot shadow a userffiname. The collision
existed only in unreleased builds.
Verification
The v1.1.2 release gate runs make check, make asan, make ubsan,
make corpus-amiga, make differential, make bench-shape,
make bench-base COMMIT=v1.1.1, make bench,
make bench-compare REQUIRE="lookup:instructions:20 lookup:text:20",
make bench-flags, make verify, and make vscode-check on the gated
release commit. make verify prints verify: all legs passed.
Against v1.1.1, with the shipped flags applied to both trees, lookup net
instructions are 13,653 → 9,470 (−30.6%), .text 64,328 → 39,904 (−38.0%),
the binary 82,544 → 41,740 (−49.4%), and emitted C 474,430 → 340,503 bytes
(−28.2%). The other four scored benchmarks have identical net instructions,
.text, and emitted C. The flag audit's constructor proof shows the four
remaining libnix constructors still run on both m68k profiles.
Known limitations
- Programs built by
clorraine build --releaseon Linux host,hosted-amiga,
orhosted-amiga-13are stripped; a debug build is the symbol-bearing
artifact for diagnosis. freestandingand non-Linux host program builds keep the plain-O2line
and symbols.- The Linux x86_64 tarball contains
clcandclorraine, not
clorraine-lsp; build the server from source with
cargo build --workspace. --gc-sectionsremoves the unused libnix__amigapath/environ
constructor objects and their init entries. No current standard-library API
observes that state; a future API that does will need a targeted keep.- The accepted limitations are recorded in
docs/known-limitations.md,
including the remaining volatile-copy shapes, the A500 media requirement,
the RTG scope, and the v1.1Box<T>and hook boundaries.
Licence
MIT. Third-party notices, including the Hamurabi port, are in
THIRD_PARTY_NOTICES.md. The binary tarball includes that file and
docs/known-limitations.md, so the licence and limitations links in the
shipped README resolve; the other README links point to the source tree.
No NDK, ROM, Workbench media, or other restrictively licensed third-party file
is redistributed in the source or binary release artifacts.
Clorraine v1.1.1
Clorraine v1.1.1
Clorraine is a compiler for the frozen v1.0 language with the approved v1.1
language surfaces, plus a build/run driver for the host, hosted-amiga,
hosted-amiga-13, and freestanding profiles. v1.1.1 is a patch release.
Highlights
- Volatile nested fills emit valid C. A function-body nested fixed-array
fill into avolatilemodule array or avolatilestruct field now stores
each element through the volatile lvalue instead of callingmemcpywith a
volatile destination. The fix covers fill rows, explicit prefix rows
(including impure values evaluated once), and run-time indexed elements.
Accepted source such asvolatile let g: i32[8][9]withg = [; [; 0]];
now builds under strict C on host, m68k GCC, vbcc, and the freestanding
profile. - Generated-C matrix win. The matrix benchmark's nested zero fill is now
onememset, reducing streamed guest instructions by 9.6% and.textby
5.0% on that benchmark. No scored benchmark regresses.
Verification
The v1.1.1 release gate runs make check, make asan, make ubsan,
make corpus-amiga, make differential, make bench-shape,
make bench-compare, make verify, and make vscode-check on the exact
release tree. make verify prints verify: all legs passed.
Known limitations
The accepted limitations are recorded in docs/known-limitations.md, including
the remaining volatile-copy shapes (whole-array copies, volatile sources
through a row temporary, and by-value rvalue members), the A500 media
requirement, the RTG scope, and the v1.1 Box<T> and hook boundaries.
Licence
MIT. Third-party notices, including the Hamurabi port, are in
THIRD_PARTY_NOTICES.md.
No NDK, ROM, Workbench media, or other restrictively licensed third-party file
is redistributed in the source or binary release artifacts.
Clorraine v1.1.0
Clorraine v1.1.0
Clorraine is a compiler for the frozen v1.0 language with the approved v1.1
language surfaces, plus a build/run driver for the host, hosted-amiga,
hosted-amiga-13, and freestanding profiles.
Highlights
- A500/Kickstart 1.3 support. The
hosted-amiga-13profile targets a stock
A500: 68000 code, OCS video, 512 KB chip memory, and the libnix-mcrt=nix13
runtime. The Amiga SDK registry covers Bundles 0-9, including native video,
sprites, audio and input, text and layers, DOS and ILBM assets, Intuition,
Exec and devices, Workbench services, optional services, and Picasso96 RTG. Box<T>. The built-in owning pointer has generated recursive drop glue and
theboxNew,boxSet, andboxWithstandard-library surface. Allocation
failure uses the existingE1trap; Box is move-only and non-nullable.- Ordinary
freedBydeleters. A handle deleter can be an ordinary Clorraine
function with the existingtake T -> voidsignature, so application types can
own a recursive resource without writing anffiblock. - C-hook trampolines. A capturing lambda can cross a synchronous C hook. The
compiler emits a per-argument trampoline and a caller-stack environment, so the
C side still sees a plain function pointer. A stored callback invoked after the
hook returns faultsE11215. - Generated-C optimization and benchmarks. The benchmark harness measures
emitted size, m68k section sizes, host time, and the streamedvamos
instruction count. On the sieve benchmark the optimized compiler reduces
streamed guest instructions by 31.6%,.textsize by 24.4%, and emitted C size
by 36.6%. - Robustness closeout. Six latent compiler defects and the enum conversion
path are fixed. The verification suite now includes a host UBSan leg
(make ubsan) and a deterministic differential fuzzer with committed seeds,
seed goldens, and a host/m68k/sanitizer matrix.
Verification
The v1.1.0 release gate runs make check, make asan, make ubsan,
make corpus-amiga, make differential, make bench-shape, and make verify
on the exact release tree. make verify prints verify: all legs passed.
The gate covers the specification check, the Rust workspace suites, the
sanitizer legs, the portable corpus on host and hosted-amiga, the FS-UAE
acceptance programs, the runtime-fault programs, and the cross-toolchain shape
fixture.
Known limitations
The accepted v1.0 and v1.1 limitations are recorded in
docs/known-limitations.md, including the A500 media requirement, the RTG
scope, the v1.1 Box<T> and hook boundaries, and the compiler edge cases left
outside the robustness closeout.
Licence
MIT. Third-party notices, including the Hamurabi port, are in
THIRD_PARTY_NOTICES.md.
No NDK, ROM, Workbench media, or other restrictively licensed third-party file
is redistributed in the source or binary release artifacts.
Clorraine v1.0.0
Clorraine v1.0.0
Clorraine is a compiler for the frozen v1.0 language and a build/run driver for the
host, hosted-amiga, and freestanding profiles.
Highlights
clccompiles.closources to one valid C99 translation unit.clorrainebuilds and runs programs through the profile toolchain, including the
FS-UAE handoff forhosted-amiga.- The embedded standard library covers memory, text, formatting, console/file I/O, and the
Amiga modulesstd.amiga.{custom,dos,exec,graphics,interrupt,intuition}. - Developer tooling:
--explain CODEon both binaries,--diagnostics=jsonNDJSON on stderr,
and the canonicaleditors/clorraine.tmLanguage.jsongrammar. - The specification chapters 00-17 and appendices A/B are
stable (v1.0).
Verification
make check, make verify (differential, FS-UAE corpus, six runtime faults), make asan
(24 suites), and make differential (3/3) pass for this release.
Known limitations
See docs/known-limitations.md for the three accepted v1.0 limitations. The
std.amiga.exec message lifetime contract and the pre-existing compiler residuals are recorded
in the production-readiness findings ledger.
Licence
MIT. Third-party notices, including the Hamurabi port, are in THIRD_PARTY_NOTICES.md.
No NDK, ROM, or other restrictively licensed third-party file is redistributed.