Prepare public CoCo 3 documentation and portable VCC Plus workflow
This commit is contained in:
1 parent
e9574b6f0d
commit
4aa739780c
16 files changed
+572
-913
No files matched your search
+10
-13
@@ -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
|
||||
|
||||
Reference in new issue
Block a user