Skip to content

v0.10

Choose a tag to compare

@mdbergmann mdbergmann released this 15 Sep 13:03
· 263 commits to master since this release

CL-Amiga 0.10

Highlights

Clamacs, the editor/IDE, ships in the release

  • Clamacs — an Emacs-flavoured Common Lisp editor and IDE for AmigaOS 3 and MorphOS, a native MUI application (TextEditor.mcc subclass with Emacs keys, minibuffer, kill ring, Lisp indentation and sexp navigation) that drives a running clamiga over its ARexx port: load, compile and evaluate from the buffer with clickable diagnostics, arglists and completion, jump to definition, describe and apropos, a REPL window (C-c C-z), a debugger window with restarts, backtrace, locals and eval-in-frame, and an inspector (C-c I). It lands as bin/aos3/clamacs (one binary for every 68020+) and bin/mos/clamacs next to the runtime. Needs MUI 3.8+ and TextEditor.mcc 15.29+ (MorphOS ships it).
  • The runtime grew the EXT.DEV command layer behind the ARexx development port that the editor speaks (lib/dev-commands.lisp, lib/dev-repl.lisp, shipped as FASLs): a REPL on a thread of its own, REPL-ATTACH ... DEBUG parking an erring form on its stack for interactive BACKTRACE / FRAME / FRAME-EVAL / RESTART, the INSPECT / PART / POP inspector over the new EXT:INSPECT-PARTS, and the introspection commands — which needed the runtime to keep docstrings at last, a real APROPOS, and DESCRIBE with lambda list, documentation and source location.
  • README-FIRST.guide in the package root explains what is where and, above all, the two S:.clamigarc lines that open clamiga's ARexx port so the editor finds (or starts) a clamiga.

Performance: Tier-4, all three phases

  • The runtime taxes removed (+37.6 % on the sento actor benchmark), the call and unwind protocol rebuilt (OP_CALL_GLOBAL with the callee resolved after the arguments, HANDLER-CASE as a special form with one NLX frame per entry, a per-thread multiple-value save stack for UNWIND-PROTECT, non-escaping FLET/LABELS bodies inlined, a JIT template for handler-case), and fourteen fused superinstructions chosen from an adjacent-pair profile of the sento message path, with the peephole pass at every speed above 0 (FASL v33).
  • MP locks and condition variables are heap words now — no lock table, no cap, per-thread parking — which lifted the sento matrix a further +50..360 % over the 0.8 binary (docs/sento-bench-results-0.10.md).
  • trunk/bench-general.lisp: a portable workload suite that runs the same file on clamiga, ECL and SBCL.

Documentation on the Amiga itself

  • Every page ships as AmigaGuide with a Workbench icon: README-FIRST.guide, cl-amiga.guide (the manual) and clamacs.guide in the package root next to the launcher icons, the package reference under docs/. Every heading is a node and the links between the pages work across the drawers (verified with MultiView on AmigaOS 3.2.3 and MorphOS 3.20). The converter, tools/docs/md2guide.lisp, is strict enough to be a drift gate in make test.

Release layout

  • Three Workbench launcher icons in the package root — CLAmiga, CLAmiga-FPU, Clamacs — start the matching binary from bin/ on a double-click (bin/mos/ on MorphOS, picked by the launcher script). The root opens in two rows, launchers then guides, showing only files with icons.
  • A bare-boot heap image beside every binary, make install lays the same out on a host, and --snapshot builds AmigaOS-only development packages.

Fixes

  • A THROW out of a cleanup in the m68k JIT no longer resurrects the abandoned error (the editor's C-c C-c of an undefined function took the ARexx port down).
  • Conditions made without a :format-control report from their slots per CLHS 9.2 ("The value 5 is not of type LIST" instead of #<CONDITION TYPE-ERROR>); runtime messages are ASCII-only for the byte-string m68k console.
  • A three-element LET binding is an error rather than silently compiled; FASL source names are portable; the user init file is S:.clamigarc as documented.
  • The ARexx port comes down at process exit (no zombie CLAMIGA task); a local function whose body has LOAD-TIME-VALUE keeps its closure.
  • Bignum division, bit operations and ASH take their scratch from the heap above the stack buffers; fill-pointer strings work as a string-stream source and as an EQUAL hash key.

Compatibility notes

  • The FASL format is v33 (superinstructions and return-shape rewrites); the cache re-keys to cl-amiga-0.10-fasl33, so caches from 0.9 rebuild transparently.
  • README-BINARY.txt is gone; its content is README-FIRST.md / README-FIRST.guide in the package root.

Downloads

clamiga-0.10.0-bin.lha / .zip contain bin/aos3 (68020+, soft-float), bin/aos3-fpu (hard-float, needs an FPU), bin/mos (MorphOS PPC, built natively), each with its clamiga.img and — for aos3 and mos — clamacs, plus lib/, docs/, examples/, the guides with their icons, and the package drawer's icon beside the drawer. Start with README-FIRST.guide.