Files
Sylpheed/tools/ppc-manual/forms/XO.md
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

44 lines
2.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Form `XO` — XO — Extended, Overflow (ALU with OE/Rc)
## Bit Layout
| Bits | Field | Meaning |
| --- | --- | --- |
| 05 | `OPCD` | primary opcode (31) |
| 610 | `RT` | destination GPR |
| 1115 | `RA` | source A |
| 1620 | `RB` | source B |
| 21 | `OE` | overflow-enable flag |
| 2230 | `XO` | extended opcode (9 bits) |
| 31 | `Rc` | record-form flag |
## Instructions Using This Form
<!-- GENERATED: BEGIN -->
| Mnemonic | Opcode | Group | Description |
| --- | --- | --- | --- |
| [`subfcx`](../alu/subfcx.md) | `0x7c000010` | integer | Subtract From Carrying |
| [`mulhdux`](../alu/mulhdux.md) | `0x7c000012` | integer | Multiply High Doubleword Unsigned |
| [`addcx`](../alu/addcx.md) | `0x7c000014` | integer | Add Carrying |
| [`mulhwux`](../alu/mulhwux.md) | `0x7c000016` | integer | Multiply High Word Unsigned |
| [`subfx`](../alu/subfx.md) | `0x7c000050` | integer | Subtract From |
| [`mulhdx`](../alu/mulhdx.md) | `0x7c000092` | integer | Multiply High Doubleword |
| [`mulhwx`](../alu/mulhwx.md) | `0x7c000096` | integer | Multiply High Word |
| [`negx`](../alu/negx.md) | `0x7c0000d0` | integer | Negate |
| [`subfex`](../alu/subfex.md) | `0x7c000110` | integer | Subtract From Extended |
| [`addex`](../alu/addex.md) | `0x7c000114` | integer | Add Extended |
| [`subfzex`](../alu/subfzex.md) | `0x7c000190` | integer | Subtract From Zero Extended |
| [`addzex`](../alu/addzex.md) | `0x7c000194` | integer | Add to Zero Extended |
| [`subfmex`](../alu/subfmex.md) | `0x7c0001d0` | integer | Subtract From Minus One Extended |
| [`mulldx`](../alu/mulldx.md) | `0x7c0001d2` | integer | Multiply Low Doubleword |
| [`addmex`](../alu/addmex.md) | `0x7c0001d4` | integer | Add to Minus One Extended |
| [`mullwx`](../alu/mullwx.md) | `0x7c0001d6` | integer | Multiply Low Word |
| [`addx`](../alu/addx.md) | `0x7c000214` | integer | Add |
| [`divdux`](../alu/divdux.md) | `0x7c000392` | integer | Divide Doubleword Unsigned |
| [`divwux`](../alu/divwux.md) | `0x7c000396` | integer | Divide Word Unsigned |
| [`divdx`](../alu/divdx.md) | `0x7c0003d2` | integer | Divide Doubleword |
| [`divwx`](../alu/divwx.md) | `0x7c0003d6` | integer | Divide Word |
<!-- GENERATED: END -->