Repository navigation
v0.10
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.mccsubclass 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 asbin/aos3/clamacs(one binary for every 68020+) andbin/mos/clamacsnext to the runtime. Needs MUI 3.8+ andTextEditor.mcc15.29+ (MorphOS ships it). - The runtime grew the
EXT.DEVcommand 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 ... DEBUGparking an erring form on its stack for interactiveBACKTRACE/FRAME/FRAME-EVAL/RESTART, theINSPECT/PART/POPinspector over the newEXT:INSPECT-PARTS, and the introspection commands — which needed the runtime to keep docstrings at last, a realAPROPOS, andDESCRIBEwith lambda list, documentation and source location. - README-FIRST.guide in the package root explains what is where and, above all, the two
S:.clamigarclines 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_GLOBALwith the callee resolved after the arguments,HANDLER-CASEas a special form with one NLX frame per entry, a per-thread multiple-value save stack forUNWIND-PROTECT, non-escapingFLET/LABELSbodies 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) andclamacs.guidein the package root next to the launcher icons, the package reference underdocs/. 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 inmake test.
Release layout
- Three Workbench launcher icons in the package root —
CLAmiga,CLAmiga-FPU,Clamacs— start the matching binary frombin/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 installlays the same out on a host, and--snapshotbuilds AmigaOS-only development packages.
Fixes
- A
THROWout of a cleanup in the m68k JIT no longer resurrects the abandoned error (the editor'sC-c C-cof an undefined function took the ARexx port down). - Conditions made without a
:format-controlreport 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
LETbinding is an error rather than silently compiled; FASL source names are portable; the user init file isS:.clamigarcas documented. - The ARexx port comes down at process exit (no zombie
CLAMIGAtask); a local function whose body hasLOAD-TIME-VALUEkeeps its closure. - Bignum division, bit operations and
ASHtake their scratch from the heap above the stack buffers; fill-pointer strings work as a string-stream source and as anEQUALhash 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.txtis gone; its content isREADME-FIRST.md/README-FIRST.guidein 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.