Files
disasm/NROM/Slalom (U)/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

20 KiB

18050Reset
28057Sub_OnNonnegative
3805CSub_OnNonnegative2
48067Sub_8067
58069Sub_8069
680DCSubC80DC
78123NmiHandler
88166SubC8166
981ADSub_Loop3
1081B1Sub_Loop4
1181BASub_OnNonzero
1281CDSub_81CD
1381D2Sub_81D2
1481D4Sub_81D4
1581D9Sub_81D9
1681FDSub_81FD
178203Sub_8203
188206Sub_8206
198224Sub_Loop5
208229Sub_Loop6
21822ASub_Loop7
228230SubC8230
238262SubC8262
248273Sub_OnNonzero2
258276SubC8276
26829BSub_829B
2782AESubC82AE
2882CDSubC82CD
2982E7Sub_82E7
3082F3SubC82F3
3182FCSubC82FC
32830ESub_830E
338318Sub_OnNonzero3
34831BSub_Loop8
358323Sub_Loop9
36832ESub_832E
37833BSub_833B
388343Sub_Loop10
398373Sub_8373
40837ESub_837E
41839ESub_OnNonzero4
4283F2Sub_OnNonzero5
438439Sub_OnZero
44845ESub_Loop11
458486Sub_8486
46848CSub_OnNonzero6
478496Sub_8496
4884A5Sub_Loop12
4984AASub_Loop13
5084ECSubC84EC
5184FBSub_Loop14
5284FESub_Loop15
53850CSub_850C
54850FSub_Loop16
558517Sub_Loop17
56851ASub_851A
57851CSub_OnNonzero7
58852DSub_OnNonzero8
598536Sub_8536
6087F8Sub_87F8
618819Sub_8819
628877Sub_Loop18
63888ASub_888A
6488B3Sub_88B3
6588FCSub_88FC
668912Sub_OnNonnegative3
678948Sub_OnNonzero9
688973Sub_8973
69899BSub_899B
70899CSub_899C
7189A8Sub_89A8
7289B6Sub_Loop19
7389B7Sub_89B7
7489C9Sub_89C9
7589D2SubC89D2
7689DESub_OnNonzero10
7789F1Sub_OnNonzero11
788A04Sub_OnNonzero12
798A0ESub_OnNonzero13
808A21Sub_OnNonzero14
818A33Sub_OnNonzero15
828A3ESub_Loop20
838A4FSub_OnNonzero16
848A5CSub_Loop21
858A6DSub_8A6D
868A6FSub_OnNonzero17
878A7DSub_Loop22
888A7FSub_OnNonzero18
898A90Sub_OnNonzero19
908A9ASub_OnNonzero20
918AB9Sub_OnNonzero21
928B26Sub_8B26
938B32Sub_OnNonzero22
948B3ESub_OnNonzero23
958B7CSub_OnZero2
968B7FSub_8B7F
978B89Sub_OnNonzero24
988BA3Sub_8BA3
998BA5Sub_8BA5
1008BCESub_Loop23
1018BD7Sub_Loop24
1028BDDSubC8BDD
1038BE7SubC8BE7
1048BEESubC8BEE
1058BF2Sub_8BF2
1068C05Sub_Loop25
1078C53Sub_Loop26
1088C54SubC8C54
1098C86Sub_8C86
1108CA7Sub_8CA7
1118CB4Sub_OnCarryClear
1128CB7Sub_Loop27
1138CC2SubC8CC2
1148CF8SubC8CF8
1158D09Sub_Loop28
1168D0CSub_8D0C
1178D15Sub_8D15
1188D1FSub_8D1F
1198D25Sub_Loop29
1208D35Sub_8D35
1218D3BSub_Loop30
1228D4ASub_OnNonzero25
1238D51Sub_Loop31
1248D62Sub_OnNonzero26
1258D72Sub_Loop32
1268D85Sub_Loop33
1278D91Sub_Loop34
1288D9ESub_8D9E
1298DA9Sub_Loop35
1308DB1Sub_Loop36
1318DB6Sub_8DB6
1328DBDSub_8DBD
1338DDCSub_Loop37
1348DF4Sub_OnCarrySet
1358DFCSub_Loop38
1368E01Sub_OnCarrySet2
1378E07Sub_Loop39
1388E11SubC8E11
1398E20Sub_Loop40
1408E22Sub_8E22
1418E27Sub_Loop41
1428E36Sub_Loop42
1438E39Sub_8E39
1448E3BSub_Loop43
1458E58Sub_Loop44
1468E65Sub_8E65
1478E97Sub_Loop45
1488EADSub_8EAD
1498EAFSub_Loop46
1508EB7Sub_Loop47
1518EC0Sub_Loop48
1528ED9Sub_8ED9
1538EE3Sub_Loop49
1548EEDSub_Loop50
1558EF9Sub_Loop51
1568F01Sub_Loop52
1578F0FSub_8F0F
1588F17Sub_Loop54
1598F1CSub_8F1C
1608F22Sub_Loop55
1618F41Sub_Loop56
1628F4ASub_Loop57
1638F87Sub_Loop58
1648FB2Sub_Loop59
1659033Sub_9033
166904ESub_904E
1679050Sub_OnCarryClear2
1689052Sub_Loop60
1699053Sub_Loop61
1709087Sub_9087
17190A7Sub_Loop62
17290B0Sub_90B0
17390B8Sub_90B8
17490D1Sub_Loop63
17590D2Sub_Loop64
17690E2Sub_Loop65
1779105Sub_9105
178910DSub_Loop66
179910ESub_Loop67
1809118Sub_Loop68
1819131Sub_OnNonzero27
1829143Sub_9143
1839154Sub_9154
18491ADSub_91AD
18591C4Sub_Loop69
18691E7Sub_91E7
18791F1Sub_Loop70
18891F2Sub_Loop71
189925DSub_925D
190926BSub_OnNonzero28
1919283Sub_Loop72
192928ASub_Loop73
193928BSub_Loop74
1949298Sub_Loop75
19592AASub_OnCarryClear3
19692AFSub_92AF
19792B2Sub_Loop76
19892BCSub_Loop77
19992C5SubC92C5
20092C6Sub_92C6
20192E7Sub_Loop78
20292F7Sub_OnNonzero29
2039313Sub_Loop79
2049320Sub_Loop80
2059331Sub_Loop81
206933FSub_OnZero3
2079344Sub_Loop82
2089369Sub_9369
209937BSub_Loop83
2109387Sub_Loop84
2119397Sub_Loop85
21293B9Sub_93B9
21393D1Sub_Loop86
21493DFSub_Loop87
21593F4Sub_Loop88
2169402Sub_Loop89
217940FSub_OnNegative
2189414Sub_Loop90
2199417Sub_OnNonzero30
2209447Sub_Loop91
2219455Sub_Loop92
2229466Sub_Loop93
2239474Sub_OnNegative2
2249479Sub_Loop94
225947CSub_OnNonzero31
22694A8Sub_Loop95
22794B6Sub_Loop96
22894C7Sub_Loop97
22994D5Sub_94D5
23094EFSub_OnNonnegative4
23194FASub_Loop98
23294FBSub_Loop99
2339528Sub_Loop100
234952BSub_952B
235954BSub_954B
236955FSub_955F
2379569Sub_Loop101
23895B5Sub_OnCarrySet3
23995BASub_Loop102
24095BBSub_Loop103
24195D1Sub_95D1
2429613Sub_9613
2439620Sub_9620
244963FSub_Loop104
2459670Sub_9670
246967DSub_967D
247969ASub_Loop105
24896A5Sub_Loop106
24996C6Sub_Loop107
25096D0SubC96D0
25196D2Sub_OnNonzero32
25296E1Sub_Loop108
2539707Sub_Loop109
2549723Sub_Loop110
255972ASub_Loop111
256972CSub_Loop112
2579748Sub_Loop113
2589750Sub_Loop114
259975ASub_Loop115
2609760Sub_9760
261979ESub_Loop116
26297C1Sub_Loop117
26397CBSub_Loop118
26497CDSub_Loop119
26597CFSub_Loop120
26697E4Sub_Loop121
26797EESub_Loop122
26897F0Sub_Loop123
26997F2SubC97F2
27097F3SubC97F3
27197FASubC97FA
27297FBSubC97FB
27397FCSubC97FC
2749802Sub_Loop124
2759807Sub_9807
2769814Sub_Loop125
2779824SubC9824
2789848Sub_Loop126
2799849Sub_9849
280985DSub_985D
2819864Sub_Loop127
2829866Sub_Loop128
28398CFSub_98CF
28498F6Sub_Loop129
28598F7Sub_OnNonnegative5
2869902Sub_Loop130
2879903Sub_Loop131
2889917Sub_9917
289993ASub_Loop132
290993FSubC993F
2919962Sub_OnCarryClear4
292996FSub_Loop133
2939991Sub_Loop134
29499C5Sub_99C5
29599DASub_99DA
29699E9Sub_Loop135
29799F1Sub_Loop136
29899F9Sub_Loop137
29999FCSub_Loop138
3009A08Sub_Loop139
3019A59SubC9A59
3029A64Sub_9A64
3039A69SubC9A69
3049A79Sub_Loop140
3059A82SubC9A82
3069AA3Sub_Loop141
3079AA8SubC9AA8
3089AADSubC9AAD
3099AB2SubC9AB2
3109AB7SubC9AB7
3119ABCSubC9ABC
3129AC1SubC9AC1
3139AC3Sub_9AC3
3149AE2Sub_Loop142
3159B15Sub_9B15
3169B27Sub_Loop143
3179B2ESub_Loop144
3189B59Sub_Loop145
3199B6ESub_Loop146
3209B8ASub_Loop147
3219B8CSub_Loop148
3229B9DSub_9B9D
3239BA7Sub_Loop149
3249BB4Sub_Loop150
3259BBBSub_9BBB
3269BE3Sub_9BE3
3279BE7Sub_OnNonzero33
3289BF3Sub_Loop151
3299BF7Sub_9BF7
3309C00Sub_9C00
3319C09Sub_9C09
3329C0BSub_9C0B
3339C0DSub_OnNonzero34
3349C0FSub_OnNonzero35
3359C1ESub_Loop152
3369C23SubC9C23
3379C2ASub_Loop153
3389C3FSub_OnNonzero36
3399CDASub_9CDA
3409CE8Sub_Loop154
3419D0BSub_9D0B
3429D1DSubC9D1D
3439D4BSub_Loop155
3449D5BSub_Loop156
3459D5FSub_9D5F
3469D62Sub_Loop157
3479D6BSub_9D6B
3489D6ESub_9D6E
3499DACSub_OnNonzero37
3509DC2Sub_OnNonzero38
3519DF1Sub_Loop158
3529E11Sub_9E11
3539E25Sub_9E25
3549E2CSub_9E2C
3559E43Sub_9E43
3569EAESub_9EAE
3579EBCSub_9EBC
3589ECASub_9ECA
3599ED5Sub_9ED5
3609F20SubC9F20
3619F46SubC9F46
3629F4BSub_9F4B
3639F4ESub_Loop159
3649F63Sub_Loop160
3659F6DSub_Loop161
3669F70SubC9F70
3679F7ESub_9F7E
3689F84Sub_OnZero4
3699F8CSubC9F8C
3709F9DSub_9F9D
3719FA9Sub_Loop162
3729FB1Sub_9FB1
3739FBDSub_9FBD
374A338Sub_A338
375A350Sub_A350
376A37DSub_Loop163
377A38CSub_A38C
378A3B5Sub_Loop164
379A3DBSub_Loop165
380A3EASub_Loop166
381A3F0Sub_A3F0
382A4DFSub_A4DF
383A4E8Sub_A4E8
384A4EESub_A4EE
385A4FCSub_A4FC
386A50ASub_Loop167
387A50ESub_A50E
388A51DSub_Loop168
389A51ESub_Loop169
390A520Sub_Loop170
391A521Sub_A521
392A52ASub_Loop171
393A579Sub_OnNonzero39
394A5A4Sub_OnNonzero40
395A5BBSub_OnNonzero41
396A5C7Sub_OnNonzero42
397A5E0Sub_A5E0
398A5E7Sub_OnNonnegative6
399A5FESub_A5FE
400A601SubCA601
401A650Sub_Loop172
402A66CSub_Loop173
403A674Sub_Loop174
404A697Sub_A697
405A69ASub_Loop175
406A69ESub_A69E
407A6A5Sub_Loop176
408A6ACSub_A6AC
409A6B9Sub_Loop177
410A6C8Sub_A6C8
411A6CBSub_A6CB
412A6D7Sub_A6D7
413A6D9Sub_OnNonzero43
414A819SubCA819
415A853Sub_OnNonzero44
416A85CSub_OnNonzero45
417A87ESub_A87E
418A88BSub_A88B
419A88DSub_OnNonzero46
420A899SubCA899
421A8A4Sub_A8A4
422A8E0Sub_Loop178
423A8E9Sub_OnNonzero47
424A952Sub_A952
425A962Sub_Loop179
426A965Sub_Loop180
427A96CSub_Loop181
428A97BSub_Loop182
429A98FSub_A98F
430A99ASub_A99A
431A9A5Sub_Loop183
432A9A8Sub_Loop184
433A9B3Sub_Loop185
434A9B7Sub_A9B7
435A9C5Sub_A9C5
436AB76Sub_AB76
437AB7ASub_AB7A
438AB85Sub_AB85
439AB8FSub_OnNonzero48
440AD5ASub_AD5A
441AD71Sub_AD71
442AD73Sub_OnNonzero49
443AE7DSub_AE7D
444AE8ESub_AE8E
445AEA8Sub_AEA8
446AEB7Sub_AEB7
447AEC8Sub_OnNonzero50
448AEE9SubCAEE9
449AEEESubCAEEE
450AEF3Sub_Loop186
451AEF4Sub_AEF4
452AEF6Sub_OnNonnegative7
453AF08Sub_OnZero5
454AF2BSubCAF2B
455AF36Sub_OnNonnegative8
456AF58Sub_Loop187
457AF6CSub_AF6C
458AF79Sub_Loop188
459AF89Sub_Loop189
460AF9ASub_Loop190
461AF9FSub_Loop191
462AFA8Sub_Loop192
463AFABSub_OnNonzero51
464AFB6Sub_AFB6
465AFC1Sub_Loop193
466AFC8Sub_AFC8
467AFCCSub_Loop194
468AFDESub_Loop195
469AFF9Sub_AFF9
470B00FSub_Loop196
471B047Sub_OnNegative3
472B04FSub_B04F
473B06ASub_B06A
474B084Sub_OnNonzero52
475B095Sub_OnCarrySet4
476B09ASub_Loop197
477B09BSub_Loop198
478B0B0Sub_Loop199
479B0B5Sub_Loop200
480B0BDSub_Loop201
481B0BFSub_B0BF
482B0C3Sub_B0C3
483B0D1Sub_B0D1
484B0DFSub_B0DF
485B0E9Sub_B0E9
486B0F2Sub_Loop202
487B0FASub_Loop203
488B106Sub_B106
489B116Sub_Loop204
490B11BSub_Loop205
491B120Sub_Loop206
492B122Sub_B122
493B128Sub_Loop207
494B12DSub_B12D
495B147Sub_OnZero6
496B165Sub_Loop208
497B166Sub_Loop209
498B178Sub_Loop210
499B185Sub_Loop211
500B18CSub_B18C
501B1A0Sub_Loop212
502B1AFSub_Loop213
503B1CCSub_Loop214
504B1D1SubCB1D1
505B1D3Sub_B1D3
506B1DFSubCB1DF
507B1F0Sub_Loop215
508B1F4Sub_Loop216
509B1F5Sub_Loop217
510B204Sub_Loop218
511B215Sub_Loop219
512B216Sub_B216
513B257Sub_Loop220
514B258Sub_OnNegative4
515B261Sub_B261
516B27ESub_Loop221
517B280Sub_Loop222
518B297Sub_Loop223
519B2B4Sub_B2B4
520B2B6Sub_OnCarryClear5
521B2B8Sub_Loop224
522B2B9Sub_Loop225
523B2C1Sub_Loop226
524B2CESub_OnCarrySet5
525B2D1Sub_Loop227
526B2D6Sub_Loop228
527B2E6Sub_Loop229
528B2EBSub_B2EB
529B2F7Sub_OnNonzero53
530B304Sub_OnNonzero54
531B3B4Sub_B3B4
532B3C4Sub_OnNonzero55
533B3C8Sub_OnNonzero56
534B3DBSub_OnNonzero57
535B3F6Sub_OnNonzero58
536B3FASub_OnNonzero59
537B40DSub_OnNonzero60
538B419Sub_B419
539B41FSub_OnNonzero61
540B425Sub_Loop230
541B426Sub_B426
542B42CSub_B42C
543B437Sub_Loop231
544B438Sub_B438
545B444Sub_OnNonzero62
546B475Sub_Loop232
547B476Sub_B476
548B480Sub_B480
549B482Sub_OnNonzero63
550B48ESub_B48E
551B49BSub_B49B
552B49DSub_OnNonzero64
553B4A3Sub_B4A3
554B4A5Sub_OnNonzero65
555B4ACSub_B4AC
556B4B1Sub_OnNonzero66
557B4B8Sub_B4B8
558B4BCSub_B4BC
559B4CBSub_OnNonzero67
560B5D6Sub_B5D6
561B5D8Sub_B5D8
562B5DBSub_OnNonzero68
563B5EESub_OnNonzero69
564B5FFSub_B5FF
565B605Sub_Loop233
566B6B4Sub_B6B4
567B6C0Sub_OnCarrySet6
568B70ASub_B70A
569B716Sub_Loop234
570B766SubCB766
571B767SubCB767
572B76FSub_Loop235
573B787Sub_Loop236
574B793SubCB793
575B796SubCB796
576B7AFSub_Loop237
577B7B2Sub_Loop238
578B7BCSubCB7BC
579B7C4SubCB7C4
580B7C5SubCB7C5
581B7CBSub_B7CB
582B7D1Sub_B7D1
583B7F1SubCB7F1
584B7F4SubCB7F4
585B7FCSub_Loop239
586B80CSub_B80C
587B81BSubCB81B
588B829SubCB829
589B834SubCB834
590B843SubCB843
591B854Sub_Loop240
592B859Sub_Loop241
593B85CSub_Loop242
594B879SubCB879
595B890Sub_Loop243
596B891SubCB891
597B899Sub_Loop244
598B8A1SubCB8A1
599B8A4SubCB8A4
600B8ACSub_Loop245
601B8B6SubCB8B6
602B8EFSubCB8EF
603B914SubCB914
604B91ESubCB91E
605B921SubCB921
606B939Sub_Loop246
607B93CSub_Loop247
608C44ESub_C44E
609C456Sub_Loop248
610C463Sub_Loop249
611C46BSub_OnNonzero70
612C470Sub_C470
613C483Sub_Loop250
614C48BSub_Loop251
615C48DSub_C48D
616C49FSub_C49F
617C4A9Sub_Loop252
618C5D6SubCC5D6
619C5EFSubCC5EF
620C607Sub_C607
621C61FSub_Loop253
622C62DSub_C62D
623C633Sub_Loop254
624C634SubCC634
625C63FSubCC63F
626C64ASubCC64A
627C655SubCC655
628C65DSub_OnZero7
629C663SubCC663
630C68CSub_OnNonzero71
631C696Sub_Loop255
632C699SubCC699
633C6B5SubCC6B5
634C6C8SubCC6C8
635C6CBSub_C6CB
636C6D1Sub_OnNonzero72
637C6E6Sub_Loop256
638FE0ASub_FE0A
639FE0CSub_OnNonnegative9
640FE15Sub_FE15
641FE2ASub_Loop257
642FE40Sub_Loop258
643FE45Sub_FE45
644FE5CSub_FE5C
645FE70Sub_OnZero8
646FE77Sub_OnNonzero73
647FE81Sub_Loop259
648FFA0Sub_OnNonzero74
649# ---- derived internal branch-target names ----
6508050Reset
6518057Sub_OnNonnegative
652805CSub_OnNonnegative2
6538067Sub_8067
6548069Sub_8069
65580DCSubC80DC
6568123NmiHandler
6578166SubC8166
65881ADSub_Loop3
65981B1Sub_Loop4
66081BASub_OnNonzero
66181CDSub_81CD
66281D2Sub_81D2
66381D4Sub_81D4
66481D9Sub_81D9
66581FDSub_81FD
6668203Sub_8203
6678206Sub_8206
6688224Sub_Loop5
6698229Sub_Loop6
670822ASub_Loop7
6718230SubC8230
6728262SubC8262
6738273Sub_OnNonzero2
6748276SubC8276
675829BSub_829B
67682AESubC82AE
67782CDSubC82CD
67882E7Sub_82E7
67982F3SubC82F3
68082FCSubC82FC
681830ESub_830E
6828318Sub_OnNonzero3
683831BSub_Loop8
6848323Sub_Loop9
685832ESub_832E
686833BSub_833B
6878343Sub_Loop10
6888373Sub_8373
689837ESub_837E
690839ESub_OnNonzero4
69183F2Sub_OnNonzero5
6928439Sub_OnZero
693845ESub_Loop11
6948486Sub_8486
695848CSub_OnNonzero6
6968496Sub_8496
69784A5Sub_Loop12
69884AASub_Loop13
69984ECSubC84EC
70084FBSub_Loop14
70184FESub_Loop15
702850CSub_850C
703850FSub_Loop16
7048517Sub_Loop17
705851ASub_851A
706851CSub_OnNonzero7
707852DSub_OnNonzero8
7088536Sub_8536
70987F8Sub_87F8
7108819Sub_8819
7118877Sub_Loop18
712888ASub_888A
71388B3Sub_88B3
71488FCSub_88FC
7158912Sub_OnNonnegative3
7168948Sub_OnNonzero9
7178973Sub_8973
718899BSub_899B
719899CSub_899C
72089A8Sub_89A8
72189B6Sub_Loop19
72289B7Sub_89B7
72389C9Sub_89C9
72489D2SubC89D2
72589DESub_OnNonzero10
72689F1Sub_OnNonzero11
7278A04Sub_OnNonzero12
7288A0ESub_OnNonzero13
7298A21Sub_OnNonzero14
7308A33Sub_OnNonzero15
7318A3ESub_Loop20
7328A4FSub_OnNonzero16
7338A5CSub_Loop21
7348A6DSub_8A6D
7358A6FSub_OnNonzero17
7368A7DSub_Loop22
7378A7FSub_OnNonzero18
7388A90Sub_OnNonzero19
7398A9ASub_OnNonzero20
7408AB9Sub_OnNonzero21
7418B26Sub_8B26
7428B32Sub_OnNonzero22
7438B3ESub_OnNonzero23
7448B7CSub_OnZero2
7458B7FSub_8B7F
7468B89Sub_OnNonzero24
7478BA3Sub_8BA3
7488BA5Sub_8BA5
7498BCESub_Loop23
7508BD7Sub_Loop24
7518BDDSubC8BDD
7528BE7SubC8BE7
7538BEESubC8BEE
7548BF2Sub_8BF2
7558C05Sub_Loop25
7568C53Sub_Loop26
7578C54SubC8C54
7588C86Sub_8C86
7598CA7Sub_8CA7
7608CB4Sub_OnCarryClear
7618CB7Sub_Loop27
7628CC2SubC8CC2
7638CF8SubC8CF8
7648D09Sub_Loop28
7658D0CSub_8D0C
7668D15Sub_8D15
7678D1FSub_8D1F
7688D25Sub_Loop29
7698D35Sub_8D35
7708D3BSub_Loop30
7718D4ASub_OnNonzero25
7728D51Sub_Loop31
7738D62Sub_OnNonzero26
7748D72Sub_Loop32
7758D85Sub_Loop33
7768D91Sub_Loop34
7778D9ESub_8D9E
7788DA9Sub_Loop35
7798DB1Sub_Loop36
7808DB6Sub_8DB6
7818DBDSub_8DBD
7828DDCSub_Loop37
7838DF4Sub_OnCarrySet
7848DFCSub_Loop38
7858E01Sub_OnCarrySet2
7868E07Sub_Loop39
7878E11SubC8E11
7888E20Sub_Loop40
7898E22Sub_8E22
7908E27Sub_Loop41
7918E36Sub_Loop42
7928E39Sub_8E39
7938E3BSub_Loop43
7948E58Sub_Loop44
7958E65Sub_8E65
7968E97Sub_Loop45
7978EADSub_8EAD
7988EAFSub_Loop46
7998EB7Sub_Loop47
8008EC0Sub_Loop48
8018ED9Sub_8ED9
8028EE3Sub_Loop49
8038EEDSub_Loop50
8048EF9Sub_Loop51
8058F01Sub_Loop52
8068F0FSub_8F0F
8078F17Sub_Loop54
8088F1CSub_8F1C
8098F22Sub_Loop55
8108F41Sub_Loop56
8118F4ASub_Loop57
8128F87Sub_Loop58
8138FB2Sub_Loop59
8149033Sub_9033
815904ESub_904E
8169050Sub_OnCarryClear2
8179052Sub_Loop60
8189053Sub_Loop61
8199087Sub_9087
82090A7Sub_Loop62
82190B0Sub_90B0
82290B8Sub_90B8
82390D1Sub_Loop63
82490D2Sub_Loop64
82590E2Sub_Loop65
8269105Sub_9105
827910DSub_Loop66
828910ESub_Loop67
8299118Sub_Loop68
8309131Sub_OnNonzero27
8319143Sub_9143
8329154Sub_9154
83391ADSub_91AD
83491C4Sub_Loop69
83591E7Sub_91E7
83691F1Sub_Loop70
83791F2Sub_Loop71
838925DSub_925D
839926BSub_OnNonzero28
8409283Sub_Loop72
841928ASub_Loop73
842928BSub_Loop74
8439298Sub_Loop75
84492AASub_OnCarryClear3
84592AFSub_92AF
84692B2Sub_Loop76
84792BCSub_Loop77
84892C5SubC92C5
84992C6Sub_92C6
85092E7Sub_Loop78
85192F7Sub_OnNonzero29
8529313Sub_Loop79
8539320Sub_Loop80
8549331Sub_Loop81
855933FSub_OnZero3
8569344Sub_Loop82
8579369Sub_9369
858937BSub_Loop83
8599387Sub_Loop84
8609397Sub_Loop85
86193B9Sub_93B9
86293D1Sub_Loop86
86393DFSub_Loop87
86493F4Sub_Loop88
8659402Sub_Loop89
866940FSub_OnNegative
8679414Sub_Loop90
8689417Sub_OnNonzero30
8699447Sub_Loop91
8709455Sub_Loop92
8719466Sub_Loop93
8729474Sub_OnNegative2
8739479Sub_Loop94
874947CSub_OnNonzero31
87594A8Sub_Loop95
87694B6Sub_Loop96
87794C7Sub_Loop97
87894D5Sub_94D5
87994EFSub_OnNonnegative4
88094FASub_Loop98
88194FBSub_Loop99
8829528Sub_Loop100
883952BSub_952B
884954BSub_954B
885955FSub_955F
8869569Sub_Loop101
88795B5Sub_OnCarrySet3
88895BASub_Loop102
88995BBSub_Loop103
89095D1Sub_95D1
8919613Sub_9613
8929620Sub_9620
893963FSub_Loop104
8949670Sub_9670
895967DSub_967D
896969ASub_Loop105
89796A5Sub_Loop106
89896C6Sub_Loop107
89996D0SubC96D0
90096D2Sub_OnNonzero32
90196E1Sub_Loop108
9029707Sub_Loop109
9039723Sub_Loop110
904972ASub_Loop111
905972CSub_Loop112
9069748Sub_Loop113
9079750Sub_Loop114
908975ASub_Loop115
9099760Sub_9760
910979ESub_Loop116
91197C1Sub_Loop117
91297CBSub_Loop118
91397CDSub_Loop119
91497CFSub_Loop120
91597E4Sub_Loop121
91697EESub_Loop122
91797F0Sub_Loop123
91897F2SubC97F2
91997F3SubC97F3
92097FASubC97FA
92197FBSubC97FB
92297FCSubC97FC
9239802Sub_Loop124
9249807Sub_9807
9259814Sub_Loop125
9269824SubC9824
9279848Sub_Loop126
9289849Sub_9849
929985DSub_985D
9309864Sub_Loop127
9319866Sub_Loop128
93298CFSub_98CF
93398F6Sub_Loop129
93498F7Sub_OnNonnegative5
9359902Sub_Loop130
9369903Sub_Loop131
9379917Sub_9917
938993ASub_Loop132
939993FSubC993F
9409962Sub_OnCarryClear4
941996FSub_Loop133
9429991Sub_Loop134
94399C5Sub_99C5
94499DASub_99DA
94599E9Sub_Loop135
94699F1Sub_Loop136
94799F9Sub_Loop137
94899FCSub_Loop138
9499A08Sub_Loop139
9509A59SubC9A59
9519A64Sub_9A64
9529A69SubC9A69
9539A79Sub_Loop140
9549A82SubC9A82
9559AA3Sub_Loop141
9569AA8SubC9AA8
9579AADSubC9AAD
9589AB2SubC9AB2
9599AB7SubC9AB7
9609ABCSubC9ABC
9619AC1SubC9AC1
9629AC3Sub_9AC3
9639AE2Sub_Loop142
9649B15Sub_9B15
9659B27Sub_Loop143
9669B2ESub_Loop144
9679B59Sub_Loop145
9689B6ESub_Loop146
9699B8ASub_Loop147
9709B8CSub_Loop148
9719B9DSub_9B9D
9729BA7Sub_Loop149
9739BB4Sub_Loop150
9749BBBSub_9BBB
9759BE3Sub_9BE3
9769BE7Sub_OnNonzero33
9779BF3Sub_Loop151
9789BF7Sub_9BF7
9799C00Sub_9C00
9809C09Sub_9C09
9819C0BSub_9C0B
9829C0DSub_OnNonzero34
9839C0FSub_OnNonzero35
9849C1ESub_Loop152
9859C23SubC9C23
9869C2ASub_Loop153
9879C3FSub_OnNonzero36
9889CDASub_9CDA
9899CE8Sub_Loop154
9909D0BSub_9D0B
9919D1DSubC9D1D
9929D4BSub_Loop155
9939D5BSub_Loop156
9949D5FSub_9D5F
9959D62Sub_Loop157
9969D6BSub_9D6B
9979D6ESub_9D6E
9989DACSub_OnNonzero37
9999DC2Sub_OnNonzero38
10009DF1Sub_Loop158
10019E11Sub_9E11
10029E25Sub_9E25
10039E2CSub_9E2C
10049E43Sub_9E43
10059EAESub_9EAE
10069EBCSub_9EBC
10079ECASub_9ECA
10089ED5Sub_9ED5
10099F20SubC9F20
10109F46SubC9F46
10119F4BSub_9F4B
10129F4ESub_Loop159
10139F63Sub_Loop160
10149F6DSub_Loop161
10159F70SubC9F70
10169F7ESub_9F7E
10179F84Sub_OnZero4
10189F8CSubC9F8C
10199F9DSub_9F9D
10209FA9Sub_Loop162
10219FB1Sub_9FB1
10229FBDSub_9FBD
1023A338Sub_A338
1024A350Sub_A350
1025A37DSub_Loop163
1026A38CSub_A38C
1027A3B5Sub_Loop164
1028A3DBSub_Loop165
1029A3EASub_Loop166
1030A3F0Sub_A3F0
1031A4DFSub_A4DF
1032A4E8Sub_A4E8
1033A4EESub_A4EE
1034A4FCSub_A4FC
1035A50ASub_Loop167
1036A50ESub_A50E
1037A51DSub_Loop168
1038A51ESub_Loop169
1039A520Sub_Loop170
1040A521Sub_A521
1041A52ASub_Loop171
1042A579Sub_OnNonzero39
1043A5A4Sub_OnNonzero40
1044A5BBSub_OnNonzero41
1045A5C7Sub_OnNonzero42
1046A5E0Sub_A5E0
1047A5E7Sub_OnNonnegative6
1048A5FESub_A5FE
1049A601SubCA601
1050A650Sub_Loop172
1051A66CSub_Loop173
1052A674Sub_Loop174
1053A697Sub_A697
1054A69ASub_Loop175
1055A69ESub_A69E
1056A6A5Sub_Loop176
1057A6ACSub_A6AC
1058A6B9Sub_Loop177
1059A6C8Sub_A6C8
1060A6CBSub_A6CB
1061A6D7Sub_A6D7
1062A6D9Sub_OnNonzero43
1063A819SubCA819
1064A853Sub_OnNonzero44
1065A85CSub_OnNonzero45
1066A87ESub_A87E
1067A88BSub_A88B
1068A88DSub_OnNonzero46
1069A899SubCA899
1070A8A4Sub_A8A4
1071A8E0Sub_Loop178
1072A8E9Sub_OnNonzero47
1073A952Sub_A952
1074A962Sub_Loop179
1075A965Sub_Loop180
1076A96CSub_Loop181
1077A97BSub_Loop182
1078A98FSub_A98F
1079A99ASub_A99A
1080A9A5Sub_Loop183
1081A9A8Sub_Loop184
1082A9B3Sub_Loop185
1083A9B7Sub_A9B7
1084A9C5Sub_A9C5
1085AB76Sub_AB76
1086AB7ASub_AB7A
1087AB85Sub_AB85
1088AB8FSub_OnNonzero48
1089AD5ASub_AD5A
1090AD71Sub_AD71
1091AD73Sub_OnNonzero49
1092AE7DSub_AE7D
1093AE8ESub_AE8E
1094AEA8Sub_AEA8
1095AEB7Sub_AEB7
1096AEC8Sub_OnNonzero50
1097AEE9SubCAEE9
1098AEEESubCAEEE
1099AEF3Sub_Loop186
1100AEF4Sub_AEF4
1101AEF6Sub_OnNonnegative7
1102AF08Sub_OnZero5
1103AF2BSubCAF2B
1104AF36Sub_OnNonnegative8
1105AF58Sub_Loop187
1106AF6CSub_AF6C
1107AF79Sub_Loop188
1108AF89Sub_Loop189
1109AF9ASub_Loop190
1110AF9FSub_Loop191
1111AFA8Sub_Loop192
1112AFABSub_OnNonzero51
1113AFB6Sub_AFB6
1114AFC1Sub_Loop193
1115AFC8Sub_AFC8
1116AFCCSub_Loop194
1117AFDESub_Loop195
1118AFF9Sub_AFF9
1119B00FSub_Loop196
1120B047Sub_OnNegative3
1121B04FSub_B04F
1122B06ASub_B06A
1123B084Sub_OnNonzero52
1124B095Sub_OnCarrySet4
1125B09ASub_Loop197
1126B09BSub_Loop198
1127B0B0Sub_Loop199
1128B0B5Sub_Loop200
1129B0BDSub_Loop201
1130B0BFSub_B0BF
1131B0C3Sub_B0C3
1132B0D1Sub_B0D1
1133B0DFSub_B0DF
1134B0E9Sub_B0E9
1135B0F2Sub_Loop202
1136B0FASub_Loop203
1137B106Sub_B106
1138B116Sub_Loop204
1139B11BSub_Loop205
1140B120Sub_Loop206
1141B122Sub_B122
1142B128Sub_Loop207
1143B12DSub_B12D
1144B147Sub_OnZero6
1145B165Sub_Loop208
1146B166Sub_Loop209
1147B178Sub_Loop210
1148B185Sub_Loop211
1149B18CSub_B18C
1150B1A0Sub_Loop212
1151B1AFSub_Loop213
1152B1CCSub_Loop214
1153B1D1SubCB1D1
1154B1D3Sub_B1D3
1155B1DFSubCB1DF
1156B1F0Sub_Loop215
1157B1F4Sub_Loop216
1158B1F5Sub_Loop217
1159B204Sub_Loop218
1160B215Sub_Loop219
1161B216Sub_B216
1162B257Sub_Loop220
1163B258Sub_OnNegative4
1164B261Sub_B261
1165B27ESub_Loop221
1166B280Sub_Loop222
1167B297Sub_Loop223
1168B2B4Sub_B2B4
1169B2B6Sub_OnCarryClear5
1170B2B8Sub_Loop224
1171B2B9Sub_Loop225
1172B2C1Sub_Loop226
1173B2CESub_OnCarrySet5
1174B2D1Sub_Loop227
1175B2D6Sub_Loop228
1176B2E6Sub_Loop229
1177B2EBSub_B2EB
1178B2F7Sub_OnNonzero53
1179B304Sub_OnNonzero54
1180B3B4Sub_B3B4
1181B3C4Sub_OnNonzero55
1182B3C8Sub_OnNonzero56
1183B3DBSub_OnNonzero57
1184B3F6Sub_OnNonzero58
1185B3FASub_OnNonzero59
1186B40DSub_OnNonzero60
1187B419Sub_B419
1188B41FSub_OnNonzero61
1189B425Sub_Loop230
1190B426Sub_B426
1191B42CSub_B42C
1192B437Sub_Loop231
1193B438Sub_B438
1194B444Sub_OnNonzero62
1195B475Sub_Loop232
1196B476Sub_B476
1197B480Sub_B480
1198B482Sub_OnNonzero63
1199B48ESub_B48E
1200B49BSub_B49B
1201B49DSub_OnNonzero64
1202B4A3Sub_B4A3
1203B4A5Sub_OnNonzero65
1204B4ACSub_B4AC
1205B4B1Sub_OnNonzero66
1206B4B8Sub_B4B8
1207B4BCSub_B4BC
1208B4CBSub_OnNonzero67
1209B5D6Sub_B5D6
1210B5D8Sub_B5D8
1211B5DBSub_OnNonzero68
1212B5EESub_OnNonzero69
1213B5FFSub_B5FF
1214B605Sub_Loop233
1215B6B4Sub_B6B4
1216B6C0Sub_OnCarrySet6
1217B70ASub_B70A
1218B716Sub_Loop234
1219B766SubCB766
1220B767SubCB767
1221B76FSub_Loop235
1222B787Sub_Loop236
1223B793SubCB793
1224B796SubCB796
1225B7AFSub_Loop237
1226B7B2Sub_Loop238
1227B7BCSubCB7BC
1228B7C4SubCB7C4
1229B7C5SubCB7C5
1230B7CBSub_B7CB
1231B7D1Sub_B7D1
1232B7F1SubCB7F1
1233B7F4SubCB7F4
1234B7FCSub_Loop239
1235B80CSub_B80C
1236B81BSubCB81B
1237B829SubCB829
1238B834SubCB834
1239B843SubCB843
1240B854Sub_Loop240
1241B859Sub_Loop241
1242B85CSub_Loop242
1243B879SubCB879
1244B890Sub_Loop243
1245B891SubCB891
1246B899Sub_Loop244
1247B8A1SubCB8A1
1248B8A4SubCB8A4
1249B8ACSub_Loop245
1250B8B6SubCB8B6
1251B8EFSubCB8EF
1252B914SubCB914
1253B91ESubCB91E
1254B921SubCB921
1255B939Sub_Loop246
1256B93CSub_Loop247
1257C44ESub_C44E
1258C456Sub_Loop248
1259C463Sub_Loop249
1260C46BSub_OnNonzero70
1261C470Sub_C470
1262C483Sub_Loop250
1263C48BSub_Loop251
1264C48DSub_C48D
1265C49FSub_C49F
1266C4A9Sub_Loop252
1267C5D6SubCC5D6
1268C5EFSubCC5EF
1269C607Sub_C607
1270C61FSub_Loop253
1271C62DSub_C62D
1272C633Sub_Loop254
1273C634SubCC634
1274C63FSubCC63F
1275C64ASubCC64A
1276C655SubCC655
1277C65DSub_OnZero7
1278C663SubCC663
1279C68CSub_OnNonzero71
1280C696Sub_Loop255
1281C699SubCC699
1282C6B5SubCC6B5
1283C6C8SubCC6C8
1284C6CBSub_C6CB
1285C6D1Sub_OnNonzero72
1286C6E6Sub_Loop256
1287FE0ASub_FE0A
1288FE0CSub_OnNonnegative9
1289FE15Sub_FE15
1290FE2ASub_Loop257
1291FE40Sub_Loop258
1292FE45Sub_FE45
1293FE5CSub_FE5C
1294FE70Sub_OnZero8
1295FE77Sub_OnNonzero73
1296FE81Sub_Loop259
1297FFA0Sub_OnNonzero74