Prepare public CoCo 3 documentation and portable VCC Plus workflow

This commit is contained in:
Brian Holman committed 2026-11-11 16:43:19 -07:00
1 parent e9574b6f0d
commit 4aa739780c
16 files changed
+572 -913

No files matched your search

+10 -13
View File
@@ -20,12 +20,10 @@ The numeric cases in [scoring.json](reference/scoring.json) express the referenc
scoring rules and regression expectations, including new-level multiplication.
These files are data for the new implementation, not a bundled Vala application.
The implementation chat is intentionally restricted to this self-contained
specification and allowed public/reference material. The source links and hashes
above preserve attribution; they do not authorize that chat to inspect the Mac
source or its development chat. This is a black-box boundary around the emulator
and a specification-based implementation workflow, not a claim of legally
independent provenance from the GPL game.
The CoCo game is an independently authored C implementation of this behavioral
specification. Linux/Mac application implementation is not incorporated. The
specification and derived reference data retain their GPL provenance; this
clean-room implementation does not erase their attribution or licensing.
## Credits and licensing
@@ -37,7 +35,7 @@ Holman (macOS port)**. The difficult-piece selection describes its algorithm as
originating in **Federico Poloni's Bastet**. Retain these credits in the port.
The specification and derived piece/scoring reference data are distributed under
GPL-3.0-or-later. Future game code derived from them should preserve that license
GPL-3.0-or-later. The game code preserves that license
and the relevant notices. The Mac fork's separate libgnome-games-support library
has its own LGPL-3.0-or-later terms; that library is not included here.
@@ -65,12 +63,12 @@ are required for this reference treatment.
The specification identifies behavior adapted for the CoCo: conventional
persistent hold swapping, bounded score storage and rule markers, a compact
deterministic PRNG rather than GLib stream compatibility, one-button joystick
menus, lower-color CoCo 2 graphics, approximate tone sequences, and safe handling
menus, approximate tone sequences, and safe handling
of pieces above the board. They must not be described as byte-for-byte Mac parity.
Hardware feasibility, timing, physical palette appearance, API performance and
disk layout are still to be demonstrated by the implementation. The arithmetic
memory estimates and reference tests do not establish a working CoCo build.
Current compatibility and reproducible build results are recorded in
[IMPLEMENTATION_STATUS.md](IMPLEMENTATION_STATUS.md). Earlier design estimates
and reference fixtures are distinct from guest execution evidence.
## CMOC example references consulted during implementation
@@ -100,8 +98,7 @@ ten digits and twelve punctuation glyphs. No drawing engine or assembly was
imported. Existing lowercase input maps to uppercase glyphs. The new C renderer
uses the original six visible columns/seven rows in each eight-pixel cell.
Brian explicitly permitted inspecting the supplied Mac scoring source on
November 11. The read-only checkout at revision
The scoring reference was checked on November 11 against revision
`be8769a403e506edb930372f963a9c4c83a0881e` confirms the existing Modern and
Classic (40.2) formulas. `scoring_through_drop` in tests/rules_test.c adapts the
GPL-3.0-or-later setup in its tests/test-scoring.vala to exercise actual piece