Files
VCCPlusOSS/tools/toolchain/patches/README.md
T
Brian Holman 5534005799 Sync VCC Plus 3.7.1 build 67 source
Refresh reviewed MCP output export, four-drive owned playtests, bounded BASIC readiness, and pinned CMOC 0.1.101 source/patches. Preserve independent source-edition identity, empty libraries, notices and privacy boundaries.

Validated 74 export/privacy checks, pinned dependency sources, and an independent unsigned universal Release build. A subsequent documentation-only correction removes an excluded qualification link; all build inputs remain identical.
2026-11-17 08:42:27 -07:00

7.7 KiB

Local CMOC compiler patches

The descriptions below retain each patch's original 0.1.100 history. On November 16, 2026, the four compiler patches were reapplied and qualified against CMOC 0.1.101, including its refactored instruction-effects analysis. The allocator patch was replaced as documented below.

cmoc-debug-metadata.patch is an original VCC Plus extension to CMOC 0.1.100, modified November 3, 2026 and licensed GPL-3.0-or-later. It is applied to the ignored build copy by tools/toolchain/build.py; the pinned upstream snapshot and its checksums stay unchanged.

With -fno-omit-frame-pointer, the compiler writes * VCCDBG1 {…} JSON comments into retained assembly/listings. Metadata comes from resolved compiler types and declarations, not a C-source text parser. It contains:

  • function entry, frame-ready body and epilogue boundaries;
  • lexical block ranges, including for-statement scopes;
  • signedness, storage size, array dimensions, member offsets and pointer types;
  • explicit floatingFormat tags: coco-basic-40 for Color BASIC/native 5-byte floats and ieee754-binary32-be for MC6839 single precision;
  • linker symbols for globals/static locals and U-relative offsets for parameters and ordinary locals.

The boundaries are zero-byte assembler labels. They can inhibit some assembly optimizations in debug builds; default/release compiler invocations emit neither the comments nor these labels. No instructions or data bytes are introduced by the metadata. The compiler runtime manifest records vccDebugMetadata: 1.

The app accepts metadata only from objects/listings/linker maps verified against the same frozen sources and final executable. Inspection additionally checks live mapped code and uses the debugger's atomic, non-I/O memory snapshot. Frame locals require -O0 as well as the preserved frame pointer and are unavailable in assembly-only functions, alternative calling conventions, prologues/epilogues, or builds without a preserved U frame. Unsupported floating-point formats and recursively truncated types remain explicitly unavailable. Legacy metadata without floatingFormat is accepted but not decoded by guessing from storage size. Known format tags must agree with storage size; a genuine double-precision type is not tagged as supported. CMOC 0.1.100 currently lowers source-level double to float, so that alias carries the selected single-precision format. Expressions do not execute guest code or modify memory.

To regenerate the patch, edit a separate copy of the upstream source and produce a unified diff with a/src/… and b/src/… paths. Verify that applying it to a fresh copy succeeds and that ordinary optimized builds retain their original bytes.

Indexed byte arithmetic and comparisons

cmoc-indexed-byte-subtraction.patch corrects three peephole rules in the build copy of CMOC 0.1.100 (modified November 7, 2026, GPL-3.0-or-later). On the 6809, B is the low byte of D. A byte load or negation can change the effective address of a later B- or D-indexed operand, including an indirect one. The subtraction and comparison rules now keep the original instruction order in those cases. The rules that remove a stack push also guard operands whose address would change with the stack pointer or an index side effect. Ordinary immediate substitutions remain available.

The guest regression exercises 184 - heights[i] with runtime indices, variable bases, byte wraparound, both operand orders and equality/inequality against an array element. The runner checks the output against host-calculated expectations on MC6809 and HD6309 at -O0 and -O2. It also runs as part of tools/toolchain/check.py --rom. Packaged runtimes identify the change with vccIndexedByteSubtractionFix: 1 in their manifest.

Indexed byte loads in function arguments

cmoc-indexed-argument-load.patch (November 11, 2026, GPL-3.0-or-later) corrects removeUselessLdaOrLdb in the CMOC 0.1.100 build copy. The rule used to remove an index reload from LDB index; LDX #array; LDB D,X, although B is the low byte of D and is needed to select the loaded byte. Consecutive indexed function arguments could therefore use the preceding argument's value as an array subscript. The rule now uses the existing instruction-effects analysis to preserve B dependencies in both intervening and final loads, including indirect B/D-indexed operands. It also checks the actual operand for predecrement/postincrement side effects. Independent overwritten loads remain eligible for removal.

The target regression passes adjacent elements from two arrays at runtime indices 0 and 2, using byte indices, word indices and pointer bases, with distinct surrounding sentinels. Its runner executes --coco --no-relocate --switch=jump binaries at -O0 and -O2 on MC6809 and HD6309; it is included in tools/toolchain/check.py --rom. The rule check links the actual built compiler objects and checks dependency/side-effect guards as well as safe removals. See the qualification record. Packaged runtimes identify the change with vccIndexedArgumentLoadFix: 1.

Logical negation of integer results

cmoc-add-zero-flags.patch (November 7, 2026, GPL-3.0-or-later) corrects CMOC 0.1.100's general peephole optimizer. CMOC emits ADDD #0 to set the flags for a word-sized comparison with zero. A function can return 1 in D with Z still set from clearing A. Removing the add before the tfrZtoB helper made !getReady() return 1 in that case. The patch removes the general rule's unproven add-zero deletions and byte-test substitutions. The separate optimizations for recognized load/compare/branch sequences still run.

The guest regression prints actual results for zero, widened unsigned bytes and 16-bit values. Run tools/toolchain/check.py --rom with a local CoCo 3 ROM to check those results at -O0 and -O2 on MC6809 and HD6309. Rebuilt app toolchains record vccAddZeroFlagsFix: 1 in the manifest.

Explicit allocation

writecocofile-before-dir.patch now adds --allocate-forward, preserving the old ascending layout. The original option now follows upstream.

The --allocate-before-dir meaning changed: it now starts at 33 and descends, then wraps. Callers needing the old layout must migrate.

LWASM project input boundary

The native Assembly workspace passes --project-inputs when invoking LWASM. lwtools-project-inputs.patch (November 5, 2026, GPL-3.0-or-later) constrains source and binary input reads to regular files inside the physical working directory. It checks each open, including binary data reopened during emission. The companion --project-map=FILE records physical source paths, physical one-based lines, sections, offsets and original instruction bytes. Macro expansions, data directives, synthesized 6800/convenience operations and OS-9 calls cannot become source breakpoints. The Swift client verifies final DECB bytes after relocation. A project map requested with --6809 also rejects source pragmas that change that target. The app supplies an isolated, symlink-free copy of the source snapshot. Other invocations retain ordinary LWASM path behavior. Custom Make recipes execute as user-supplied build commands and have a separate trust boundary.

Rebuild and stage the native runtime with build-runtime.py before packaging the workspace. The runtime manifest records vccLWASMProjectInputs: 1; older assemblers reject the required option.