Files

MechaCat02 10dc260f0c chore(tools): adopt the PPC manual and a canary launcher that works anywhere

CONSOLIDATION.md Phase 6. Both lived untracked in the project root -- on one
disk, backed up by nothing.

  tools/ppc-manual/   393 files, 3.7 MB. 455 instructions, 350 family pages,
                      598 mnemonics resolvable through index.json, plus the
                      generator that produced them.
  tools/run-canary.sh the oracle launcher.

🔴 THE LAUNCHER WAS BROKEN IN TWO WAYS AND IS REWRITTEN, not copied:

  * it pointed at `xenia-rs/sylpheed.iso`, a SYMLINK. Wine cannot resolve one
    and says "path invalid", which reads as a corrupt image rather than a path
    problem -- it has cost a session before. It now points at the real file and
    warns if handed a symlink.
  * it hardcoded one machine's absolute paths, and named `xenia-rs`, which this
    consolidation retires. Now derived from the script's own location, with
    SYLPH_CANARY_BIN / SYLPH_ISO overrides and a check that each exists.

The standing constraints are in its header where someone will read them: one
emulator at a time, Canary runs MUTED, and never judge a crash or a hang from
a Bash-launched run -- a SIGKILL that looked like the binary was the editor's
process supervisor.

⚠️ The manual's GENERATOR reads the xenia-rs source tree, which is going away.
Its decoder now lives here as crates/sylpheed-ppc, so the generator must be
repointed before it is run again. Recorded in the README rather than left for
someone to discover; the manual's content is checked in and regenerates from
nothing implicitly.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-09-13 21:18:00 +02:00

2.1 KiB

Raw Blame History

Control / CR / SPR

Condition-register logical ops, CR field moves, mfspr/mtspr/mtcrf, time-base reads, synchronisation (sync, isync, eieio).

26 families · 26 XML entries.

Family	Form	Description	Members
`crand`	`XL`	Condition Register AND	`crand`
`crandc`	`XL`	Condition Register AND with Complement	`crandc`
`creqv`	`XL`	Condition Register Equivalent	`creqv`
`crnand`	`XL`	Condition Register NAND	`crnand`
`crnor`	`XL`	Condition Register NOR	`crnor`
`cror`	`XL`	Condition Register OR	`cror`
`crorc`	`XL`	Condition Register OR with Complement	`crorc`
`crxor`	`XL`	Condition Register XOR	`crxor`
`mcrf`	`XL`	Move Condition Register Field	`mcrf`
`mcrfs`	`X`	Move to Condition Register from FPSCR	`mcrfs`
`mcrxr`	`X`	Move to Condition Register from XER	`mcrxr`
`mfcr`	`X`	Move from Condition Register	`mfcr`
`mffsx`	`X`	Move from FPSCR	`mffsx`
`mfmsr`	`X`	Move from Machine State Register	`mfmsr`
`mfspr`	`XFX`	Move from Special-Purpose Register	`mfspr`
`mftb`	`XFX`	Move from Time Base	`mftb`
`mfvscr`	`VX`	Move from VSCR	`mfvscr`
`mtcrf`	`XFX`	Move to Condition Register Fields	`mtcrf`
`mtfsb0x`	`X`	Move to FPSCR Bit 0	`mtfsb0x`
`mtfsb1x`	`X`	Move to FPSCR Bit 1	`mtfsb1x`
`mtfsfix`	`X`	Move to FPSCR Field Immediate	`mtfsfix`
`mtfsfx`	`XFL`	Move to FPSCR Fields	`mtfsfx`
`mtmsr`	`X`	Move to Machine State Register	`mtmsr`
`mtmsrd`	`X`	Move to Machine State Register Doubleword	`mtmsrd`
`mtspr`	`XFX`	Move to Special-Purpose Register	`mtspr`
`mtvscr`	`VX`	Move to VSCR	`mtvscr`

2.1 KiB Raw Blame History

Control / CR / SPR

2.1 KiB

Raw Blame History