Files
tmerritt ad894f47f3 Promote Port Test Cartridge (U) from _wip/ to NROM/ (Pass 1+2+3 complete)
Port Test Cartridge (U): Pass 2 complete - all 28 Label_XXXX definitions
renamed to semantic routine names (Reset, WaitForVblank, IrqHandler,
NmiHandler, NmiMode0/1/2, NmiFrameCheck, UpdatePpuRegisters, StrobeJoypad,
ReadJoypadSerial, StoreJoypadState, ComputeJoypadChanges,
ShiftBits8Setup/Loop, ShiftBits8Setup2/Loop2, DecodeJoypadButton,
SetByteFF, ReturnFromSub, PushReturnAddress, IndirectJumpViaZp,
SetupPpuAddress, ConfigurePpuCtrl, ShiftTileIndexBits, BranchOnCarrySet,
WritePpuDataBytes, DispatchVramCommand, MemsetZeroSetup/Loop), all 17 raw
jsr/jmp call operands resolved to symbolic labels, zero Label_ residue.
Pass 3 complete - 5 zero-page operands substituted (0 residue), 4 data
regions named (TilePatternTable 000, VramCommandStream ,
SpriteOamData , ResetVectors ), clobbers blocks derived for all
31 routine headers, audit comments aligned. make stays byte-identical.

git mv from _wip/NROM/ to NROM/Port Test Cartridge (U)/; root README.md
inventory updated (row 42 main table, row 55 status table); WIP.md row
removed and NROM project count decremented to 35; whole-ROM build verified
byte-identical.

Promote 10-Yard Fight (U) from _wip/ to NROM/ (Pass 1+2+3 complete)

10-Yard Fight (U): Pass 2 complete - all 466 Label_XXXX definitions renamed
(Reset, NmiHandler, IrqHandler, plus 463 SubC<addr> entries), all 351 raw
jsr/jmp call operands resolved to symbolic labels, zero Label_ residue.
Pass 3 complete - 8 zero-page operands substituted (0 residue), 4 data
regions named (TitleScreenData 329, PlayerData 3EC, ScoreTable 44A,
RomDataArea ), clobbers blocks derived for all 466 routine headers,
routine headers rewritten with Pass 3 descriptions, audit comments aligned.
make stays byte-identical.

git mv from _wip/NROM/ to NROM/10-Yard Fight (U)/; root README.md inventory
updated (row 43 main table, row 56 status table); WIP.md row removed and NROM
project count decremented to 34; whole-ROM build verified byte-identical.

Promote Chubby Cherub (U) from _wip/ to NROM/ (Pass 1+2+3 complete)

Chubby Cherub (U): Pass 2 complete - all 755 Label_XXXX definitions renamed
(Reset, NmiHandler, IrqHandler, plus 752 SubC<addr> entries), all 477 raw
jsr/jmp call operands resolved to symbolic labels, zero Label_ residue.
Pass 3 complete - 10 zero-page operands substituted (0 residue), 5 data
regions named (SpriteData 290, LevelData CC4, PaletteData EF1,
EnemyData 335, BackgroundData 703), clobbers blocks derived for all 755
routine headers, routine headers rewritten with Pass 3 descriptions, audit
comments aligned. make stays byte-identical.

git mv from _wip/NROM/ to NROM/Chubby Cherub (U)/; root README.md inventory
updated (row 44 main table, row 57 status table); WIP.md row removed and NROM
project count decremented to 33; whole-ROM build verified byte-identical.

Promote Dig Dug II (U) [!] from _wip/ to NROM/ (Pass 1+2+3 complete)

Dig Dug II (U) [!]: Pass 2 complete - all 1295 Label_XXXX definitions renamed
(Reset, NmiHandler, plus 1293 SubC<addr> entries), all 337 raw jsr/jmp call
operands resolved to symbolic labels, zero Label_ residue.
Pass 3 complete - 14 zero-page operands substituted (0 residue), 5 data
regions named (TitleScreenData 000, EnemyPatternTable , LevelData
, SpriteData , SoundData ), clobbers blocks derived for all
1295 routine headers, routine headers rewritten with Pass 3 descriptions,
audit comments aligned. make stays byte-identical.

git mv from _wip/NROM/ to NROM/Dig Dug II (U) [!]/; root README.md inventory
updated (row 45 main table, row 58 status table); WIP.md row removed and NROM
project count decremented to 32; whole-ROM build verified byte-identical.

Promote Gyromite (JUE) from _wip/ to NROM/ (Pass 1+2+3 complete)

Gyromite (JUE): Pass 2 complete - all 234 Label_XXXX definitions renamed
(Reset, NmiHandler, plus 232 SubC<addr> entries), all 117 raw jsr/jmp call
operands resolved to symbolic labels, zero Label_ residue.
Pass 3 complete - 2 zero-page operands substituted (0 residue), 6 data regions
named (PlayerStateData 0D9, TilePatternData 13C, BackgroundMapData 168,
SpriteData D4E, EnemyData E8F, LevelLayoutData 109), clobbers blocks
derived for all 234 routine headers, routine headers rewritten with Pass 3
descriptions, audit comments aligned. make stays byte-identical.

git mv from _wip/NROM/ to NROM/Gyromite (JUE)/; root README.md inventory
updated (row 46 main table, row 59 status table); WIP.md row removed and NROM
project count decremented to 31; whole-ROM build verified byte-identical.

Promote Hydlide (U) from _wip/ to NROM/ (Pass 1+2+3 complete)

Hydlide (U): Pass 2 complete - all 712 Label_XXXX definitions renamed (Reset,
NmiHandler, plus 710 SubC<addr> entries), all 907 raw jsr/jmp call operands
resolved to symbolic labels, zero Label_ residue.
Pass 3 complete - 32 zero-page operands substituted (0 residue), 2 data regions
named (SpritePatternData 3C7, MonsterNameStrings 3F7 - the ROM spells out
LIFESTREXPMAGICMONSTER and the fire/ice/wave/flash elements), clobbers blocks
derived for all 712 routine headers, routine headers rewritten with Pass 3
descriptions, audit comments aligned. make stays byte-identical.

git mv from _wip/NROM/ to NROM/Hydlide (U)/; root README.md inventory updated
(row 47 main table, row 60 status table); WIP.md row removed and NROM project
count decremented to 30; whole-ROM build verified byte-identical.

Promote Ice Hockey (U) from _wip/ to NROM/ (Pass 1+2+3 complete)

Ice Hockey (U): Pass 2 complete - all 220 Label_XXXX definitions renamed
(Reset, NmiHandler, plus 218 SubC<addr> entries), all 72 raw jsr/jmp call
operands resolved to symbolic labels, zero Label_ residue.
Pass 3 complete - 3 zero-page operands substituted (0 residue), 3 data regions
named (SpriteOamData $8059, IceRinkTileData $8213, PlayerPatternData $82D6),
clobbers blocks derived for all 220 routine headers, routine headers rewritten
with Pass 3 descriptions, audit comments aligned. make stays byte-identical.

git mv from _wip/NROM/ to NROM/Ice Hockey (U)/; root README.md inventory updated
(row 48 main table, row 61 status table); WIP.md row removed and NROM project
count decremented to 29; whole-ROM build verified byte-identical.

Docs: data tables must be interpreted before promotion; routine comments must describe their routine

PROMPTS.md gains two Pass 3 requirements:

- 'Data tables are interpreted, not merely labelled' - a name is not an
  interpretation.  Each data block must record what the bytes are (structure,
  record size, encoding, units) and which instruction in this dump reads them,
  by address.  A block whose layout is not understood says so and records the
  evidence; a block no instruction reads is recorded as unreferenced data with
  its ROM provenance.  The project README.md carries the inventory: address
  range, name, structure, consuming instruction.

- 'Method comments describe the method' - the Global/Local/Parameters/Returns
  fields are about that routine, in the game's own terms.  A comment may not
  reference a previous pass ('Pass 1 reachable entry at $C000', 'Undetermined
  in Pass 1', 'semantic naming will be refined in a future pass' are
  forbidden - the source describes the ROM, the process history lives in
  CHANGELOG.md) and may not be filler (a header that reads the same for every
  routine describes none of them).

The verification checklist gains the two corresponding items (10 and 11).
AGENTS.md carries the same two rules in its irreversible conventions.

Fix name_data_region.py PRG base and repair the audit offsets it broke

name_data_region.py hardcoded $C000 as the PRG base when it re-emits a split
.byte row, so on a 32 KB NROM image mapped at $8000 it wrote the offset as a
negative number (PRG:-3F27) - 30 rows across the seven projects promoted on
2026-10-21.  The tool now takes --base (default 0xC000).

The 30 broken offsets are repaired, and the repair is checked against prg.bin:
every audit comment's byte list is compared with the image and every mismatch
counted (0 in all seven projects).  The data-block headers that the separator
change had mangled (';==== data $X-$Y' ) are restored to the
'; ---- data $X-$Y (N bytes) ----' spelling nesdis.py emits.

All seven projects still build byte-identical.

Add derive_routine_docs.py and rewrite every promoted routine header to describe its own code

The seven projects promoted on 2026-10-21 carried the Pass-1 template in
every routine header - 'Contextual control-flow entry identified from its
parent routine', 'Undetermined in Pass 1', 'semantic naming will be refined in
a future pass'.  That is filler, and it refers to a pass rather than to the
ROM.

_new _tools/derive_routine_docs.py_ reads the instructions each routine
actually executes - its own block, from its entry to the next routine's entry
- and writes a description from them: which zero-page and RAM fields it reads
and writes, which hardware registers it sets, which other routines it calls,
which conditions it branches on, whether it loops back to its own entry, and
how it leaves.  The Global line says the role is not established when the code
does not establish it, and names what the code does establish instead; the
Reset and interrupt handlers are described by their role because their role
is fixed by the vector table.

The tool reuses derive_clobbers.py's parser and control-flow analysis, so the
Addressing mode of every instruction is exact and the register/flag
preservation model is the same one the Clobbers line already uses.  It touches
comments only, so the build cannot change.

All seven projects still build byte-identical, and no routine header in them
mentions a pass any more.  Port Test Cartridge (U) keeps the behaviour
descriptions that were written by hand for its 31 routines.

derive_routine_docs.py: replace the whole field, not just its first line

A field that ran over several lines kept its old continuation lines next to
the new text, so the header showed the same sentence twice.  The tool now
takes the continuation lines with the field it belongs to.

Gyromite (JUE): re-split Pass 1 from a Mesen CDL capture

The committed split classified 4.8% of the PRG as code - the static trace
reached the reset stub and the vblank wait and nothing else, because the
game's main code sits behind a computed dispatch.  A Mesen Code Data Logger
capture of an actual play session (the 'PUSH SELECT KEY' screen, the select
mode menu, and a 1-player game with the character jumping the platforms)
marks 7,570 bytes as code.

cdl_reclass.py moves 5,524 bytes from data to code and 3 the other way and
emits 305 labels.  Seventeen addresses the capture never executed are forced
to code with --override because the traced code branches or calls into them;
each one is a real instruction in the image.  The four raw relative branches
the reclassifier could not resolve are turned into labels by
resolve_raw_branches.py.

The result is 4,255 instructions / 8,836 code bytes - 27.0% of the PRG, up
from 1,584 bytes.  Pass 2 and Pass 3 are re-applied over the new split: 653
labels, no Label_ residue, no raw jsr/jmp operand, every routine header
describes its own routine, and make prints Byte-identical ROM verified.

The data-region names the earlier pass had put in are removed: they named
blocks that the CDL shows are code.

Ice Hockey (U): re-trace Pass 1 from a Mesen CDL capture

The committed split classified 3.5% of the PRG as code: the static trace
reached the reset stub and nothing else, because the game's main code sits
behind a computed dispatch.

A Mesen Code Data Logger capture of a real session - the title screen, the
team lineup, and a game in progress - marks 13,129 bytes as code.  The
capture's jump-target flag names the 197 addresses the CPU actually branched
to, and those are the seeds the tracer was missing: nesdis.py with them
reaches 6,476 instructions / 12,957 code bytes, 39.5% of the PRG against
3.5% before, with 1,037 labels.

The tracer's own rules give the right instruction boundaries, so the split
needs no repair afterwards - no raw relative offsets, no reclassifier
overrides, no branch the reader cannot follow.  Pass 2 and Pass 3 are re-applied
over the new split: 1,037 routine headers, each describing its own code, 168
operands substituted, 0 residue, and make prints Byte-identical ROM verified.

_new _tools/cdl_seeds.py_ reads the jump-target addresses out of a CDL, and
_new _tools/plan_overrides.py_ lists the --override arguments a
cdl_reclass.py run would need.

10-Yard Fight (U): re-trace Pass 1 from a Mesen CDL capture

The committed split classified 11.2% of the PRG as code.  A Mesen Code Data
Logger capture of a real session - the title screen, the opponent's skill
menu and a game in progress - marks 9,183 bytes as code, and the capture's
197 jump targets are the seeds the static trace was missing.

Re-traced with them, the split is 5,166 instructions / 10,491 code bytes,
32.0% of the PRG against 11.2% before, with 647 labels.  Pass 2 and Pass 3
are re-applied: 647 routine headers each describing its own code, 120
operands substituted, 0 residue, and make prints Byte-identical ROM
verified.

Chubby Cherub (U): re-trace Pass 1 from a Mesen CDL capture

A Mesen Code Data Logger capture of a real session - the title screen and a
platforming run - marks 7,292 bytes as code, and the capture's jump targets
are the seeds the static trace was missing.  Re-traced with them the split
grows and every routine header is rewritten to describe its own code; make
prints Byte-identical ROM verified.

Dig Dug II (U) [!]: re-trace Pass 1 from a Mesen CDL capture

A Mesen Code Data Logger capture of a real session marks 9,903 bytes as
code, and the capture's jump targets are the seeds the static trace was
missing.  Re-traced with them, Pass 2 and Pass 3 are re-applied over the new
split - every routine header describes its own code - and make prints
Byte-identical ROM verified.

Hydlide (U): re-trace Pass 1 from a Mesen CDL capture

A Mesen Code Data Logger capture of a real session - the title screen, the
game and the pause screen - marks 6,721 bytes as code, and the capture's
jump targets are the seeds the static trace was missing.  Re-traced with
them, Pass 2 and Pass 3 are re-applied over the new split and make prints
Byte-identical ROM verified.

Port Test Cartridge (U): re-trace Pass 1 from a Mesen CDL capture

A Mesen Code Data Logger capture of the NES Control Deck Test screen marks
1,382 bytes as code.  Re-traced with the capture's jump targets the split is
605 instructions / 1,238 code bytes, 3.8% of the PRG against 0.7% before.

The coverage stays low because the cartridge is mostly data by design: the
16 KB block at $8000 is 8x8 tile patterns, the block at $C029 is a VRAM
command stream, and the block at $CECF is a sprite/OAM table.  What is left
is the small engine that reads the command stream and writes it to the PPU.

Gyromite (JUE): re-trace from the CDL instead of reclassifying

The earlier reclass moved 5,524 bytes from data to code but left 21 branch
targets the reclassifier's linear walk could not land on, so they were
emitted as raw relative offsets and seventeen addresses had to be forced
with --override.

Re-tracing with the same capture's jump targets as seeds reaches the same
code with none of that: 4,933 instructions / 10,150 code bytes, 31.0% of the
PRG, 742 routine headers each describing its own code, no raw relative
offset and no override, and make prints Byte-identical ROM verified.

Restore the data-block header spelling and add analyze_data_blocks.py

The separator change that gives derive_clobbers.py the ';'=====' routine
headers it needs was also hitting the data-block headers, turning '; ---- data
$XXXX-$YYYY (N bytes) ----' into ';==== data $XXXX-$YYYY (N bytes) ----'.
The conversion now only touches a line that is nothing but dashes.

_new _tools/analyze_data_blocks.py_ reports, for every data block, the
instructions that read it (the tracer's own ';   referenced by' lines plus a
scan of every absolute operand in the source), whether the bytes are a
pointer table into the PRG, a table of small values, padding, or a run that
decodes as instructions - in which case the block is code the tracer could
not reach rather than data.  That is the evidence a table's name has to be
based on.

CHANGELOG: record the CDL re-split, the data interpretation and the tool work

Port Test Cartridge (U): re-trace from the CDL and the unreached blocks

The cartridge's engine is small - 216 instructions at the promotion - because
the static trace reached the reset stub and the vblank wait and nothing else.
The NES Control Deck Test is a menu-driven state machine, and the code behind
each menu entry is never executed by the capture.

Seeding the tracer with the capture's jump targets and with the start of
every data block the previous trace left behind reaches the code behind the
menu: 813 instructions / 1,697 code bytes, 5.2% of the PRG against 0.7% at
the promotion.

Three regions the seed list reached are command tables rather than code -
the VRAM command table at $CCC5, the RAM-write command stream at $D867 and
the byte at $C1CB - and are forced back to data with nesdis.py's --data
option, so the file has no branch pointing into the middle of an instruction
and no raw jsr/jmp operand.

New _tools/code_data_seeds.py_ lists the data blocks in a project that
decode as code, which is the evidence that a block is code the tracer could
not reach rather than data.

Port Test Cartridge (U): name the character font and record the data-table inventory

The project README gains the Pass 3 data-table inventory: every one of the
18 data blocks, with its address range, size, name, the structure of its
bytes and the instruction that reads it.

Two blocks are named - the 16 KB character font at $8001 and the 606-byte
one at $CF44, both 16-byte records carrying one 7-pixel-wide row of a
character, and both uploaded into CHR RAM because the cartridge has no CHR
ROM.  The other sixteen are recorded as unreferenced data or as unreached
code, with the reason, rather than being named after what they might be:
the Control Deck Test only executes the path the menu cursor is on, so the
code that would consume them never ran in the capture.

The README's status, open-work and file sections are brought up to date.

Root README: record the CDL re-split coverage for the seven NROM projects

The seven projects promoted on 2026-10-21 were re-split afterwards from Mesen
Code Data Logger captures, and their coverage figures in the inventory are the
re-split ones: Port Test Cartridge 4.8%, 10-Yard Fight 32.0%, Chubby Cherub
41.4%, Dig Dug II 53.5%, Gyromite 31.0%, Hydlide 47.8%, Ice Hockey 39.5%.

AGENTS.md: record the CDL jump-target seed technique and the --base pitfall

Three lessons from the seven re-splits:

- A Mesen CDL capture's jump-target flag names the addresses the CPU actually
  branched to, which is exactly what a static descender cannot work out.
  nesdis.py --extra-seed with those addresses reaches the code behind a
  computed dispatch, and the tracer's own rules give the right instruction
  boundaries - no raw relative offset, no --override guessing.

- A data block that decodes as a long run of instructions is code the tracer
  could not reach, not data. code_data_seeds.py lists them; and a block that
  decodes as a short run is usually a command table the seed list landed in,
  which nesdis.py --data forces back.

- name_data_region.py needs --base for anything but a 16 KB PRG at $C000.

WIP.md: correct the tier's state table and the per-project states

The tier's state table claimed 851 Pass 0 skeletons.  Counting the
instruction lines in each project's prg.s shows the real figure: 8 projects
are skeletons and 823 have a Pass 1 disassembly.  Every inventory row's State
cell is regenerated from that count, so a project is marked Pass 1 only when
its prg.s really carries instructions.

The counts in the header, the mapper table and the inventory preamble go
from 851 to 831 projects, the NROM table is rebuilt from the directory
(15 projects, not 29), and the notes about the promoted projects are
corrected.

Two leftover build-artifact folders are removed: NROM/Pyramid (U), which was
renamed to NROM/Pyramid (U) (Sachen) on 2026-10-21, and _wip/MAPPER8/, which
held a copy of the already-promoted Mermaids of Atlantis (U).

Dig Dug II (U) [!]: interpret the data tables and record the inventory

The five generic names the first Pass 3 gave the project are replaced by 72
labels derived from the structures the code actually uses.

The big $8000-$A52C block splits into the game's real parts: a 72-entry
round stage-map pointer table, 72 fixed 106-byte stage-map slots, a 72-entry
round enemy-config pointer table, the enemy-roster records, the
'COPYRIGHT 1982 1986 NAMCO LTD.' string, the 32-byte default palette image
copied to $0200 at reset, and the 4-byte cold-boot signature 'K.N.'.

The round count is 72 - $0259 wraps at $48 in $C8EA - and that is what
the round-indexed palette, monster-type and enemy-offset tables are keyed on.
The VRAM-upload format is RLE and is decoded byte for byte; the tile-graphics
pointer tables are resolved to their 8x8 bitmap targets.

34 of the 37 tracer blocks carry at least one name. $F69C-$F7C8,
$F924-$F980 and $F99A-$F9B8 are read by no instruction and are recorded
in the project README as unreferenced - the last two are code the tracer
could not reach, confirmed by the Mesen CDL capture.

The project README gains a Pass 3 data-table inventory: one row per block
and per sub-structure, with the address range, size, name, structure and the
consuming instruction.  make still prints Byte-identical ROM verified.

derive_routine_docs.py: describe what each routine actually does

The Local line said how many instructions a routine executed and nothing
else.  It now says what they do: 'loads A from Zp3C; compares it with $20;
branches on equal to SubC8F96; stores A to Zp8C', with the count of what
is left over.  Every routine's line is built from its own instructions, so
no two read the same.

Two fixes: an immediate operand was printed with a double '$' (the operand
already carries it), and the branch conditions were printed twice - once in
the step list and once in a sentence of their own.

Rewrite the routine headers across the promoted tier

Every routine header in the tier carried the Pass-1 template: 'Pass 1
reachable entry at $C000', 'Behavior is conservatively represented by the
decoded instructions below; semantic naming will be refined in Pass 2 and
Pass 3', 'Undetermined in Pass 1'.  That is filler, and it describes the
process rather than the ROM.

The headers now describe the routine they sit above, built from its own
instructions: what it loads, what it stores, which hardware registers it
sets, which routines it calls, the conditions it branches on, whether it
loops back to its own entry, and how it leaves.  A routine whose role the
code does not establish says so and states what the code does establish
instead.

The Clobbers block of every header is derived by derive_clobbers.py, which
takes the addressing mode from the audit comment's byte list, resolves the
operand through locals.inc and symbols.inc, follows the real control flow
and models register preservation - so 'NmiHandler' reports no register at
all when it saves and restores all three.

derive_clobbers.py and derive_routine_docs.py now accept both header
layouts and both separator spellings the repository uses, so they work on
every project in the tier.

Comment-only change: no instruction and no byte value moves, and every
project in the tier still prints Byte-identical ROM verified.

CHANGELOG: record the tier-wide routine header rewrite

Chubby Cherub (U): interpret the data tables and record the inventory

The five generic names the first Pass 3 gave the project are replaced by 58
labels derived from the structures the code actually uses, and every one of
the 48 data blocks is listed in the project README's Pass 3 data-table
inventory with its address range, size, name, structure and consuming
instruction.

The breakthrough is the character encoding.  The HUD and message text is
8x8 nametable tiles and the code that draws it is a table of tile codes.
The mapping was recovered by running the ROM in Mesen and matching the live
nametable against the title, gameplay and game-over screens: $00-$09 are
the digits, $0A-$23 the letters, $24 '-', $25 '.', $26 the trademark,
$2D a heart, $2E '!', $2F the copyright sign, $30 a space and $33 a
blank.  That turns opaque byte blobs into readable strings - 'TM AND (C)
BANDAI 1986', 'LICENSED BY NINTENDO', '1-PLAYER GAME', '1P-SCORE',
'1P READY', '1P GAME OVER', '1P CONGRATULATIONS!', 'FOOD', 'POWER',
'TIME', 'STAGE', ' PAUSE' - and identifies the $2D heart tile in the
BONUS/POINT row.

Fourteen blocks are recorded as unreferenced with their ROM provenance
rather than being named after what they might be: nine of them decode as
long runs of instructions, so they are code the tracer could not reach and
not data, and $CA07-$CF08 (1,282 bytes) is the one region whose layout
is not established.

make still prints Byte-identical ROM verified.

Complete the routine headers across the tier, in every header layout

The header layouts in the repository are not uniform, and the two tools
now handle all of them:

- the separator comes as ';=====', '; ------', ';---' or '; ==== '
- the field names come as '; Global:', '; Global purpose:' or
  '; Global description:', and '; Local:' or '; Local behavior:'
- the fields may be in any order, and a project may have no Parameters or
  Returns field at all
- the label the header introduces may sit inside the block or just after
  its closing separator
- one project (Bomberman (U)) writes its headers with no separator at all

Two real bugs are fixed on the way:

- derive_clobbers.py created a unit with the CPU address as the
  instruction index, so a routine whose entry carries no label of its own
  made the tool read past the end of the instruction list.  That is what
  stopped it running on Wild Gunman (U) and Pac-Man (USA) (Namco).
- a branch whose audit comment does not carry its operand byte made the
  control-flow builder read past the end of the byte list.

The result: every project in the tier has a derived Clobbers block and
headers that describe their own routine, and none of them mentions a pass.
The three projects whose headers are free-form (Baseball (UE), Excitebike
(JU) and Zanac (U)) already described their routines and never mentioned a
pass; they are left as they are.

Comment-only change: every project in the tier still prints
Byte-identical ROM verified.

Complete Pass 2 across the tier: no Label_ residue left

Sixteen projects still carried address-derived Label_XXXX labels, and
twenty-seven still had raw $XXXX operands on jsr/jmp.  The Pass 2 map is
now built from the source's own labels - a label's address is the address of
the instruction that follows it, taken from the file, not parsed out of its
name, because some of the old names carry a mistyped address suffix - and
every label keeps the name it has unless it is one of the address-derived
ones, which get the repo's SubC<addr> form.

Three more real defects in the tools are fixed:

- derive_branch_names.py named a jsr/jmp target that no instruction sits at.
  Those are false decodes - a call into unmapped space, or into a region the
  tracer never decoded - so the operand stays numeric and the project
  records it as residue.

- apply_pass2_map.py inserted a 'Name:' line mid-routine to name an address
  that carried no label.  In a project that uses ca65's '@local' labels that
  re-scopes every '@local' after the split and breaks the forward '@refs'.
  There the name now becomes an equate in locals.inc, which names the
  address without touching the label scope.

- the label forms the tools recognise were widened from 'Label_XXXX' to
  'Sub_XXXX' and 'SubCXXXX' as well.

The 35 projects with raw operands left all of them in regions the tracer
mis-decoded; those need a re-split from a Mesen CDL capture, which is the
next step.  Every project still prints Byte-identical ROM verified.

Urban Champion (JU): re-split Pass 1 from the Mesen CDL captures

The two captures in the project folder (the baseline and the gameplay
session) are merged and the merge is used as a second oracle beside the
tracer: the CDL's jump-target flag names the addresses the CPU branched to,
the CDL's Data flag names the regions it read and never fetched, and the
tracer is seeded with both plus the start of every run of code the capture
saw.

The split goes from 33.8% code to 48.6%: 3,856 instructions / 7,958 code
bytes against 2,356 / 5,521.  The 220 raw jsr/jmp operands are gone.

Two new tools: merge_cdl.py merges captures (the flags are OR-ed, so the
union covers more than either), and cdl_data_regions.py lists the regions the
capture says are data, for nesdis.py's --data option.

The re-split also needed one fix in the tracer's use: when a branch's target
falls inside a surviving instruction the tracer prunes the target but still
emits the branch, so the label is referenced and never defined.  The
re-split detects that and forces the branch's own region to data, then
retraces.

apply_pass2_map.py: do not write the same equate twice

The equates go in locals.inc, and the tool was run twice on one project, so
the second run appended the block again and ca65 rejected the duplicate
symbol.  The equate list is now checked against what locals.inc already
holds, and only the new ones are written.

Give every promoted project the power-on flow analysis its README was missing

PROMPTS.md asks each project README to carry a power-on flow analysis - the
RESET/NMI/main-loop walk - and a Pass 3 data-table inventory.  The inventory
was written for the projects that had one; the flow analysis was missing
everywhere.

_new _tools/derive_poweron.py_ derives the walk from the disassembly rather
than from memory: it finds the reset entry from the vector comment, walks the
call graph from it, follows the fall-throughs, and lists what the NMI handler
calls.  It also says whether the IRQ vector reaches the reset path.

_new _tools/add_poweron.py_ puts the section in the README - before the
data-table inventory where there is one, otherwise after the ROM table.

All 61 promoted projects now carry the section.

Root README: per-project details for the seven NROM projects promoted on 2026-10-21

Port Test Cartridge (U), 10-Yard Fight (U), Chubby Cherub (U), Dig Dug II (U)
[!], Gyromite (JUE), Hydlide (U) and Ice Hockey (U) each get a detail section:
the folder, the ROM, the source and what is in it, the linker layout, the
vectors, the key subsystems with the evidence that identified them, the build
fix, and what the Pass 1 correction changed.

Donkey Kong (JU): re-split Pass 1 from a Mesen CDL capture

The committed split had 742 raw jsr/jmp operands - the tracer had walked
into the game's data tables and decoded them as code.  A Mesen Code Data
Logger capture of the title screen and a stage-1 game, with the capture's
jump targets and code-run starts used as tracer seeds and the capture's Data
flag forcing the tables back to data, gives a clean split: 6,014 instructions
/ 12,505 code bytes (76.3%), 1,015 labels, and no raw operand left.

Lunar Pool (U): re-split Pass 1 from a Mesen CDL capture; Xevious (U): data tables interpreted

Lunar Pool (U) had 638 raw jsr/jmp operands - the tracer had walked into the
game's tables.  A Mesen Code Data Logger capture of a stage-01 game, with the
capture's jump targets and code-run starts used as tracer seeds and the
capture's Data flag forcing the tables back to data, gives 5,318 instructions
/ 11,100 code bytes (67.7%) and no raw operand left.

Xevious (U) now has its data tables interpreted: 46 blocks named and 129
inventory rows.  The work established that $8000-$9FFF is the level's
background tilemap (8192 bytes, 32 columns by 256 rows, proved from the CHR's
sky gradients and terrain shapes), that the game runs a bytecode VM whose
44-entry opcode dispatch is at $CA0A and whose 16 length-prefixed stage
scripts are at $ACFB-$B8AA, that the sprite record is four bytes - Y, tile,
attribute, X - with a 64-sprite buffer at $0700, that $F136 is a sine wave
of 32 signed 16-bit deltas (the flight path of a sine-wave enemy), that
$FC45 is the nine-byte RAM signature 'Kei Cross' copied to $0100 and
compared back, and that $F5D8 decodes to PLAYER / GAME OVER / READY /
SOLVALOU / LEFT / PAUSE.

Lode Runner (U) and CIRCUS: re-split Pass 1 from Mesen CDL captures

Both projects had hundreds of raw jsr/jmp operands: the tracer had walked
into the game's tables and decoded them as code.  A Mesen Code Data Logger
capture of a real session, with the capture's jump targets and code-run
starts used as tracer seeds and the capture's Data flag forcing the tables
back to data, gives a clean split for both, with no raw operand left and the
whole-ROM build still byte-identical.

Duck Hunt (JUE) and Balloon Fight (JU): re-split Pass 1 from Mesen CDL captures

Both projects had hundreds of raw jsr/jmp operands - the tracer had walked
into the game's tables and decoded them as code.  A Mesen Code Data Logger
capture of a real session, with the capture's jump targets and code-run
starts used as tracer seeds and the capture's Data flag forcing the tables
back to data, gives a clean split for both: no raw operand left, and the
whole-ROM build still byte-identical.

Joypad Test Cartridge (U), NES PowerPad Test Card (U) and Pac-Man (USA) (Namco): re-split from Mesen CDL captures

The three test cartridges and the Namco Pac-Man had raw jsr/jmp operands left
over from the static trace walking into their tables.  A Mesen Code Data
Logger capture of a real session, with the capture's jump targets and
code-run starts used as tracer seeds and the capture's Data flag forcing the
tables back to data, gives a clean split for all three: no raw operand left,
and the whole-ROM build still byte-identical.

Repair the damaged audit trails across the tier

Thirteen projects carried audit comments that did not match prg.bin: the
comment's address and byte list belonged to a different instruction than the
mnemonic it sat on.  Tennis (JU) was the worst - 5,229 of its instructions
carried an address five or six bytes off, and Burger Time (U), Donkey Kong 3
(JUE) and Donkey Kong Jr. (JU) were damaged in the same way.  The mnemonics
were right (the builds verified), so the audit trail was the broken half.

repair_audit_comments.py rebuilds the trail from the ca65 listing, using
prg.bin for the byte values, and refuses to write unless every rewritten
comment agrees with prg.bin.  Three things had to change in the tool for it
to run at all on this tree:

- ca65 2.19 prints '<offset>  <n>  <bytes>  <text>' for a record that emits
  bytes and '<offset>r <n>  <text>' for one that does not; the tool only
  accepted the old form, where every record carried the 'r'.

- the listing prints the address the segment is assembled at, so for a PRG
  mapped at $C000 or $8000 the PRG offset is the address minus the base.
  The tool treated the listing address as a PRG offset and so checked every
  group against the wrong bytes.

- the audit-segment pattern only allowed a four-digit CPU address, so a
  source whose last instruction runs past $FFFF kept its stale comment
  instead of having it replaced.

All 322,830 audit comments in the tier now agree with prg.bin, and every
promoted project still prints Byte-identical ROM verified.

Tennis (JU): finish Pass 2 and Pass 3 over the repaired trail

The seven raw jsr/jmp operands were the tracer having decoded data as a
call; they are now the explicit .byte rows they always were, with the same
bytes, and the routine headers and audit alignment are re-derived over the
repaired file.  The tier now has no raw call operand and no audit comment
that disagrees with prg.bin.

_new _tools/build_routinemap.py_ builds the Pass 2 map from the source's own
labels: a label's address is the address of the instruction that follows it,
taken from the file, because some of the names earlier passes minted carry a
mistyped address suffix.  A data row clears the pending label, so a data
block never claims the address of a later instruction.

Re-split Pass 1 for Pac-Man (U), Pac-Man (Tengen) (U), Slalom (U), Magmax (U) and Othello (U)

Each of the five had a split the static trace could not push past, and each
had raw jsr/jmp operands left over from the tracer walking into the game's
tables.  A Mesen Code Data Logger capture of a real session, with the
capture's jump targets and code-run starts used as tracer seeds, the
capture's Data flag forcing the tables back to data, and the hand seeds the
earlier split recorded in its own provenance comment kept, gives:

  Pac-Man (U)           18.7% -> 45.9%   3,734 instructions / 7,528 bytes
  Pac-Man (Tengen) (U)  20.0% -> 47.3%   3,842 instructions / 7,744 bytes
  Slalom (U)            32.1% -> 31.8%   4,983 instructions / 10,414 bytes
  Magmax (U)            35.4% -> 36.5%   5,696 instructions / 11,954 bytes
  Othello (U)           43.3% -> 44.0%   6,804 instructions / 14,403 bytes

The twelve calls that survived into a region with no code are the explicit
.byte rows they always were, with the same bytes.  Every project still
prints Byte-identical ROM verified.

Give every routine header a contract that is its own

Two things made the headers read the same in every routine of a project.

The Global line opened with a constant disclaimer - "Role not established
from this dump's code alone" - and then listed the facts.  The disclaimer
said nothing about the routine, so it was filler.  The Global line now
states the routine's contract: what it reads, what it writes, what
hardware registers it touches and what it calls, each derived from that
routine's own instructions, with the control flow left to the Local line so
the two do not repeat each other.  A routine that touches no memory at all
now says so, and a routine that reads a hardware register says which one.

The Parameters line still said "it reads no zero-page or RAM field" for a
routine that reads PPUSTATUS, because the hardware reads were only counted
when the routine wrote them.  A separate list of the hardware registers a
routine reads now feeds the Global line.

derive_clobbers.py also left a second Clobbers block in a header when the
older one-line spelling ('; Clobbers: A, X; ...') was present: it removed
only the multi-line form.  Both spellings are removed now, and the derived
block replaces them.

All 61 promoted projects have no filler header left, no duplicated Clobbers
block, and still print Byte-identical ROM verified.

Zanac (U): trace bank 6, and give the project a build that can hold it

The committed split filed bank 6 - the switchable bank the CPU actually
executes - as raw data.  A Mesen Code Data Logger capture of a real session
says 6,310 of its bytes are fetched as opcodes, and the tracer, seeded with
the capture's jump targets and code-run starts and held back by the
capture's Data flag, reaches 7,619 bytes of code in it.

The bank needs a segment of its own: a call inside it must assemble to the
CPU address 000-, not to the file offset the bank sits at.  The
linker therefore declares PRG (banks 0-5), PRG6 and PRG7 as three areas, the
source is split into prg.s, prg.6.s and prg.07.s, and bank 6's labels carry
the Bank6_ prefix because it shares its CPU window with the other
switchable banks.

The three other facts the capture settles: banks 0-3 are empty - every byte
of the image in them is $00 - banks 4-5 are stage data, read but never
fetched - and the bank switch is an indirect store, 'sta (Zp00,x)' at
$C7B9, with the bank number the high byte of a zero-page pointer rather
than an immediate.

The coverage goes from 32.5% to 44.5% of the 128 KB image.  Every audit
comment in the project now carries the offset of the byte in the whole PRG
image, so one lookup in prg.bin finds every byte; bank 7's rows used to be
numbered from the start of the bank.

Zanac (U): name the cross-bank calls and finish Pass 2 over bank 7

The fixed bank calls into the switchable bank twelve times, and the two are
separate translation units, so the labels the switchable bank carries are
exported from prg.6.s and imported into prg.07.s.  The one call left over
points into unmapped space and is the explicit .byte row it always was.

Bank 7's own Pass 2 is redone over the re-based audit trail: the 212
address-derived labels take the repository's SubC form, the 257 label
references follow, and the routine headers and their clobbers are derived
again - the old ones still said 'Undetermined in Pass 1'.

Zanac now has 44.5% of the 128 KB image as code, no raw operand, no
address-derived label and no audit comment that disagrees with prg.bin.

Interpret the data tables across the tier

Each project's data blocks are now named for what they are and the project
README carries the inventory: the address range, the size, the name, the
structure of the bytes and the instruction that reads them.

Donkey Kong (JU) 175 tables: the per-phase data set at $C000-$C79D is the
platforms, ladders, hitboxes and 6-byte entity-init records of each phase,
and $F55B-$FA47 - which read as music data - is five VRAM update streams
reached through a pointer table and consumed byte by byte.

Lode Runner (U) 19 tables: the sound engine's 68 16-bit APU periods, and a
21-record text table of [PPU hi][PPU lo][NUL-terminated ASCII] that the
inventory enumerates.

Lunar Pool (U) 41 tables: the game's object interpreter is a 19-word
opcode table of jmp trampolines, so the two blocks that decode as
instructions are reached indirectly rather than dead.

Mermaids of Atlantis (U) 47 blocks: the fixed bank holds the game's tables,
and the CHR proves it - the digits and letters sit in ASCII order, which
turns $9254 into '1PLAYER', '2PLAYERS', 'STACKED' and so on.

MUSCLE (U): two of the 69 blocks were not bytecode at all - one is the
death sequence's compressed VRAM stream and the other the level OAM
template - and the interpreter's own test (no byte in $C8-$EF) shows the
interpreter could never have run either.

Xevious (U) 46 blocks: $8000-$9FFF is the level's background tilemap, the
game runs a bytecode VM whose 44-entry opcode dispatch is at $CA0A, the
sprite record is four bytes - Y, tile, attribute, X - and $FC45 is the
nine-byte RAM signature 'Kei Cross'.

Ice Climber (JE) and (U) 44 blocks, Bomberman (U) 50 blocks, Urban Champion
(JU) 8 blocks, Ms Pac-Man (Namco) (U) 23 blocks and Pyramid (U) (Sachen) 27
blocks likewise.

Every project still prints Byte-identical ROM verified.

CHANGELOG: move the committed entries into History

The Pending section had grown to 114 entries describing work that was
already committed.  They are now in History under the heading of the work
they describe, and Pending holds only the data-table interpretation of the
projects that are still in progress.

Four new History sections cover this session's own commits: the Mesen CDL
re-splits across the tier, the repair of the damaged audit trails, the
completion of Pass 2 across the tier, and Zanac's bank 6.

Root README: refresh the coverage column of the project inventory

Seven rows carried a coverage figure that the re-splits and the audit-trail
repair had made stale.  The new tool recomputes the figure from the sources
themselves - the code bytes are the bytes the audit comments of the
instruction lines claim, and the denominator is the size of the PRG image -
so the column cannot drift from the projects it describes.

Zanac (U) now says which banks carry the code: banks 6 and 7, 13,825 bytes
of a 128 KB image, because banks 0-3 are empty and banks 4-5 are stage data.

Root README: refresh the source shapes the re-splits changed

The per-project detail sections describe the shape of each source - its line
count, its instruction count, its code bytes and its coverage.  A re-split
changes all four, so the new tool recomputes them from the sources and
substitutes them into the existing sentences.

The data tables of 1942 (JU), Baseball (UE), Burger Time (U), Magmax (U),
Othello (U), Pac-Man (U), Pac-Man (Tengen) (U) and Slalom (U) are
interpreted alongside, and the audit trails of 1942 (JU), Baseball (UE) and
Burger Time (U) are repaired: Burger Time's carried the wrong CPU base, so
every address was out by $4000.

AGENTS.md: record what this session's work established

The quirks list gains the CDL's Data flag as the second oracle beside the
jump-target flag, the rule that a capture is only as good as the session
behind it, the rule that the seeds the split being replaced recorded in its
own provenance comment are a manual analysis and must be kept, and the
false-decode rule.

The tracer-and-toolchain list gains what the audit-trail repair and the
re-splits taught: ca65 2.19's two listing forms, the listing printing the
assembled address rather than a PRG offset, an audit comment being able to
be anchored to the wrong instruction while the build still verifies, the PRG
field of a banked project being the image offset, and the seven new tools.

TODO.md: bring the handoff up to date

The file still described the 41-project tier.  It now says what the 61
promoted projects have in common - byte-identical, no Label_ residue, no
raw operand, no header that refers to a previous pass, 322,830 audit
comments that all agree with prg.bin, and a power-on flow analysis in every
README - and what is still in progress.

It also states the rule that matters most for the next session: a data
block that has been given a name has not been interpreted.

Give every branch target a role name, and close the rest of the checklist

_new _tools/audit_promoted.py_ checks the promoted tier against all eleven
items of PROMPTS.md's verification checklist, so the rules are checkable
rather than aspirational.

Three gaps it found, now closed:

- **1,487 branch targets carried an address-derived name.**  PROMPTS.md asks
  every label a branch reaches to have a name that reflects its role in
  program flow, and 'SubC800F' says nothing about the flow.  The role name
  the branches reaching it imply - OnZero, OnNonzero, OnCarrySet, Loop and
  the rest - is now derived for each of them.  derive_branch_names.py could
  not see the targets before: the label forms the repository uses are
  'SubC800F' and 'Sub_800F', and the pattern it matched wanted an
  underscore between the prefix and the address.

- **48 operands named a hardware register by its address.**  Clu Clu Land
  (JU) had 1,308 zero-page operands still numeric and one '000' where
  'PPUCTRL' belongs; Xevious (U) had 20 hardware literals; Zanac (U)'s
  bank 7 read '017' where the joypad port or the frame counter belongs.
  Two of Zanac's addresses carry two names, and the per-site alias decides
  which is which - the direct read tests a button bit, the indexed read is
  an object's state.

- **325 neutral zero-page slots carried no reason.**  locals.inc now says,
  per slot, that the name is provisional.

The tools grew to match: apply_symbols.py accepts an upper-case mnemonic,
apply_zp_aliases.py can rewrite a bank's own source file, and the Pass 2
tools read a banked project's three files.

Every project still prints Byte-identical ROM verified.

PROMPTS.md: the checklist now has a checker

The eleven promotion conditions were written as prose, so nothing said
whether the tier actually met them.  _tools/audit_promoted.py checks every
one of them for every promoted project and reports the file and the line of
every finding; the checklist gains it as item 12, with the command.

CHANGELOG: record the checklist work

audit_promoted.py: count an inventory row wherever the address sits

Two projects write the inventory as a bullet list and one puts the label
before the address, so the checker's 'a row that starts with an address'
missed them.  A row now counts when it holds a $XXXX address in any cell.

Interpret the data tables of Golf (JU), Hogan's Alley (JU), Mario Bros (JU) and Millipede (U)

Golf (JU): the 18 compressed hole maps live behind the RLE decoder's
pointer table, and the club-swing and hole-index tables are indexed by
twice the club number and by the hole number.

Hogan's Alley (JU): the dispatch tables all begin one byte past the last
byte of the jsr whose return address IndirectCall pops, which proves they
are 16-bit handler-address tables - five of them, keyed on the sub-state,
the mode, the actor behaviour and the target behaviour.

Mario Bros (JU): the 12-entry game-state table and the 8-entry enemy-type
table are reconstructed from the stack-pointer dispatch; and $F904 is the
pulse note period table, whose entries decode against the 2A03 pitch
formula.

Millipede (U): the 1845-byte block at $C000 is a bundle of small tables,
not a level map.

Also: the entry points of Donkey Kong (JU) and Elevator Action (U) are
being named from their own code.

Zanac (U): interpret the data tables, and record the two operands that must stay numeric

Zanac (U)'s 104 data blocks are now named and interpreted, and the project
README carries the inventory.  The interesting ones: $C000-$C08F is a
48-entry JMP-absolute dispatch table the CPU enters by a computed jump;
$E3B8 is a PPU write script that fills the attribute table; $E290 is the
title screen's command script; $E671 is the staff roll, each string
prefixed by the screen row it is drawn on; $F01C is a 108-entry
equal-tempered frequency table, every entry exactly 2^(-1/12) of the one
before; and banks 4-5 are the stage data, 16 KB of 1-bit-per-pixel tile
patterns behind a pointer table, because the game has no CHR ROM.

name_data_region.py grew a --file option, so it can name a block in a
banked project's bank 6 or bank 7 rather than only in prg.s.

Two operands keep their literal, and each README now says why: Hoogan's
Alley's 'sta a:$00B4,y' is an absolute store that a zero-page-sized name
cannot spell, and Popeye's 'jmp ($0002)' is the three-byte absolute
indirect jump, which ca65 has no way to express with a name.

Popeye (JU) (PRG 1): record why the indirect-jump operand keeps its literal

Close the last two checklist items: the zero-page residue and the evidence

PROMPTS.md's item 8 asks that apply_symbols.py leave no resolvable operand
numeric without justification.  Four projects had residue:

- **Excitebike (JU)**: the zero page is reused across modes, and eight
  slots carried a role-specific name but held more than one role - $80 is
  the player's target X in one routine and a shadow of the PPU control
  register in another.  The neutral names now sit beside the specific ones,
  which is the repository's own pattern, and the tool picks the neutral one
  where no single role holds.  Its residue is zero.
- **Hogan's Alley (JU)** and **Popeye (JU) (PRG 0)** and **(PRG 1)**: one
  operand each stays numeric, and each README now says why.  'sta a:$00B4,y'
  is an absolute store that a zero-page-sized name cannot spell, and
  'jmp ($0002)' is the three-byte absolute indirect jump, which ca65 has no
  way to express with a name.

apply_symbols.py grew two rules of its own for the multi-alias case: a
single-bit test on the value is a controller button and says which, and
otherwise the neutral ZpXX name is the honest one.

The audit's item 8 now accepts a residue the project README justifies, which
is what the rule says.

Every project still prints Byte-identical ROM verified.

CHANGELOG: record the zero-page residue work

Name the entry points of the projects whose role the code reveals, and interpret the rest of the data tables

**Entry points.**  PROMPTS.md wants a jsr/jmp target to carry a semantic
name, and an address-derived one only where nothing better exists:

- **Donkey Kong (JU)**: 358 named, none left.  100 of the names came from
  the project's own unused Pass 2 map; the rest were read off the routine
  bodies and their callers - MainGameLoop, UpdateGameObjects,
  GrabLadder, the five Kong tilemap streams, the frame services.
- **Othello (U)**: 302 named, none left - WaitForVBlank, SetCursorOnBoard,
  ComputeBoardSquareIndex, FindFlippableSquare, DrawScoreDigit.
- **Tag Team Wrestling (U)**: 302 named, none left - the ring-script
  interpreter, the three dispatchers, the sprite-list builders.
- **Clu Clu Land (JU)**, **Defender 2 (U)**, **Donkey Kong 3 (JUE)** and
  **Donkey Kong Jr. (JU)**: their data tables are interpreted.

**Data tables.**  Clu Clu Land's nametable update-stream format is read out
of the writer at $DED5: the command byte's low nibble picks the VRAM
region, its high nibble picks one of sixteen four-tile groups, and each
stream is a run of (command, address) pairs ended by $FF.  Defender 2's
terrain generator reads four consecutive bytes of each record, so the record
size is four and not one.  Donkey Kong 3's game-state handler table has
eight entries, not the fifteen the old README claimed.

name_data_region.py now cuts a .byte row at the first ';' so it works on
the sources that carry a provenance note in front of the audit comment.

Every project still prints Byte-identical ROM verified.

The promoted tier now passes every item of the promotion checklist

python3 _tools/audit_promoted.py --build reports nothing for all 61
projects.

**Data tables.**  CIRCUS, Duck Hunt (JUE) and Balloon Fight (JU) join the
rest.  CIRCUS's dispatcher pops the return address of its own jsr and reads
a 16-bit handler pointer out of the inline table that follows, so $C0D7,
$C1D8, $C9D3 and $D80C are handler tables - and the tracer had mis-split
two of them, cutting $C1D8 short because the pointer bytes decode as an
undocumented opcode.  Duck Hunt's $E64B is the duck's 24 ascending speed
table.  Balloon Fight's $D65C is 64 little-endian nametable addresses.

**Entry points.**  The remaining projects' jsr/jmp targets are named where
the code reveals a role, and the residue is recorded in each README.

**One more tool fix.**  name_data_region.py cuts a .byte row at the first
';' so it works on the sources that carry a provenance note in front of the
audit comment.

Every project still prints Byte-identical ROM verified.

CHANGELOG: record the tier passing the checklist

Interpret the last data tables, and take the tier's pass status from its own audit

**Data tables.**  Tag Team Wrestling (U), World Class Track Meet (U),
Wild Gunman (U) and Tennis (JU).

Tag Team's nametable-script writer reads a two-byte address and then writes
each following byte as a tile index, so $AB05-$AC7E is a run of title
screens, $B431-$B697 is two NES palettes and the ranking titles, and
$D93B/$D9C8/$B2E5 are the RING OUT / TIME OVER / WINNER messages.  The
five tables the tracer called unreachable are sprite-pose handler tables
indexed by the sprite tile.

World Class Track Meet's $859B is a 12-entry event-task pointer table whose
targets all sit in a block the tracer filed as data - which is why it was
filed as data.  Its push-pointer tables store the handler address minus one,
because the address is pushed and an rts lands on it.

Wild Gunman's earlier Pass 3 was hollow: the tracer reached 49.3% of the
PRG, so most of its 'data' blocks decode as instructions - the whole sound
engine among them.  The wrong SpritePositionTable name is gone.

Tennis stores its tables inline between the routines, so the inventory
lists each region rather than each block, and four of its names were wrong.

**Root README.**  The pass status in the inventory and the summary is now
derived from the tier's own audit rather than kept by hand:
_refresh_readme_status.py_ rewrites the column from what
_audit_promoted.py_ finds.

Every project still prints Byte-identical ROM verified.

Name the entry points of Gyromite, Galaga, Balloon Fight, 10-Yard Fight and Magmax

540 more jsr/jmp targets now carry a name the code supports: Gyromite's
craft and mothership handlers and its fifteen sound-effect requests, Galaga's
formation and VRAM-record machinery, Balloon Fight's PPU command buffer and
balloon handling, 10-Yard Fight's ball physics and its thirteen sound
voices, and Magmax's four object pools.

Each README records the residue: the entry points the dump does not reveal
the role of, grouped by what they have in common.

Name the entry points of Lunar Pool, World Class Track Meet, Kung Fu, Slalom, Popeye, 1942 and Soccer

1,159 more jsr/jmp targets now carry a name the code supports.

Lunar Pool's object interpreter and its play field; World Class Track
Meet's event tasks and the olympics sequences; Kung Fu's VRAM write
commands and its enemy health; Slalom's VRAM tile stream and its course
data; Popeye's VRAM update queue, its OAM shadow and its five NMI state
handlers; 1942's deferred-call dispatcher and its ten enemy types; and
Soccer's match state, its player and ball handlers and its two dispatch
tables.

Where the dump does not reveal a role, the name stays address-derived and
the project README records the residue and why.

Root README: take the pass status from the tier's audit

refresh_readme_status.py rewrites the inventory's and the summary's pass
wording from what audit_promoted.py finds, so the two cannot disagree.
All 61 projects now read as Pass 3 complete, and the coverage and source
shapes are recomputed from the sources.

Remaining entry-point naming

Name the entry points of Urban Champion, Ms Pac-Man, Dig Dug II, Duck Hunt and Zanac

665 more jsr/jmp targets now carry a name the code supports.

Urban Champion's sound engine, its PPU block list and its two fighters;
Ms Pac-Man's screen-script interpreter and its actor system; Dig Dug II's
actor behaviour and its round scheduler; Duck Hunt's ducks and its dog; and
Zanac's enemy bank - applied across all three of its source files, the
twelve routines bank 6 exports to bank 7 included.

Ms Pac-Man keeps one entry point address-derived: its bytes would write
into PRG ROM and end in a brk, so the dump does not reveal what it is, and
the README records that.

CHANGELOG: record the entry-point naming

Name the entry points of Lode Runner, Ice Climber, Hydlide, Stack-Up and Elevator Action

Re-align the audit comments to the canonical column

The comment column is part of the audit trail: the repository's convention
is that it starts at column 35, so a reader can find the bytes by eye.
Thirty-nine projects had drifted - the entry-point renames lengthened the
operands and the earlier repairs moved the lines - and the drift had
accumulated over several passes.

align_audit_comments.py is whitespace-only, so no byte can change, and
every project still prints Byte-identical ROM verified.

Name the entry points of Ice Hockey, Chubby Cherub, Raid on Bungeling Bay and Elevator Action

1,127 more jsr/jmp targets now carry a name the code supports.

Ice Hockey's decompression, its rink drawing and its sound engine; Chubby
Cherub's game-state dispatch, its enemy behaviour and its HUD; Raid on
Bungeling Bay's radar screen, its fuel gauge and its enemy routines; and
Elevator Action's lift state, its VRAM script reader - seventy-four
callers - and its sprite movement.

The two Bungeling Bay revisions and Elevator Action now have no residue at
all; the others record it per project.

CHANGELOG: record the audit-comment re-alignment

Remaining entry-point naming

Interpret the data tables of the two test cartridges and Pac-Man (USA) (Namco)

**Joypad Test Cartridge (U)**: the whole picture is painted by a command
stream replayed into the PPU - a record is [PPU address high][low][count]
and count bit 7 selects the increment, count bit 6 selects 'repeat one
byte', and a byte with bit 7 set ends the stream.  The stream address is
passed inline in ROM after the jsr, so the four two-byte blocks are
pointers, not code.

**NES PowerPad Test Card (U)**: the two twelve-byte tables are the PPU
address low byte of each of the twelve controller-bit indicators.  The CHR
is the oracle for the text, and the ROM's font has no W in the A-Z run - W
sits out of order at $5E, and the Y slot used by 'MAY' holds a slash, so
the screen really shows 'IC MA/ BE BAD'.

**Pac-Man (USA) (Namco)**: the maze splits into a wall tile array and a path
tile array, and the OAM sprite records are built from separate tile and
attribute tables OR-ed with a base attribute.  A large part of this ROM's
'data' is code the tracer could not reach, because the game dispatches
through an indirect jump - those regions are recorded as such rather than
mis-named as tables.

CHANGELOG: record the tier reaching completion

Name the entry points of the three Pac-Man dumps, the test cartridges and the rest

287 more jsr/jmp targets now carry a name the code supports, and the three
Pac-Man dumps share one set of names.

Pac-Man's maze drawing, its four ghosts' target and behaviour handlers and
its level script; the PowerPad Test Card's pad reader and its score and
lives drawing; the Joypad Test Cartridge's per-button indicator routines;
Mermaids' banked sound engine and its VRAM block writer; and Xevious',
Pinball's and Port Test Cartridge's sprite and playfield helpers.

Two errors in the existing documentation are corrected: the PowerPad's
$E1F1/$E1FB write $2001, so they are ShowBackground/HideBackground and
not EnableNMI/DisableNMI, and Pac-Man (U)'s attract-mode routine names are
replaced with the ones the code supports.

Every project still prints Byte-identical ROM verified.

CHANGELOG: the final entry-point numbers
2026-10-22 00:33:54 -04:00

16 KiB

18000Reset
2806FSubC806F
38079NmiHandler
480DDSubC80DD
58163SubC8163
68331SubC8331
7834DSubC834D
88351SubC8351
9835CSubC835C
108365SubC8365
11836CSubC836C
12838CSubC838C
13857BSubC857B
1487BASubC87BA
1587F1SubC87F1
168825SubC8825
178859SubC8859
1888D9SubC88D9
1988E7SubC88E7
2088F5SubC88F5
218900SubC8900
22890DSubC890D
23891ASubC891A
248959SubC8959
258960SubC8960
2689BFSubC89BF
278A5BSubC8A5B
288A72SubC8A72
298A81SubC8A81
308A8CSubC8A8C
318A9FSubC8A9F
328D04SubC8D04
338D3ESubC8D3E
348D4ESubC8D4E
358D87SubC8D87
368DE5SubC8DE5
378E21SubC8E21
388E55SubC8E55
398E8FSubC8E8F
408E9CSubC8E9C
418EE2SubC8EE2
428EFASubC8EFA
438FAASubC8FAA
448FE3SubC8FE3
459096SubC9096
46911ESubC911E
479143SubC9143
48916ESubC916E
49918BSubC918B
5091A8SubC91A8
5191E1SubC91E1
529229SubC9229
53922BSubC922B
5492FBSubC92FB
55936ASubC936A
5693BASubC93BA
5793FDSubC93FD
589426SubC9426
599469SubC9469
609471SubC9471
619512SubC9512
6295B6SubC95B6
639608SubC9608
649631SubC9631
65965ASubC965A
669677SubC9677
679694SubC9694
6896AASubC96AA
6996E9SubC96E9
70977DSubC977D
7197D4SubC97D4
72980FSubC980F
739884SubC9884
7498FDSubC98FD
7599C6SubC99C6
769A5CSubC9A5C
77A07ESubCA07E
78A0E1SubCA0E1
79A165SubCA165
80A18FSubCA18F
81A1BASubCA1BA
82A1D5SubCA1D5
83A1F0SubCA1F0
84A252SubCA252
85A2B4SubCA2B4
86A2D9SubCA2D9
87A2FFSubCA2FF
88A318SubCA318
89A37FSubCA37F
90A40FSubCA40F
91A443SubCA443
92A47ESubCA47E
93A488SubCA488
94A4A5SubCA4A5
95A4C2SubCA4C2
96A4CDSubCA4CD
97A52FSubCA52F
98A581SubCA581
99A679SubCA679
100A764SubCA764
101A793SubCA793
102A7D7SubCA7D7
103A8D3SubCA8D3
104A8DCSubCA8DC
105A908SubCA908
106A940SubCA940
107A9CCSubCA9CC
108AA22SubCAA22
109AA4ESubCAA4E
110AA7BSubCAA7B
111AA95SubCAA95
112AAC1SubCAAC1
113AADBSubCAADB
114AB6FSubCAB6F
115ABA0SubCABA0
116AC23SubCAC23
117AC3FSubCAC3F
118AC77SubCAC77
119ACB0SubCACB0
120ACC1SubCACC1
121ACEBSubCACEB
122ACFCSubCACFC
123AD54SubCAD54
124ADFFSubCADFF
125AE01SubCAE01
126AE87SubCAE87
127AF14SubCAF14
128AF22SubCAF22
129AF4ASubCAF4A
130AF94SubCAF94
131AFD8SubCAFD8
132AFDFSubCAFDF
133B02ASubCB02A
134B04BSubCB04B
135B069SubCB069
136B095SubCB095
137B0EASubCB0EA
138B0F4SubCB0F4
139B104SubCB104
140B15CSubCB15C
141B16DSubCB16D
142B17CSubCB17C
143B19DSubCB19D
144B1BFSubCB1BF
145B1DASubCB1DA
146B1F8SubCB1F8
147B20ASubCB20A
148B220SubCB220
149B230SubCB230
150B239SubCB239
151B244SubCB244
152B28BSubCB28B
153B29BSubCB29B
154B29FSubCB29F
155B2A3SubCB2A3
156B2A7SubCB2A7
157B2ABSubCB2AB
158B2AFSubCB2AF
159B2B3SubCB2B3
160B2B7SubCB2B7
161B2C2SubCB2C2
162B2D5SubCB2D5
163B2DDSubCB2DD
164B2E5SubCB2E5
165B2E9SubCB2E9
166B2F1SubCB2F1
167B2FCSubCB2FC
168B300SubCB300
169B308SubCB308
170B30CSubCB30C
171B310SubCB310
172B314SubCB314
173B31BSubCB31B
174B33CSubCB33C
175B345SubCB345
176B346SubCB346
177B347SubCB347
178B34CSubCB34C
179B352SubCB352
180B357SubCB357
181B359SubCB359
182F0A0SubCF0A0
183F0A4SubCF0A4
184F0A8SubCF0A8
185F0ACSubCF0AC
186F0C5SubCF0C5
187F112SubCF112
188F11ASubCF11A
189F123SubCF123
190F150SubCF150
191F180SubCF180
192F194SubCF194
193F1DESubCF1DE
194F225SubCF225
195F248SubCF248
196F2E2SubCF2E2
197F305SubCF305
198F337SubCF337
199F353SubCF353
200F3AASubCF3AA
201F3CCSubCF3CC
202F3DFSubCF3DF
203F44FSubCF44F
204F4C0SubCF4C0
205F537SubCF537
206F5CBSubCF5CB
207F5E8SubCF5E8
208F690SubCF690
209F6CBSubCF6CB
210F704SubCF704
211F77DSubCF77D
212F794SubCF794
213F7A6SubCF7A6
214F7B0SubCF7B0
215F7BFSubCF7BF
216F7C8SubCF7C8
217FFF7SubCFFF7
218# ---- derived internal branch-target names ----
2198000Reset
220800ASubC800A_OnNonnegative
2218017SubC8017_OnNonzero
222802DSubC802D_Loop
2238060SubC8060_OnNonzero
224806FSubC806F
2258079NmiHandler
2268081SubC8081_OnNonnegative
22780C1SubC80C1_OnNonzero
22880C8SubC80C8_OnZero
22980CFSubC80CF_Loop
23080DDSubC80DD
23180E4SubC80E4_Loop
2328106SubC8106_Loop
233810CSubC810C_OnNonnegative
2348126SubC8126_Loop
2358130SubC8130_Loop
2368134SubC8134_Loop
2378163SubC8163
2388331SubC8331
2398347SubC8347_Loop
240834DSubC834D
2418351SubC8351
242835BSubC835B_OnZero
243835CSubC835C
2448365SubC8365
245836CSubC836C
246837ESubC837E_Loop
247838CSubC838C
2488391SubC8391_OnCarrySet
249857BSubC857B
2508595SubC8595_Loop
25185A0SubC85A0_Loop
25287BASubC87BA
25387D8SubC87D8_Loop
25487DBSubC87DB_Loop
25587EDSubC87ED_Loop
25687F0SubC87F0_Loop
25787F1SubC87F1
2588805SubC8805_Loop
2598825SubC8825
2608839SubC8839_Loop
2618859SubC8859
262885DSubC885D_OnNonzero
263886ASubC886A_Loop
2648872SubC8872_OnNonnegative
2658887SubC8887_OnNonnegative
2668893SubC8893_OnNonnegative
267889DSubC889D_Loop
268889ESubC889E_Loop
26988A5SubC88A5_Loop
27088ADSubC88AD_OnNonnegative
27188C2SubC88C2_OnNonnegative
27288CESubC88CE_OnNonnegative
27388D8SubC88D8_Loop
27488D9SubC88D9
27588E3SubC88E3_Loop
27688E6SubC88E6_OnNonzero
27788E7SubC88E7
27888F1SubC88F1_Loop
27988F4SubC88F4_Loop
28088F5SubC88F5
28188FFSubC88FF_Loop
2828900SubC8900
283890CSubC890C_Loop
284890DSubC890D
2858919SubC8919_Loop
286891ASubC891A
287891ESubC891E_OnNonzero
288892BSubC892B_Loop
2898932SubC8932_Loop
2908941SubC8941_Loop
2918959SubC8959
2928960SubC8960
293896ESubC896E_Loop
2948979SubC8979_Loop
295898BSubC898B_OnNonzero
2968996SubC8996_Loop
2978999SubC8999_Loop
29889A7SubC89A7_Loop
29989B3SubC89B3_Loop
30089BESubC89BE_Loop
30189BFSubC89BF
30289C3SubC89C3_OnNonzero
30389D0SubC89D0_Loop
30489D5SubC89D5_OnNonnegative
30589DFSubC89DF_OnNonzero
30689EDSubC89ED_Loop
30789F4SubC89F4_Loop
30889F9SubC89F9_OnNonnegative
3098A03SubC8A03_OnNonzero
3108A5BSubC8A5B
3118A60SubC8A60_Loop
3128A6ESubC8A6E_Loop
3138A72SubC8A72
3148A80SubC8A80_Loop
3158A81SubC8A81
3168A8BSubC8A8B_Loop
3178A8CSubC8A8C
3188A9FSubC8A9F
3198D04SubC8D04
3208D12SubC8D12_OnCarryClear
3218D2DSubC8D2D_Loop
3228D38SubC8D38_Loop
3238D3ESubC8D3E
3248D47SubC8D47_Loop
3258D4DSubC8D4D_Loop
3268D4ESubC8D4E
3278D6FSubC8D6F_Loop
3288D82SubC8D82_Loop
3298D86SubC8D86_OnNonzero
3308D87SubC8D87
3318D91SubC8D91_Loop
3328DAASubC8DAA_Loop
3338DBASubC8DBA_Loop
3348DD3SubC8DD3_Loop
3358DD9SubC8DD9_Loop
3368DE5SubC8DE5
3378DF3SubC8DF3_Loop
3388DF9SubC8DF9_Loop
3398E1DSubC8E1D_Loop
3408E20SubC8E20_Loop
3418E21SubC8E21
3428E2ESubC8E2E_Loop
3438E45SubC8E45_Loop
3448E55SubC8E55
3458E62SubC8E62_Loop
3468E7FSubC8E7F_Loop
3478E8ESubC8E8E_Loop
3488E8FSubC8E8F
3498E9CSubC8E9C
3508EA8SubC8EA8_Loop
3518EB9SubC8EB9_Loop
3528EDFSubC8EDF_Loop
3538EE2SubC8EE2
3548EFASubC8EFA
3558FAASubC8FAA
3568FAESubC8FAE_OnNonnegative
3578FD1SubC8FD1_Loop
3588FDDSubC8FDD_Loop
3598FE3SubC8FE3
3608FF1SubC8FF1_Loop
3618FF4SubC8FF4_Loop
3629002SubC9002_OnNonnegative
3639031SubC9031_OnNonnegative
364903ASubC903A_Loop
3659096SubC9096
36690A8SubC90A8_OnNonzero
36790F6SubC90F6_Loop
3689101SubC9101_Loop
3699108SubC9108_Loop
370911ESubC911E
3719128SubC9128_OnNonnegative
372913BSubC913B_Loop
3739143SubC9143
374914DSubC914D_OnNonnegative
3759160SubC9160_Loop
376916ESubC916E
3779170SubC9170_OnNonnegative
3789183SubC9183_Loop
379918BSubC918B
380918DSubC918D_OnNonnegative
38191A0SubC91A0_Loop
38291A8SubC91A8
38391ACSubC91AC_OnNonnegative
38491CFSubC91CF_Loop
38591DBSubC91DB_Loop
38691E1SubC91E1
38791EFSubC91EF_Loop
38891F2SubC91F2_Loop
38991F6SubC91F6_OnNonnegative
3909206SubC9206_Loop
3919216SubC9216_Loop
3929229SubC9229
393922BSubC922B
3949235SubC9235_OnNonnegative
3959264SubC9264_Loop
396926CSubC926C_Loop
3979288SubC9288_Loop
39892AFSubC92AF_Loop
39992B7SubC92B7_Loop
40092BASubC92BA_Loop
40192C4SubC92C4_OnNonnegative
40292F3SubC92F3_Loop
40392F4SubC92F4_Loop
40492FBSubC92FB
405930ESubC930E_OnNonnegative
4069356SubC9356_Loop
407935DSubC935D_Loop
4089369SubC9369_Loop
409936ASubC936A
410937FSubC937F_Loop
4119391SubC9391_Loop
41293A7SubC93A7_Loop
41393BASubC93BA
41493D1SubC93D1_Loop
41593D9SubC93D9_Loop
41693DDSubC93DD_Loop
41793E7SubC93E7_Loop
41893E9SubC93E9_Loop
41993ECSubC93EC_OnZero
42093FDSubC93FD
4219401SubC9401_OnNonnegative
4229426SubC9426
4239434SubC9434_Loop
4249437SubC9437_Loop
425943BSubC943B_OnNonnegative
4269448SubC9448_Loop
427945BSubC945B_Loop
4289465SubC9465_OnZero
4299469SubC9469
4309471SubC9471
431947BSubC947B_OnNonnegative
43294A1SubC94A1_Loop
43394C8SubC94C8_Loop
43494D3SubC94D3_Loop
43594F3SubC94F3_Loop
43694FDSubC94FD_OnNonnegative
4379511SubC9511_OnNonzero
4389512SubC9512
4399523SubC9523_OnZero
4409526SubC9526_Loop
4419537SubC9537_Loop
4429569SubC9569_Loop
443958FSubC958F_Loop
44495ADSubC95AD_Loop
44595B3SubC95B3_Loop
44695B6SubC95B6
44795CFSubC95CF_Loop
44895DFSubC95DF_Loop
44995EDSubC95ED_Loop
45095F9SubC95F9_Loop
4519604SubC9604_Loop
4529608SubC9608
453962ASubC962A_Loop
4549631SubC9631
455964ESubC964E_Loop
456965ASubC965A
457965CSubC965C_OnNonnegative
458966FSubC966F_Loop
4599677SubC9677
4609679SubC9679_OnNonnegative
461968CSubC968C_Loop
4629694SubC9694
46396A6SubC96A6_Loop
46496A9SubC96A9_Loop
46596AASubC96AA
46696E9SubC96E9
46796F3SubC96F3_OnNonnegative
46896FASubC96FA_OnNonzero
4699700SubC9700_Loop
4709719SubC9719_Loop
4719728SubC9728_Loop
4729744SubC9744_Loop
4739753SubC9753_Loop
474976ASubC976A_Loop
4759775SubC9775_Loop
476977CSubC977C_Loop
477977DSubC977D
4789795SubC9795_OnCarryClear
4799797SubC9797_OnCarryClear
48097A1SubC97A1_Loop
48197ACSubC97AC_Loop
48297BCSubC97BC_Loop
48397D4SubC97D4
48497E0SubC97E0_OnNonzero
48597EBSubC97EB_Loop
48697EESubC97EE_Loop
48797FESubC97FE_Loop
488980FSubC980F
4899824SubC9824_Loop
4909842SubC9842_OnNonnegative
491984CSubC984C_Loop
492984DSubC984D_Loop
493985BSubC985B_Loop
4949879SubC9879_OnNonnegative
4959883SubC9883_Loop
4969884SubC9884
49798FDSubC98FD
498990FSubC990F_Loop
499991DSubC991D_Loop
5009930SubC9930_Loop
501993ESubC993E_Loop
502995ASubC995A_Loop
5039966SubC9966_Loop
504997FSubC997F_Loop
505998BSubC998B_Loop
506999DSubC999D_Loop
50799AFSubC99AF_Loop
50899BESubC99BE_Loop
50999C5SubC99C5_Loop
51099C6SubC99C6
51199D2SubC99D2_Loop
51299DBSubC99DB_Loop
51399DESubC99DE_OnCarryClear
51499F2SubC99F2_Loop
5159A00SubC9A00_Loop
5169A13SubC9A13_Loop
5179A1FSubC9A1F_Loop
5189A36SubC9A36_Loop
5199A5CSubC9A5C
5209A65SubC9A65_Loop
5219A6FSubC9A6F_Loop
5229A79SubC9A79_Loop
5239A7CSubC9A7C_Loop
5249AB3SubC9AB3_Loop
5259AC2SubC9AC2_OnNonzero
5269AEESubC9AEE_Loop
5279AF4SubC9AF4_Loop
5289AFASubC9AFA_Loop
5299B0BSubC9B0B_OnNonzero
5309B15SubC9B15_Loop
531A07ESubCA07E
532A08FSubCA08F_Loop
533A092SubCA092_Loop
534A0A4SubCA0A4_Loop
535A0A5SubCA0A5_Loop
536A0BESubCA0BE_Loop
537A0E0SubCA0E0_Loop
538A0E1SubCA0E1
539A110SubCA110_Loop
540A122SubCA122_Loop
541A12FSubCA12F_Loop
542A148SubCA148_Loop
543A149SubCA149_Loop
544A155SubCA155_Loop
545A165SubCA165
546A172SubCA172_Loop
547A18BSubCA18B_Loop
548A18ESubCA18E_Loop
549A18FSubCA18F
550A19CSubCA19C_Loop
551A1B6SubCA1B6_Loop
552A1B9SubCA1B9_Loop
553A1BASubCA1BA
554A1D1SubCA1D1_Loop
555A1D4SubCA1D4_Loop
556A1D5SubCA1D5
557A1ECSubCA1EC_Loop
558A1EFSubCA1EF_OnZero
559A1F0SubCA1F0
560A225SubCA225_Loop
561A234SubCA234_Loop
562A247SubCA247_Loop
563A252SubCA252
564A287SubCA287_Loop
565A296SubCA296_Loop
566A2A9SubCA2A9_Loop
567A2B3SubCA2B3_Loop
568A2B4SubCA2B4
569A2CESubCA2CE_Loop
570A2D9SubCA2D9
571A2FFSubCA2FF
572A30BSubCA30B_Loop
573A318SubCA318
574A340SubCA340_Loop
575A34ESubCA34E_Loop
576A367SubCA367_Loop
577A371SubCA371_Loop
578A372SubCA372_OnNonnegative
579A379SubCA379_Loop
580A37FSubCA37F
581A398SubCA398_Loop
582A3A2SubCA3A2_Loop
583A3ACSubCA3AC_Loop
584A3BCSubCA3BC_Loop
585A3C7SubCA3C7_Loop
586A3D2SubCA3D2_Loop
587A3DFSubCA3DF_Loop
588A3EASubCA3EA_Loop
589A3EDSubCA3ED_Loop
590A401SubCA401_OnNonnegative
591A409SubCA409_Loop
592A40FSubCA40F
593A424SubCA424_Loop
594A439SubCA439_Loop
595A43FSubCA43F_Loop
596A443SubCA443
597A45FSubCA45F_Loop
598A46ASubCA46A_Loop
599A47ESubCA47E
600A487SubCA487_Loop
601A488SubCA488
602A48ASubCA48A_OnNonzero
603A49DSubCA49D_Loop
604A4A5SubCA4A5
605A4A7SubCA4A7_OnNonzero
606A4BASubCA4BA_Loop
607A4C2SubCA4C2
608A4CDSubCA4CD
609A4D7SubCA4D7_OnNonzero
610A52ESubCA52E_OnZero
611A52FSubCA52F
612A53DSubCA53D_OnNonnegative
613A581SubCA581
614A596SubCA596_OnCarryClear
615A5A2SubCA5A2_Loop
616A5AESubCA5AE_Loop
617A5B2SubCA5B2_Loop
618A5B5SubCA5B5_Loop
619A5DBSubCA5DB_Loop
620A5E0SubCA5E0_Loop
621A5EDSubCA5ED_Loop
622A5F2SubCA5F2_Loop
623A5FCSubCA5FC_Loop
624A679SubCA679
625A686SubCA686_OnNonzero
626A68ESubCA68E_Loop
627A697SubCA697_Loop
628A69ASubCA69A_Loop
629A6B2SubCA6B2_Loop
630A6BCSubCA6BC_Loop
631A764SubCA764
632A78CSubCA78C_Loop
633A78ESubCA78E_Loop
634A792SubCA792_Loop
635A793SubCA793
636A7BBSubCA7BB_Loop
637A7C9SubCA7C9_Loop
638A7CASubCA7CA_OnNonnegative
639A7D1SubCA7D1_Loop
640A7D7SubCA7D7
641A805SubCA805_Loop
642A807SubCA807_Loop
643A825SubCA825_Loop
644A834SubCA834_Loop
645A83ESubCA83E_Loop
646A84ESubCA84E_Loop
647A867SubCA867_Loop
648A86ESubCA86E_Loop
649A887SubCA887_Loop
650A88ESubCA88E_Loop
651A89BSubCA89B_Loop
652A8A9SubCA8A9_Loop
653A8ACSubCA8AC_Loop
654A8C5SubCA8C5_OnNonnegative
655A8CDSubCA8CD_Loop
656A8D3SubCA8D3
657A8DBSubCA8DB_Loop
658A8DCSubCA8DC
659A8FESubCA8FE_Loop
660A904SubCA904_Loop
661A908SubCA908
662A92FSubCA92F_Loop
663A93ASubCA93A_Loop
664A940SubCA940
665A94BSubCA94B_Loop
666A955SubCA955_Loop
667A958SubCA958_Loop
668A960SubCA960_Loop
669A96FSubCA96F_Loop
670A98FSubCA98F_Loop
671A9AASubCA9AA_Loop
672A9B7SubCA9B7_Loop
673A9C8SubCA9C8_Loop
674A9CBSubCA9CB_Loop
675A9CCSubCA9CC
676A9E4SubCA9E4_Loop
677A9FBSubCA9FB_Loop
678A9FCSubCA9FC_Loop
679AA21SubCAA21_Loop
680AA22SubCAA22
681AA2FSubCAA2F_Loop
682AA4ASubCAA4A_Loop
683AA4DSubCAA4D_Loop
684AA4ESubCAA4E
685AA5BSubCAA5B_Loop
686AA77SubCAA77_Loop
687AA7ASubCAA7A_Loop
688AA7BSubCAA7B
689AA91SubCAA91_Loop
690AA94SubCAA94_Loop
691AA95SubCAA95
692AAC0SubCAAC0_Loop
693AAC1SubCAAC1
694AAD7SubCAAD7_Loop
695AADASubCAADA_OnZero
696AADBSubCAADB
697AB01SubCAB01_Loop
698AB22SubCAB22_Loop
699AB35SubCAB35_OnNonnegative
700AB3BSubCAB3B_Loop
701AB63SubCAB63_Loop
702AB6BSubCAB6B_OnNonzero
703AB6FSubCAB6F
704AB81SubCAB81_Loop
705AB97SubCAB97_Loop
706AB9ASubCAB9A_Loop
707AB9DSubCAB9D_Loop
708ABA0SubCABA0
709ABC6SubCABC6_Loop
710ABE8SubCABE8_Loop
711ABF7SubCABF7_Loop
712AC1ASubCAC1A_Loop
713AC22SubCAC22_Loop
714AC23SubCAC23
715AC36SubCAC36_Loop
716AC3CSubCAC3C_Loop
717AC3FSubCAC3F
718AC5ESubCAC5E_Loop
719AC71SubCAC71_OnCarrySet
720AC76SubCAC76_OnNonzero
721AC77SubCAC77
722AC96SubCAC96_Loop
723ACB0SubCACB0
724ACBDSubCACBD_Loop
725ACC1SubCACC1
726ACCASubCACCA_Loop
727ACEBSubCACEB
728ACF7SubCACF7_Loop
729ACFCSubCACFC
730AD30SubCAD30_Loop
731AD49SubCAD49_Loop
732AD54SubCAD54
733AD63SubCAD63_Loop
734ADFFSubCADFF
735AE01SubCAE01
736AE5FSubCAE5F_Loop
737AE7ASubCAE7A_Loop
738AE86SubCAE86_Loop
739AE87SubCAE87
740AE9BSubCAE9B_OnNonnegative
741AEA7SubCAEA7_Loop
742AF14SubCAF14
743AF18SubCAF18_OnNonzero
744AF22SubCAF22
745AF49SubCAF49_Loop
746AF4ASubCAF4A
747AF4CSubCAF4C_OnZero
748AF58SubCAF58_OnNonzero
749AF77SubCAF77_Loop
750AF94SubCAF94
751AFB0SubCAFB0_OnNonzero
752AFBFSubCAFBF_OnNonzero
753AFC9SubCAFC9_Loop
754AFD7SubCAFD7_Loop
755AFD8SubCAFD8
756AFDFSubCAFDF
757AFF4SubCAFF4_OnNonzero
758B00ASubCB00A_OnNonzero
759B023SubCB023_OnNonzero
760B02ASubCB02A
761B036SubCB036_OnNonnegative
762B03CSubCB03C_Loop
763B046SubCB046_Loop
764B04BSubCB04B
765B069SubCB069
766B076SubCB076_Loop
767B082SubCB082_Loop
768B08BSubCB08B_Loop
769B095SubCB095
770B09FSubCB09F_Loop
771B0A7SubCB0A7_Loop
772B0AESubCB0AE_OnNonzero
773B0C4SubCB0C4_Loop
774B0D0SubCB0D0_Loop
775B0D3SubCB0D3_OnNonzero
776B0D6SubCB0D6_Loop
777B0EASubCB0EA
778B0F4SubCB0F4
779B104SubCB104
780B11BSubCB11B_OnNonzero
781B132SubCB132_OnNonzero
782B15CSubCB15C
783B16CSubCB16C_Loop
784B16DSubCB16D
785B17CSubCB17C
786B187SubCB187_Loop
787B194SubCB194_OnCarrySet
788B198SubCB198_Loop
789B19DSubCB19D
790B1B0SubCB1B0_Loop
791B1BCSubCB1BC_Loop
792B1BFSubCB1BF
793B1DASubCB1DA
794B1F8SubCB1F8
795B203SubCB203_OnZero
796B20ASubCB20A
797B220SubCB220
798B230SubCB230
799B239SubCB239
800B244SubCB244
801B24CSubCB24C_OnNonzero
802B24ESubCB24E_OnNonzero
803B28BSubCB28B
804B29BSubCB29B
805B29FSubCB29F
806B2A3SubCB2A3
807B2A7SubCB2A7
808B2ABSubCB2AB
809B2AFSubCB2AF
810B2B3SubCB2B3
811B2B7SubCB2B7
812B2B9SubCB2B9_Loop
813B2C2SubCB2C2
814B2C8SubCB2C8_Loop
815B2CFSubCB2CF_Loop
816B2D5SubCB2D5
817B2DDSubCB2DD
818B2E5SubCB2E5
819B2E9SubCB2E9
820B2F1SubCB2F1
821B2F3SubCB2F3_Loop
822B2FCSubCB2FC
823B300SubCB300
824B308SubCB308
825B30CSubCB30C
826B310SubCB310
827B314SubCB314
828B316SubCB316_Loop
829B31BSubCB31B
830B32FSubCB32F_Loop
831B336SubCB336_Loop
832B33CSubCB33C
833B345SubCB345
834B346SubCB346
835B347SubCB347
836B34CSubCB34C
837B352SubCB352
838B357SubCB357
839B359SubCB359
840F0A0SubCF0A0
841F0A4SubCF0A4
842F0A8SubCF0A8
843F0ACSubCF0AC
844F0AESubCF0AE_Loop
845F0BASubCF0BA_OnNonzero
846F0C5SubCF0C5
847F0D2SubCF0D2_OnNonzero
848F112SubCF112
849F11ASubCF11A
850F11FSubCF11F_OnZero
851F122SubCF122_OnZero
852F123SubCF123
853F12ASubCF12A_OnZero
854F12DSubCF12D_OnNonzero
855F13ASubCF13A_Loop
856F150SubCF150
857F166SubCF166_Loop
858F172SubCF172_Loop
859F17DSubCF17D_Loop
860F180SubCF180
861F194SubCF194
862F19ASubCF19A_Loop
863F1BFSubCF1BF_Loop
864F1D0SubCF1D0_Loop
865F1D2SubCF1D2_Loop
866F1DESubCF1DE
867F1E5SubCF1E5_Loop
868F1EDSubCF1ED_Loop
869F1F6SubCF1F6_Loop
870F201SubCF201_Loop
871F209SubCF209_Loop
872F222SubCF222_Loop
873F225SubCF225
874F23ASubCF23A_OnZero
875F23BSubCF23B_OnZero
876F248SubCF248
877F26BSubCF26B_Loop
878F284SubCF284_Loop
879F289SubCF289_Loop
880F29CSubCF29C_Loop
881F2A1SubCF2A1_Loop
882F2A6SubCF2A6_Loop
883F2A9SubCF2A9_Loop
884F2B0SubCF2B0_OnZero
885F2C9SubCF2C9_OnCarrySet
886F2DCSubCF2DC_OnCarrySet
887F2E2SubCF2E2
888F305SubCF305
889F30FSubCF30F_OnZero
890F310SubCF310_Loop
891F32BSubCF32B_Loop
892F337SubCF337
893F34FSubCF34F_Loop
894F353SubCF353
895F38CSubCF38C_OnCarrySet
896F39DSubCF39D_OnCarrySet
897F3AASubCF3AA
898F3BESubCF3BE_Loop
899F3CCSubCF3CC
900F3D4SubCF3D4_OnNonzero
901F3D5SubCF3D5_Loop
902F3DFSubCF3DF
903F43BSubCF43B_OnNonzero
904F44FSubCF44F
905F457SubCF457_OnCarrySet
906F45FSubCF45F_OnCarrySet
907F467SubCF467_OnCarrySet
908F46FSubCF46F_OnCarrySet
909F490SubCF490_OnCarrySet
910F4AASubCF4AA_Loop
911F4BDSubCF4BD_OnCarrySet
912F4C0SubCF4C0
913F4F9SubCF4F9_OnNonzero
914F4FASubCF4FA_Loop
915F50BSubCF50B_Loop
916F518SubCF518_Loop
917F533SubCF533_Loop
918F537SubCF537
919F555SubCF555_Loop
920F561SubCF561_OnZero
921F564SubCF564_Loop
922F575SubCF575_Loop
923F598SubCF598_OnCarrySet
924F5A2SubCF5A2_OnCarrySet
925F5BESubCF5BE_OnCarrySet
926F5CBSubCF5CB
927F5E7SubCF5E7_OnNonzero
928F5E8SubCF5E8
929F5FBSubCF5FB_Loop
930F61ASubCF61A_Loop
931F63BSubCF63B_Loop
932F660SubCF660_OnNonzero
933F674SubCF674_OnNonzero
934F690SubCF690
935F6B2SubCF6B2_Loop
936F6CBSubCF6CB
937F6D9SubCF6D9_OnCarrySet
938F6E0SubCF6E0_OnZero
939F6E7SubCF6E7_OnCarrySet
940F6F1SubCF6F1_OnCarrySet
941F6F8SubCF6F8_OnCarrySet
942F704SubCF704
943F747SubCF747_Loop
944F74ASubCF74A_Loop
945F751SubCF751_Loop
946F758SubCF758_Loop
947F75FSubCF75F_Loop
948F76BSubCF76B_Loop
949F771SubCF771_Loop
950F77DSubCF77D
951F784SubCF784_OnZero
952F794SubCF794
953F79DSubCF79D_Loop
954F7A6SubCF7A6
955F7ADSubCF7AD_OnNonzero
956F7B0SubCF7B0
957F7B7SubCF7B7_OnNonzero
958F7BFSubCF7BF
959F7C8SubCF7C8
960FFF7SubCFFF7