Files
disasm/NROM/CIRCUS/routinemap.tsv
T
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

19 KiB

1C000Reset
2C057SubCC057
3C05ANmiHandler
4C0B8SubCC0B8
5C0C3SubCC0C3
6C0C5SubCC0C5
7C0CBSubCC0CB
8C0D0SubCC0D0
9C0E4SubCC0E4
10C0F9SubCC0F9
11C108SubCC108
12C1B7SubCC1B7
13C1D5SubCC1D5
14C1EASubCC1EA
15C250SubCC250
16C252SubCC252
17C25DSubCC25D
18C2A5SubCC2A5
19C2A7SubCC2A7
20C2ABSubCC2AB
21C303SubCC303
22C342SubCC342
23C3AASubCC3AA
24C3B8SubCC3B8
25C3BESubCC3BE
26C3C1SubCC3C1
27C3D6SubCC3D6
28C3E0SubCC3E0
29C3F5SubCC3F5
30C402SubCC402
31C444SubCC444
32C458SubCC458
33C45DSubCC45D
34C4AASubCC4AA
35C4BASubCC4BA
36C4C8SubCC4C8
37C4CDSubCC4CD
38C4E3SubCC4E3
39C505SubCC505
40C53FSubCC53F
41C556SubCC556
42C564SubCC564
43C58FSubCC58F
44C5B2SubCC5B2
45C5C3SubCC5C3
46C5CBSubCC5CB
47C5F7SubCC5F7
48C606SubCC606
49C61DSubCC61D
50C62DSubCC62D
51C637SubCC637
52C63ASubCC63A
53C643SubCC643
54C64BSubCC64B
55C662SubCC662
56C67BSubCC67B
57C6ADSubCC6AD
58C6C4SubCC6C4
59C6F3SubCC6F3
60C6F7SubCC6F7
61C753SubCC753
62C81ASubCC81A
63C822SubCC822
64C835SubCC835
65C889SubCC889
66C8FCSubCC8FC
67C906SubCC906
68C991SubCC991
69C9CESubCC9CE
70C9DDSubCC9DD
71C9ECSubCC9EC
72C9F2SubCC9F2
73CA04SubCCA04
74CA11SubCCA11
75CA25SubCCA25
76CA31SubCCA31
77CA3BSubCCA3B
78CA4BSubCCA4B
79CA4FSubCCA4F
80CA55SubCCA55
81CA5CSubCCA5C
82CAB1SubCCAB1
83CB2DSubCCB2D
84CB51SubCCB51
85CB55SubCCB55
86CBDASubCCBDA
87CBE4SubCCBE4
88CC16SubCCC16
89CC20SubCCC20
90CC50SubCCC50
91CC5BSubCCC5B
92CC62SubCCC62
93CC7ESubCCC7E
94CC87SubCCC87
95CC8FSubCCC8F
96CC94SubCCC94
97CCB6SubCCCB6
98CCD0SubCCCD0
99CCD3SubCCCD3
100CCD9SubCCCD9
101CD28SubCCD28
102CD2DSubCCD2D
103CD32SubCCD32
104CD61SubCCD61
105CD68SubCCD68
106CDC7SubCCDC7
107CDE8SubCCDE8
108CE6DSubCCE6D
109CE8ESubCCE8E
110CE9ESubCCE9E
111CEABSubCCEAB
112CEB7SubCCEB7
113CEE3SubCCEE3
114CEE5SubCCEE5
115CEF2SubCCEF2
116CF0DSubCCF0D
117CF49SubCCF49
118CF58SubCCF58
119CF9DSubCCF9D
120CFB3SubCCFB3
121CFCESubCCFCE
122CFDESubCCFDE
123D001SubCD001
124D009SubCD009
125D0ADSubCD0AD
126D0DASubCD0DA
127D10CSubCD10C
128D124SubCD124
129D142SubCD142
130D1C4SubCD1C4
131D1E4SubCD1E4
132D1E8SubCD1E8
133D280SubCD280
134D282SubCD282
135D2FDSubCD2FD
136D31ESubCD31E
137D342SubCD342
138D389SubCD389
139D3F3SubCD3F3
140D48ESubCD48E
141D4CESubCD4CE
142D4E4SubCD4E4
143D544SubCD544
144D54ESubCD54E
145D575SubCD575
146D597SubCD597
147D5DFSubCD5DF
148D621SubCD621
149D657SubCD657
150D665SubCD665
151D714SubCD714
152D76DSubCD76D
153D807SubCD807
154D814SubCD814
155D8E4SubCD8E4
156D9ABSubCD9AB
157D9F3SubCD9F3
158D9F7SubCD9F7
159D9FBSubCD9FB
160DA05SubCDA05
161DA11SubCDA11
162DADASubCDADA
163DAFDSubCDAFD
164DB01SubCDB01
165DB31SubCDB31
166DB87SubCDB87
167DB97SubCDB97
168DBB6SubCDBB6
169DBD1SubCDBD1
170DC58SubCDC58
171DC95SubCDC95
172DCABSubCDCAB
173DCDCSubCDCDC
174E484SubCE484
175E4E0SubCE4E0
176E509SubCE509
177E521SubCE521
178E52DSubCE52D
179E562SubCE562
180E59ASubCE59A
181E5B0SubCE5B0
182E61DSubCE61D
183E6B0SubCE6B0
184E6C9SubCE6C9
185E79FSubCE79F
186E7BASubCE7BA
187E7EBSubCE7EB
188E82CSubCE82C
189E838SubCE838
190E842SubCE842
191E845SubCE845
192E903SubCE903
193E91FSubCE91F
194E92ESubCE92E
195E95CSubCE95C
196E969SubCE969
197E97ESubCE97E
198E9BCSubCE9BC
199EAC4SubCEAC4
200EB98SubCEB98
201EC94SubCEC94
202EC9CSubCEC9C
203ED21SubCED21
204ED26SubCED26
205ED42SubCED42
206ED51SubCED51
207ED66SubCED66
208EDB3SubCEDB3
209EDC0SubCEDC0
210EDE7SubCEDE7
211EDF3SubCEDF3
212EDFESubCEDFE
213EE0ASubCEE0A
214EE28SubCEE28
215EEC2SubCEEC2
216EED0SubCEED0
217EED9SubCEED9
218EF53SubCEF53
219EF74SubCEF74
220F06ESubCF06E
221F078SubCF078
222F188SubCF188
223F1CFSubCF1CF
224F23FSubCF23F
225F2DBSubCF2DB
226F342SubCF342
227F36DSubCF36D
228F39ASubCF39A
229F3B0SubCF3B0
230F3C3SubCF3C3
231F3D4SubCF3D4
232F408SubCF408
233F42ESubCF42E
234F432SubCF432
235F479SubCF479
236F51DSubCF51D
237F540SubCF540
238F571SubCF571
239F5C6SubCF5C6
240F601SubCF601
241F612SubCF612
242F649SubCF649
243F666SubCF666
244F6CDSubCF6CD
245F758SubCF758
246F7DASubCF7DA
247F7DFSubCF7DF
248F7E4SubCF7E4
249F7E9SubCF7E9
250F7EESubCF7EE
251F7FCSubCF7FC
252F80DSubCF80D
253F87CSubCF87C
254F8C8SubCF8C8
255F8E1SubCF8E1
256F975SubCF975
257F9C9SubCF9C9
258FA73SubCFA73
259FAA9SubCFAA9
260# ---- derived internal branch-target names ----
261C000Reset
262C002SubCC002_OnNonnegative
263C007SubCC007_OnNonnegative
264C014SubCC014_OnNonzero
265C01FSubCC01F_Loop
266C023SubCC023_OnNonzero
267C02DSubCC02D_Loop
268C037SubCC037_OnNonzero
269C046SubCC046_Loop
270C04DSubCC04D_OnNonzero
271C057SubCC057
272C05ANmiHandler
273C082SubCC082_Loop
274C084SubCC084_Loop
275C089SubCC089_Loop
276C0A5SubCC0A5_Loop
277C0B2SubCC0B2_Loop
278C0B8SubCC0B8
279C0C3SubCC0C3
280C0C5SubCC0C5
281C0CBSubCC0CB
282C0D0SubCC0D0
283C0E4SubCC0E4
284C0F9SubCC0F9
285C107SubCC107_Loop
286C108SubCC108
287C117SubCC117_Loop
288C12BSubCC12B_Loop
289C138SubCC138_Loop
290C14ESubCC14E_OnNonzero
291C160SubCC160_Loop
292C168SubCC168_Loop
293C179SubCC179_Loop
294C181SubCC181_Loop
295C1A5SubCC1A5_OnCarryClear
296C1A6SubCC1A6_Loop
297C1B7SubCC1B7
298C1C8SubCC1C8_Loop
299C1CBSubCC1CB_OnNonzero
300C1D5SubCC1D5
301C1EASubCC1EA
302C1F9SubCC1F9_Loop
303C20CSubCC20C_OnZero
304C250SubCC250
305C252SubCC252
306C254SubCC254_OnNonzero
307C257SubCC257_OnZero
308C25DSubCC25D
309C26ESubCC26E_Loop
310C271SubCC271_Loop
311C28FSubCC28F_Loop
312C2A5SubCC2A5
313C2A7SubCC2A7
314C2ABSubCC2AB
315C2B1SubCC2B1_OnNonzero
316C2B2SubCC2B2_Loop
317C2D2SubCC2D2_Loop
318C2EBSubCC2EB_Loop
319C303SubCC303
320C31BSubCC31B_Loop
321C326SubCC326_OnNonzero
322C32DSubCC32D_OnNonzero
323C340SubCC340_Loop
324C342SubCC342
325C34BSubCC34B_Loop
326C399SubCC399_Loop
327C39ASubCC39A_Loop
328C3AASubCC3AA
329C3B8SubCC3B8
330C3BESubCC3BE
331C3C1SubCC3C1
332C3D6SubCC3D6
333C3E0SubCC3E0
334C3E2SubCC3E2_Loop
335C3ECSubCC3EC_OnNonzero
336C3F5SubCC3F5
337C3FASubCC3FA_OnNonzero
338C402SubCC402
339C40DSubCC40D_OnNonzero
340C444SubCC444
341C44ESubCC44E_Loop
342C452SubCC452_Loop
343C454SubCC454_Loop
344C458SubCC458
345C45DSubCC45D
346C480SubCC480_Loop
347C488SubCC488_Loop
348C489SubCC489_Loop
349C4AASubCC4AA
350C4AFSubCC4AF_OnNonzero
351C4BASubCC4BA
352C4C8SubCC4C8
353C4CDSubCC4CD
354C4E3SubCC4E3
355C4EASubCC4EA_Loop
356C505SubCC505
357C509SubCC509_OnZero
358C516SubCC516_OnZero
359C527SubCC527_Loop
360C52FSubCC52F_Loop
361C530SubCC530_Loop
362C537SubCC537_OnNonzero
363C53FSubCC53F
364C548SubCC548_Loop
365C556SubCC556
366C55ASubCC55A_OnNonzero
367C564SubCC564
368C56FSubCC56F_Loop
369C571SubCC571_OnNonzero
370C578SubCC578_OnNonzero
371C584SubCC584_Loop
372C586SubCC586_OnNonzero
373C58FSubCC58F
374C591SubCC591_OnNonnegative
375C5B2SubCC5B2
376C5B6SubCC5B6_OnNonnegative
377C5C3SubCC5C3
378C5CBSubCC5CB
379C5E0SubCC5E0_Loop
380C5ECSubCC5EC_Loop
381C5F7SubCC5F7
382C606SubCC606
383C613SubCC613_Loop
384C61DSubCC61D
385C622SubCC622_OnNonzero
386C62DSubCC62D
387C637SubCC637
388C63ASubCC63A
389C643SubCC643
390C64ASubCC64A_OnCarrySet
391C64BSubCC64B
392C662SubCC662
393C670SubCC670_Loop
394C677SubCC677_Loop
395C67BSubCC67B
396C68DSubCC68D_OnNonnegative
397C693SubCC693_Loop
398C6A8SubCC6A8_Loop
399C6ADSubCC6AD
400C6C3SubCC6C3_Loop
401C6C4SubCC6C4
402C6D3SubCC6D3_Loop
403C6DCSubCC6DC_OnNonzero
404C6EDSubCC6ED_OnNonnegative
405C6F2SubCC6F2_Loop
406C6F3SubCC6F3
407C6F7SubCC6F7
408C70DSubCC70D_Loop
409C71DSubCC71D_Loop
410C720SubCC720_Loop
411C721SubCC721_Loop
412C731SubCC731_Loop
413C73ASubCC73A_Loop
414C73CSubCC73C_OnNonnegative
415C748SubCC748_Loop
416C74ASubCC74A_OnNonnegative
417C752SubCC752_Loop
418C753SubCC753
419C81ASubCC81A
420C822SubCC822
421C830SubCC830_Loop
422C835SubCC835
423C845SubCC845_Loop
424C85FSubCC85F_OnNonzero
425C861SubCC861_OnNonzero
426C87CSubCC87C_OnNonzero
427C889SubCC889
428C897SubCC897_Loop
429C8B3SubCC8B3_Loop
430C8B5SubCC8B5_Loop
431C8C1SubCC8C1_Loop
432C8D3SubCC8D3_Loop
433C8D7SubCC8D7_Loop
434C8D9SubCC8D9_Loop
435C8E2SubCC8E2_Loop
436C8FCSubCC8FC
437C900SubCC900_OnNonnegative
438C906SubCC906
439C925SubCC925_Loop
440C991SubCC991
441C9A0SubCC9A0_Loop
442C9BDSubCC9BD_Loop
443C9C6SubCC9C6_Loop
444C9CESubCC9CE
445C9DDSubCC9DD
446C9ECSubCC9EC
447C9F2SubCC9F2
448CA04SubCCA04
449CA11SubCCA11
450CA25SubCCA25
451CA29SubCCA29_OnZero
452CA2FSubCCA2F_OnNonzero
453CA31SubCCA31
454CA3BSubCCA3B
455CA3DSubCCA3D_OnNonnegative
456CA4BSubCCA4B
457CA4FSubCCA4F
458CA55SubCCA55
459CA5CSubCCA5C
460CA63SubCCA63_OnNonzero
461CA80SubCCA80_OnNonzero
462CA8DSubCCA8D_Loop
463CA8FSubCCA8F_OnNonzero
464CAB0SubCCAB0_Loop
465CAB1SubCCAB1
466CAC1SubCCAC1_Loop
467CAC3SubCCAC3_Loop
468CAD3SubCCAD3_OnNonzero
469CAD5SubCCAD5_OnNonzero
470CAE3SubCCAE3_OnNonzero
471CB08SubCCB08_OnNonzero
472CB0ASubCCB0A_Loop
473CB1CSubCCB1C_Loop
474CB24SubCCB24_Loop
475CB2DSubCCB2D
476CB40SubCCB40_OnNonzero
477CB4BSubCCB4B_Loop
478CB51SubCCB51
479CB55SubCCB55
480CB57SubCCB57_Loop
481CB75SubCCB75_Loop
482CB78SubCCB78_Loop
483CB7BSubCCB7B_Loop
484CB85SubCCB85_Loop
485CB88SubCCB88_Loop
486CBDASubCCBDA
487CBE4SubCCBE4
488CC16SubCCC16
489CC20SubCCC20
490CC3BSubCCC3B_Loop
491CC40SubCCC40_Loop
492CC4BSubCCC4B_Loop
493CC50SubCCC50
494CC5BSubCCC5B
495CC62SubCCC62
496CC7ESubCCC7E
497CC87SubCCC87
498CC8CSubCCC8C_Loop
499CC8FSubCCC8F
500CC94SubCCC94
501CCB2SubCCCB2_Loop
502CCB4SubCCCB4_Loop
503CCB6SubCCCB6
504CCD0SubCCCD0
505CCD3SubCCCD3
506CCD9SubCCCD9
507CD28SubCCD28
508CD2DSubCCD2D
509CD32SubCCD32
510CD4DSubCCD4D_Loop
511CD51SubCCD51_Loop
512CD53SubCCD53_Loop
513CD61SubCCD61
514CD67SubCCD67_OnNonzero
515CD68SubCCD68
516CD80SubCCD80_Loop
517CD8FSubCCD8F_Loop
518CD97SubCCD97_OnCarryClear
519CDA0SubCCDA0_Loop
520CDB3SubCCDB3_Loop
521CDB7SubCCDB7_Loop
522CDC2SubCCDC2_Loop
523CDC4SubCCDC4_Loop
524CDC7SubCCDC7
525CDDDSubCCDDD_Loop
526CDE7SubCCDE7_OnCarryClear
527CDE8SubCCDE8
528CE0ESubCCE0E_Loop
529CE26SubCCE26_Loop
530CE30SubCCE30_Loop
531CE43SubCCE43_Loop
532CE54SubCCE54_Loop
533CE6DSubCCE6D
534CE84SubCCE84_Loop
535CE8DSubCCE8D_Loop
536CE8ESubCCE8E
537CE9ESubCCE9E
538CEABSubCCEAB
539CEB7SubCCEB7
540CEE3SubCCEE3
541CEE5SubCCEE5
542CEF2SubCCEF2
543CEFASubCCEFA_Loop
544CF03SubCCF03_Loop
545CF0DSubCCF0D
546CF30SubCCF30_OnNonzero
547CF3BSubCCF3B_Loop
548CF49SubCCF49
549CF55SubCCF55_Loop
550CF58SubCCF58
551CF86SubCCF86_Loop
552CF88SubCCF88_Loop
553CF9DSubCCF9D
554CF9FSubCCF9F_OnZero
555CFB3SubCCFB3
556CFCESubCCFCE
557CFD0SubCCFD0_OnNonnegative
558CFDESubCCFDE
559CFE4SubCCFE4_OnNonzero
560CFE9SubCCFE9_OnNonzero
561D000SubCD000_OnZero
562D001SubCD001
563D009SubCD009
564D05FSubCD05F_Loop
565D078SubCD078_Loop
566D090SubCD090_Loop
567D096SubCD096_Loop
568D099SubCD099_Loop
569D0ACSubCD0AC_Loop
570D0ADSubCD0AD
571D0B3SubCD0B3_OnNonzero
572D0CDSubCD0CD_Loop
573D0D7SubCD0D7_Loop
574D0DASubCD0DA
575D0E5SubCD0E5_Loop
576D0EASubCD0EA_Loop
577D102SubCD102_Loop
578D10CSubCD10C
579D115SubCD115_Loop
580D117SubCD117_Loop
581D120SubCD120_Loop
582D124SubCD124
583D128SubCD128_OnNonzero
584D139SubCD139_Loop
585D141SubCD141_Loop
586D142SubCD142
587D153SubCD153_Loop
588D1C4SubCD1C4
589D1DCSubCD1DC_OnZero
590D1E4SubCD1E4
591D1E8SubCD1E8
592D206SubCD206_OnNonzero
593D21DSubCD21D_Loop
594D243SubCD243_Loop
595D255SubCD255_Loop
596D270SubCD270_OnNonzero
597D280SubCD280
598D282SubCD282
599D291SubCD291_Loop
600D295SubCD295_Loop
601D2B6SubCD2B6_OnNonzero
602D2C2SubCD2C2_OnNonzero
603D2C9SubCD2C9_Loop
604D2CDSubCD2CD_Loop
605D2FDSubCD2FD
606D31ESubCD31E
607D342SubCD342
608D35FSubCD35F_OnNonzero
609D365SubCD365_Loop
610D375SubCD375_Loop
611D388SubCD388_OnZero
612D389SubCD389
613D38BSubCD38B_OnNonzero
614D398SubCD398_OnZero
615D39BSubCD39B_Loop
616D3A2SubCD3A2_OnNonzero
617D3F3SubCD3F3
618D40ASubCD40A_Loop
619D41FSubCD41F_Loop
620D426SubCD426_OnNonnegative
621D42BSubCD42B_Loop
622D436SubCD436_Loop
623D439SubCD439_Loop
624D449SubCD449_OnNonnegative
625D453SubCD453_Loop
626D45DSubCD45D_Loop
627D464SubCD464_OnNonnegative
628D46ESubCD46E_Loop
629D47DSubCD47D_Loop
630D481SubCD481_Loop
631D486SubCD486_Loop
632D48DSubCD48D_Loop
633D48ESubCD48E
634D48FSubCD48F_Loop
635D490SubCD490_Loop
636D491SubCD491_Loop
637D4BBSubCD4BB_Loop
638D4C4SubCD4C4_Loop
639D4CESubCD4CE
640D4DFSubCD4DF_Loop
641D4E4SubCD4E4
642D4F3SubCD4F3_Loop
643D4F4SubCD4F4_Loop
644D505SubCD505_Loop
645D50DSubCD50D_Loop
646D525SubCD525_Loop
647D53CSubCD53C_OnNonzero
648D544SubCD544
649D54ESubCD54E
650D550SubCD550_OnNonzero
651D55FSubCD55F_Loop
652D575SubCD575
653D58CSubCD58C_OnNonnegative
654D597SubCD597
655D5AASubCD5AA_Loop
656D5C7SubCD5C7_OnNonzero
657D5D4SubCD5D4_OnNonzero
658D5DFSubCD5DF
659D5F1SubCD5F1_Loop
660D5F2SubCD5F2_Loop
661D5FCSubCD5FC_Loop
662D5FESubCD5FE_Loop
663D616SubCD616_OnNonzero
664D621SubCD621
665D624SubCD624_Loop
666D627SubCD627_Loop
667D62BSubCD62B_OnNonzero
668D657SubCD657
669D665SubCD665
670D714SubCD714
671D76DSubCD76D
672D777SubCD777_Loop
673D78FSubCD78F_Loop
674D7A0SubCD7A0_Loop
675D7B4SubCD7B4_Loop
676D7C1SubCD7C1_Loop
677D807SubCD807
678D814SubCD814
679D820SubCD820_Loop
680D82ESubCD82E_Loop
681D839SubCD839_OnNegative
682D83FSubCD83F_Loop
683D84ASubCD84A_Loop
684D858SubCD858_Loop
685D860SubCD860_Loop
686D86ASubCD86A_Loop
687D86FSubCD86F_Loop
688D87FSubCD87F_Loop
689D885SubCD885_Loop
690D889SubCD889_Loop
691D8DDSubCD8DD_OnCarrySet
692D8E4SubCD8E4
693D8F2SubCD8F2_Loop
694D8FFSubCD8FF_Loop
695D908SubCD908_Loop
696D912SubCD912_Loop
697D91ASubCD91A_Loop
698D920SubCD920_Loop
699D924SubCD924_Loop
700D935SubCD935_Loop
701D93DSubCD93D_Loop
702D943SubCD943_Loop
703D945SubCD945_Loop
704D94ESubCD94E_Loop
705D9ABSubCD9AB
706D9B8SubCD9B8_Loop
707D9F3SubCD9F3
708D9F7SubCD9F7
709D9FBSubCD9FB
710D9FDSubCD9FD_Loop
711DA05SubCDA05
712DA0FSubCDA0F_Loop
713DA10SubCDA10_Loop
714DA11SubCDA11
715DA19SubCDA19_Loop
716DA20SubCDA20_Loop
717DA2DSubCDA2D_Loop
718DA3ESubCDA3E_Loop
719DA60SubCDA60_Loop
720DA71SubCDA71_Loop
721DA76SubCDA76_Loop
722DA9CSubCDA9C_Loop
723DAAESubCDAAE_Loop
724DAB3SubCDAB3_Loop
725DAD2SubCDAD2_Loop
726DADASubCDADA
727DADFSubCDADF_Loop
728DAE4SubCDAE4_Loop
729DAF7SubCDAF7_Loop
730DAFDSubCDAFD
731DAFFSubCDAFF_Loop
732DB01SubCDB01
733DB13SubCDB13_Loop
734DB31SubCDB31
735DB36SubCDB36_Loop
736DB56SubCDB56_Loop
737DB5BSubCDB5B_Loop
738DB74SubCDB74_Loop
739DB7ESubCDB7E_Loop
740DB80SubCDB80_Loop
741DB82SubCDB82_Loop
742DB87SubCDB87
743DB97SubCDB97
744DBB6SubCDBB6
745DBCESubCDBCE_Loop
746DBD1SubCDBD1
747DBDASubCDBDA_Loop
748DBE7SubCDBE7_Loop
749DBF6SubCDBF6_Loop
750DBF7SubCDBF7_OnNonzero
751DC17SubCDC17_Loop
752DC1BSubCDC1B_OnZero
753DC21SubCDC21_Loop
754DC27SubCDC27_Loop
755DC2CSubCDC2C_Loop
756DC2DSubCDC2D_Loop
757DC38SubCDC38_Loop
758DC58SubCDC58
759DC65SubCDC65_Loop
760DC68SubCDC68_Loop
761DC6CSubCDC6C_Loop
762DC8ASubCDC8A_Loop
763DC95SubCDC95
764DC9BSubCDC9B_Loop
765DCABSubCDCAB
766DCB3SubCDCB3_Loop
767DCC0SubCDCC0_Loop
768DCC1SubCDCC1_Loop
769DCC6SubCDCC6_Loop
770DCD4SubCDCD4_Loop
771DCDCSubCDCDC
772DCDFSubCDCDF_Loop
773DCE6SubCDCE6_Loop
774E484SubCE484
775E497SubCE497_Loop
776E4AASubCE4AA_OnNonzero
777E4B3SubCE4B3_OnNonzero
778E4B4SubCE4B4_Loop
779E4D1SubCE4D1_OnNonnegative
780E4E0SubCE4E0
781E504SubCE504_Loop
782E509SubCE509
783E521SubCE521
784E52DSubCE52D
785E562SubCE562
786E578SubCE578_Loop
787E581SubCE581_Loop
788E589SubCE589_OnNonnegative
789E593SubCE593_Loop
790E594SubCE594_Loop
791E59ASubCE59A
792E5ACSubCE5AC_Loop
793E5AESubCE5AE_Loop
794E5B0SubCE5B0
795E5D1SubCE5D1_Loop
796E601SubCE601_Loop
797E618SubCE618_Loop
798E61CSubCE61C_Loop
799E61DSubCE61D
800E62DSubCE62D_Loop
801E631SubCE631_OnCarrySet
802E632SubCE632_Loop
803E636SubCE636_Loop
804E64CSubCE64C_Loop
805E659SubCE659_Loop
806E661SubCE661_Loop
807E667SubCE667_OnCarryClear
808E685SubCE685_Loop
809E693SubCE693_Loop
810E69FSubCE69F_Loop
811E6B0SubCE6B0
812E6C9SubCE6C9
813E6D8SubCE6D8_Loop
814E79FSubCE79F
815E7A9SubCE7A9_OnNonzero
816E7B3SubCE7B3_Loop
817E7B9SubCE7B9_Loop
818E7BASubCE7BA
819E7D2SubCE7D2_OnNonnegative
820E7EBSubCE7EB
821E7FESubCE7FE_Loop
822E80ASubCE80A_Loop
823E814SubCE814_Loop
824E81ASubCE81A_Loop
825E823SubCE823_Loop
826E82BSubCE82B_Loop
827E82CSubCE82C
828E837SubCE837_Loop
829E838SubCE838
830E842SubCE842
831E845SubCE845
832E849SubCE849_OnNonzero
833E86ASubCE86A_Loop
834E86CSubCE86C_Loop
835E88ASubCE88A_Loop
836E88FSubCE88F_Loop
837E897SubCE897_Loop
838E89DSubCE89D_OnNonnegative
839E8A8SubCE8A8_OnNonzero
840E8B6SubCE8B6_Loop
841E8CDSubCE8CD_Loop
842E8D2SubCE8D2_Loop
843E8D7SubCE8D7_Loop
844E8E2SubCE8E2_Loop
845E8E9SubCE8E9_Loop
846E8FESubCE8FE_Loop
847E902SubCE902_Loop
848E903SubCE903
849E905SubCE905_OnNonnegative
850E918SubCE918_Loop
851E91ASubCE91A_OnNonzero
852E91FSubCE91F
853E921SubCE921_OnNonnegative
854E92ESubCE92E
855E950SubCE950_Loop
856E95BSubCE95B_Loop
857E95CSubCE95C
858E95ESubCE95E_OnNonnegative
859E969SubCE969
860E97ESubCE97E
861E980SubCE980_OnNonnegative
862E992SubCE992_Loop
863E994SubCE994_OnNonzero
864E9A0SubCE9A0_Loop
865E9A9SubCE9A9_Loop
866E9B3SubCE9B3_Loop
867E9BCSubCE9BC
868E9BESubCE9BE_OnNonzero
869E9CESubCE9CE_Loop
870EAC0SubCEAC0_OnNonzero
871EAC4SubCEAC4
872EACESubCEACE_Loop
873EAD6SubCEAD6_Loop
874EADBSubCEADB_Loop
875EB0FSubCEB0F_Loop
876EB18SubCEB18_Loop
877EB98SubCEB98
878EBAFSubCEBAF_Loop
879EBBFSubCEBBF_Loop
880EBC3SubCEBC3_Loop
881EC94SubCEC94
882EC9CSubCEC9C
883ED21SubCED21
884ED26SubCED26
885ED30SubCED30_OnNonzero
886ED42SubCED42
887ED51SubCED51
888ED55SubCED55_OnNonzero
889ED60SubCED60_Loop
890ED65SubCED65_Loop
891ED66SubCED66
892ED8ASubCED8A_Loop
893ED8CSubCED8C_OnZero
894ED8DSubCED8D_OnZero
895EDA7SubCEDA7_Loop
896EDAESubCEDAE_Loop
897EDB3SubCEDB3
898EDC0SubCEDC0
899EDD3SubCEDD3_Loop
900EDDDSubCEDDD_Loop
901EDE7SubCEDE7
902EDF3SubCEDF3
903EDFASubCEDFA_Loop
904EDFESubCEDFE
905EE0ASubCEE0A
906EE1DSubCEE1D_Loop
907EE27SubCEE27_Loop
908EE28SubCEE28
909EE4ESubCEE4E_Loop
910EE59SubCEE59_Loop
911EEC2SubCEEC2
912EED0SubCEED0
913EED9SubCEED9
914EEE9SubCEEE9_Loop
915EEEASubCEEEA_Loop
916EEFFSubCEEFF_Loop
917EF09SubCEF09_Loop
918EF0ESubCEF0E_OnNonnegative
919EF2FSubCEF2F_Loop
920EF38SubCEF38_Loop
921EF3ASubCEF3A_Loop
922EF3DSubCEF3D_Loop
923EF53SubCEF53
924EF6FSubCEF6F_Loop
925EF74SubCEF74
926EF76SubCEF76_OnNonnegative
927EF80SubCEF80_Loop
928F06ESubCF06E
929F078SubCF078
930F07ASubCF07A_OnNonnegative
931F084SubCF084_OnZero
932F085SubCF085_Loop
933F188SubCF188
934F196SubCF196_OnNonnegative
935F1A0SubCF1A0_Loop
936F1CFSubCF1CF
937F1DFSubCF1DF_Loop
938F1EDSubCF1ED_Loop
939F1F3SubCF1F3_Loop
940F1F9SubCF1F9_OnNonzero
941F202SubCF202_Loop
942F215SubCF215_Loop
943F21FSubCF21F_Loop
944F23FSubCF23F
945F257SubCF257_Loop
946F267SubCF267_Loop
947F27ASubCF27A_Loop
948F27ESubCF27E_Loop
949F288SubCF288_Loop
950F290SubCF290_Loop
951F2A0SubCF2A0_Loop
952F2B3SubCF2B3_Loop
953F2B7SubCF2B7_Loop
954F2BESubCF2BE_Loop
955F2D6SubCF2D6_Loop
956F2D8SubCF2D8_Loop
957F2DBSubCF2DB
958F2FBSubCF2FB_OnNonzero
959F313SubCF313_Loop
960F315SubCF315_Loop
961F319SubCF319_Loop
962F31BSubCF31B_Loop
963F31FSubCF31F_OnZero
964F342SubCF342
965F34DSubCF34D_Loop
966F356SubCF356_Loop
967F36DSubCF36D
968F383SubCF383_Loop
969F386SubCF386_Loop
970F395SubCF395_Loop
971F39ASubCF39A
972F3AASubCF3AA_Loop
973F3ADSubCF3AD_Loop
974F3AFSubCF3AF_Loop
975F3B0SubCF3B0
976F3C0SubCF3C0_Loop
977F3C3SubCF3C3
978F3D4SubCF3D4
979F3F4SubCF3F4_Loop
980F404SubCF404_OnZero
981F408SubCF408
982F415SubCF415_Loop
983F41FSubCF41F_Loop
984F42DSubCF42D_Loop
985F42ESubCF42E
986F432SubCF432
987F434SubCF434_Loop
988F44BSubCF44B_Loop
989F44ESubCF44E_OnCarrySet
990F45FSubCF45F_Loop
991F474SubCF474_Loop
992F479SubCF479
993F495SubCF495_Loop
994F4A6SubCF4A6_Loop
995F4BBSubCF4BB_Loop
996F4BDSubCF4BD_Loop
997F4BESubCF4BE_Loop
998F4DESubCF4DE_Loop
999F4F3SubCF4F3_Loop
1000F4F5SubCF4F5_Loop
1001F504SubCF504_Loop
1002F51DSubCF51D
1003F535SubCF535_Loop
1004F53FSubCF53F_OnZero
1005F540SubCF540
1006F54ESubCF54E_Loop
1007F55DSubCF55D_Loop
1008F55FSubCF55F_Loop
1009F570SubCF570_Loop
1010F571SubCF571
1011F57ASubCF57A_OnNonzero
1012F587SubCF587_Loop
1013F588SubCF588_Loop
1014F599SubCF599_Loop
1015F59ASubCF59A_Loop
1016F5A1SubCF5A1_OnNonzero
1017F5BFSubCF5BF_Loop
1018F5C6SubCF5C6
1019F5CDSubCF5CD_OnNonnegative
1020F5D8SubCF5D8_Loop
1021F5FBSubCF5FB_Loop
1022F600SubCF600_OnCarryClear
1023F601SubCF601
1024F612SubCF612
1025F61ASubCF61A_OnNonnegative
1026F62ASubCF62A_Loop
1027F633SubCF633_Loop
1028F63ASubCF63A_Loop
1029F63FSubCF63F_Loop
1030F641SubCF641_Loop
1031F649SubCF649
1032F666SubCF666
1033F671SubCF671_OnZero
1034F672SubCF672_OnCarryClear
1035F68DSubCF68D_Loop
1036F693SubCF693_Loop
1037F6B6SubCF6B6_OnZero
1038F6CDSubCF6CD
1039F6D7SubCF6D7_Loop
1040F6DDSubCF6DD_Loop
1041F6E3SubCF6E3_Loop
1042F6EESubCF6EE_OnCarrySet
1043F6EFSubCF6EF_Loop
1044F70CSubCF70C_Loop
1045F726SubCF726_Loop
1046F735SubCF735_OnNonnegative
1047F758SubCF758
1048F7DASubCF7DA
1049F7DFSubCF7DF
1050F7E4SubCF7E4
1051F7E9SubCF7E9
1052F7EESubCF7EE
1053F7FCSubCF7FC
1054F80CSubCF80C_Loop
1055F80DSubCF80D
1056F835SubCF835_Loop
1057F85BSubCF85B_Loop
1058F85DSubCF85D_Loop
1059F867SubCF867_Loop
1060F873SubCF873_Loop
1061F87CSubCF87C
1062F880SubCF880_OnCarryClear
1063F88BSubCF88B_Loop
1064F895SubCF895_Loop
1065F89ESubCF89E_OnNonnegative
1066F8A9SubCF8A9_Loop
1067F8ADSubCF8AD_OnZero
1068F8C4SubCF8C4_OnNonzero
1069F8C8SubCF8C8
1070F8E1SubCF8E1
1071F8EESubCF8EE_Loop
1072F8EFSubCF8EF_Loop
1073F8F2SubCF8F2_Loop
1074F902SubCF902_Loop
1075F918SubCF918_Loop
1076F921SubCF921_Loop
1077F93CSubCF93C_Loop
1078F955SubCF955_Loop
1079F962SubCF962_Loop
1080F975SubCF975
1081F97ASubCF97A_Loop
1082F981SubCF981_Loop
1083F987SubCF987_Loop
1084F994SubCF994_Loop
1085F99BSubCF99B_Loop
1086F9AESubCF9AE_Loop
1087F9B3SubCF9B3_Loop
1088F9BDSubCF9BD_Loop
1089F9C9SubCF9C9
1090F9D1SubCF9D1_Loop
1091F9FFSubCF9FF_Loop
1092FA12SubCFA12_Loop
1093FA23SubCFA23_Loop
1094FA32SubCFA32_OnNonzero
1095FA3ASubCFA3A_Loop
1096FA3CSubCFA3C_Loop
1097FA5ESubCFA5E_Loop
1098FA62SubCFA62_Loop
1099FA73SubCFA73
1100FA80SubCFA80_Loop
1101FA98SubCFA98_Loop
1102FA9ASubCFA9A_Loop
1103FAA1SubCFAA1_Loop
1104FAA9SubCFAA9
1105FABASubCFABA_Loop