rg-dis release notes

0.10.14 — 2026-10-14

Adds control-flow C function analysis, user contract declarations, and cleaner caller argument and return annotations across Atari executables and object formats.

New features

• Control-flow C analysis: Traces register and stack values across basic blocks to annotate caller argument setup, call sites, and return values.
• Function contracts: Adds --c-contracts FILE and --c-abi MODEL to bind custom parameter names, directions ([out], [in/out]), and return locations across direct and indirect calls.
• Object and archive inspection: Extends C function discovery and annotations to ELF, DRI, GST, and a.out object files as well as ar archives.

Improvements

• Concise inline comments: Emits argument bindings directly on setup instructions, previews character constants, and condenses return comments while omitting redundant store annotations.
• Stricter basepage matching: Requires a known basepage seed or field offset ($80 command line or $2C environment pointer) before labeling address registers, preventing false positives on standard library structures.

0.10.13 — 2026-10-12

Adds raw binary input and output for DSP56001 programs. A headerless binary memory dump can now be disassembled, and one memory space of a DSP program can be written out as one.

New features

• Raw binary DSP input: Disassembles a headerless binary DSP memory dump with --arch dsp --input-format raw. --space selects the memory space (P, X or Y) and --org the address of the first word.
• Raw binary DSP output: Writes one memory space of a DSP program as a headerless binary dump with --output-format raw -o FILE, and prints the options needed to load it again.

Improvements

• Unrecognised DSP input: When no DSP format matches a file, the error now names the raw binary options (--arch dsp --input-format raw), not only the header parse failure.

0.10.12 — 2026-10-12

Adds dedicated CLI options to extract embedded DSP56001 microkernels, host transfers, and XBIOS blocks from Atari Falcon binaries into standalone assembly, binary, LOD, and P56 files.

New features

• Embedded DSP payload extraction: Automatically extracts all detected embedded DSP microkernels and host transfers to standalone files using --extract-dsp.
• Multi-format DSP export: Supports exporting extracted DSP programs as standalone Motorola DSP56001 assembly (--extract-dsp-asm), Motorola LOD text (--extract-dsp-lod), raw binary slices (--extract-dsp-bin), Brainstorm packed binary (--extract-dsp-p56), or across four formats simultaneously (--extract-dsp-all).
• Standalone DSP reassembly: Extracted assembly files include full origins, interrupt vector maps, hardware annotations, and coefficient constant directives, re-assembling word-exact with compatible Motorola DSP56001 assemblers.
• Motorola immediate force operators: Emits explicit > force size modifiers on 2-word long immediate moves and MOVEP writes, preventing external assemblers from auto-shortening instructions and preserving exact binary lengths.

0.10.11 — 2026-10-11

Expands Atari C compiler recognition across AHCC and Lattice C standard library archives, reconstructs function stack frames, and annotates switch jump table dispatchers and standard operating system structure offsets.

New features

• AHCC standard library signatures: Ingests relocation-masked signatures from standard runtime, operating system, and graphical interface library archives, annotating function entry points and formal parameters.
• Compiler startup preamble deduction: Recognizes AHCC and Lattice C startup preambles, deducing main entry points, resolving application execution flags, and labeling standard runtime basepage vectors.
• Stack frame reconstruction: Analyzes function stack frames to annotate total frame byte sizes, incoming stack arguments, stack local variables, saved frame pointers, and return addresses.
• Switch jump table dispatcher recognition: Detects indexed switch dispatch idioms, annotating case count and table addresses while labeling branch targets with semantic case labels.
• Operating system struct member annotations: Annotates standard struct member accesses on address registers across program basepage, file search buffer, graphical object tree, and memory form definition block structures.

0.10.10 — 2026-10-11

Adds library function signatures across standard Pure C library archives, identifies startup preambles, and annotates register-based parameter calling conventions and return values.

New features

• Pure C library recognition: Identifies library routines across standard runtime, operating system, floating-point, math helper, and graphical interface archives.
• Runtime startup detection: Recognizes standard and custom runtime startup preambles, deducing main entry points and labeling standard runtime basepage and system vectors.
• Call-site parameter tracing: Traces register-passed inputs and return value registers for recognized library calls, annotating expressions and arguments in disassembly comments.
• Graphical interface parameter block decoding: Decodes graphical system parameter blocks and operation codes for application environment services and virtual device interfaces.

0.10.9 — 2026-10-11

Expands standard library recognition to cover Lattice C runtime routines, and hardens embedded DSP detection against false positives on coordinate and data tables.

New features

• Lattice C library recognition: Identifies Lattice C runtime routines across 32-bit math helpers, memory allocators, string utilities, formatted I/O, and GEMDOS interfaces.

Bug fixes

• Embedded DSP microkernel validation: Validates internal header layout, non-overlapping section offsets, and instruction stream decodability before classifying embedded data as DSP microkernels, preventing coordinate tables and non-DSP data from being disassembled as DSP code.
• Text payload rejection: Rejects packed DSP candidate blocks whose contents consist predominantly of printable text, preventing command-line prompt strings from being misidentified as DSP programs.

0.10.8 — 2026-10-11

Adds smart labels for centralized OS system call dispatchers, expands standard library recognition for Megamax C runtime routines, and evaluates integer math expressions with decimal annotations.

New features

• Centralized trap dispatcher labeling: Detects centralized system call dispatchers that pop return addresses before OS traps, labeling subroutines as CALL_GEMDOS, CALL_BIOS, CALL_XBIOS, CALL_AES, and CALL_VDI and updating call sites throughout the disassembly.
• Megamax C library recognition: Identifies 54 Megamax C and Laser C runtime library routines across 32-bit math helpers, Line-A graphics routines, GEM AES helpers, string utilities, and file operations.

Improvements

• Evaluated math expression annotations: Calculates and displays evaluated 32-bit integer multiplication and division results in decimal directly in operand comments, detailing factor inputs and return registers.
• Streamlined runtime header comments: Identifies detected compiler runtimes once in the disassembly file header, suppressing repetitive per-function compiler tags and noisy local frame offset comments.

0.10.7 — 2026-10-10

Expands detection of embedded DSP payloads in Atari binaries performing direct hardware uploads, recovering additional transfer patterns and nested executable programs for disassembly.

New features

• Broader DSP upload detection: Detects additional direct host upload patterns in Atari binaries, including unpolled transfers and local loop counters.
• Nested executable DSP recovery: Recovers embedded DSP programs located inside nested Atari executables.

0.10.6 — 2026-10-10

Discovers and disassembles host DSP transfers in Atari executables, classifying embedded DSP code and data blocks while identifying candidate interrupt vector layouts. Emits Motorola DSP56001 assembly for bootstrap sequences and adds a listing-header DSP inventory.

New features

• Host DSP transfer discovery: Discovers headerless DSP program transfers sent by 680x0 host upload loops across expansion card and Falcon register interfaces, reporting static transfer spans and file ranges in inspection output.
• DSP control-flow classification: Traverses branch, call, return, and loop control flow within candidate DSP payloads to separate reachable instructions from unreached data words.
• DSP vector table recognition: Identifies candidate DSP interrupt vector layouts, emitting annotated vector instructions for active slots and NOP padding for unused handlers with an explicit origin banner.
• Listing header DSP inventory: Displays an inventory of recognized DSP programs, candidates, and total stored bytes in the disassembly listing header.

Improvements

• Smart DSP vector labels: Generates descriptive handler labels for interrupt vectors and host commands, using per-payload suffixes to prevent symbol collisions when multiple DSP programs appear in the same binary.
• Formatted listing metrics: Formats decimal sizes and instruction counts with thousands separators in 680x0 listing headers.

Bug fixes

• Peripheral MOVEP reassembly: Preserves short source endpoints with an explicit size hint in peripheral-to-peripheral register transfers, preventing operand swap ambiguities on reassembly.

0.10.5 — 2026-10-10

Reconstructs high-level BASIC syntax on direct GFA-BASIC runtime calls, exposes structured GFA metadata in JSON disassembly output, and prevents short branches from being demoted across functions preceded by padding words.

New features

• Direct GFA-BASIC call reconstruction: Reconstructs high-level BASIC command syntax and backward-traces parameter registers on direct runtime calls, annotating expressions directly in the assembly listing.
• Structured GFA-BASIC JSON records: Emits typed gfa_library, gfa_call, and gfa_arg records in JSON disassembly output, detailing ABI variants, resolved function targets, and parameter types.
• Routine discovery for stripped binaries: Discovers routine extents from text labels under --inspect functions and the JSON functions array on executables lacking DRI symbol tables.

Improvements

• A6 dispatch map corroboration: Corroborates A6 displacement dispatch table names against resolved code targets, avoiding misattributions and scoping dispatch probes to valid code regions.
• Return register consumer tracking: Annotates forward instruction consumers of GFA-BASIC runtime return registers within straight-line blocks.

Bug fixes

• Forced symbol boundary clamping: Treats valid text symbols and user labels as forced instruction boundaries during initial scan passes. Prevents function entry points preceded by null padding from being swallowed into immediate instructions, avoiding instruction desynchronization and preserving conditional branches without raw word demotions.

0.10.4 — 2026-10-08

Improves parameter detection for embedded DSP microkernels and refines entry-point labeling in Motorola DSP56001 disassembly.

Improvements

• Embedded DSP parameter scanning: Accurately tracks address registers staged before system calls when locating embedded DSP microkernels.
• Entry point labeling: Correctly emits custom entry labels when disassembling Motorola DSP56001 programs with non-zero start addresses.

0.10.3 — 2026-10-07

Inherits annotation and formatting options for embedded DSP blocks in heterogeneous executables.

Improvements

• Embedded DSP annotations: Embedded DSP code blocks within heterogeneous Atari executables now inherit command-line annotation options (--annotate-cycles, --annotate-hw), providing consistent cycle timing and hardware register annotations across both 680x0 and DSP code streams.
• DO loop comment alignment: Preserves column 60 comment alignment on DO loop termination labels.

0.10.2 — 2026-10-07

Adds cycle timing and program offset annotations for Motorola DSP56001 disassembly, preserving byte-exact reassembly across tested binaries.

New features

• DSP cycle annotations: Annotates execution cycles for DSP instructions under --annotate-cycles, aligning cycle totals in comments across single-word and two-word instructions.
• DSP offset annotations: Prints program memory addresses as comments under --annotate-offsets.
• Top header comment: Emits a header naming the input filename and memory space word counts across P, X, and Y spaces.

Bug fixes

• Short memory addressing: Preserves short memory address prefixes (<) in control register transfers (MOVEC), preventing one-word instructions from widening to two words on reassembly.
• 24-bit control register immediates: Preserves full 24-bit immediate values in control register transfers.
• Normalization opcode encoding: Encodes DSP56001 NORM instructions matching the canonical processor opcode.

0.10.1 — 2026-10-07

Adds semantic hardware register and interrupt vector annotations for Motorola DSP56001 disassembly, annotating on-chip peripheral I/O and interrupt vectors alongside existing 68000 hardware annotations.

New features

• DSP hardware register annotations: Annotates memory-mapped DSP peripheral registers ($FFC0..$FFFF) and control bitfields across Host Interface, Serial Communication Interface, and Synchronous Serial Interface accesses.
• DSP interrupt vector naming: Annotates interrupt vectors in program memory ($0000..$003F) with descriptive vector labels, including host command vectors.
• Structured DSP annotations: Emits typed annotation records in JSON output when disassembling DSP binaries.

0.10.0 — 2026-10-05

Adds Motorola DSP56001 disassembly to rg-dis, providing a single unified disassembler for both 680x0 and DSP binaries across the Atari ecosystem.

New features

• DSP56001 disassembly: Disassembles Motorola DSP56001 programs with memory space segmentation (P, X, Y), parallel ALU move decoding, hardware DO loops, and bit-manipulation instructions.
• Multi-format DSP loading: Automatically detects and loads DSP binaries in .p56, .lod, and .out formats, as well as cooked DSP object blocks.
• Embedded DSP detection: Scans Falcon executables for embedded DSP programs via --inspect embedded-dsp, extracting code and data block boundaries.
• Architecture selection: Adds --arch with options for auto, 68k, and dsp, alongside --dialect motorola and --dialect a56 for DSP syntax targeting.

0.9.43 — 2026-10-05

Adds support for non-standard floppy disk images and fixes crashes when inspecting damaged disk headers.

Bug fixes

• Non-standard floppy disk images: Disk images formatted with custom track counts or sector layouts now open reliably by reading the layout directly from the boot sector.
• Damaged disk headers: Disks with invalid or corrupted directory headers no longer crash the inspector, gracefully falling back to standard disk layouts when readable.

0.9.42 — 2026-10-04

Listings of compiled GFA-BASIC programs are easier to follow: runtime calls now show where they go, and data hiding behind those calls displays as data.

New features

• Followable runtime calls: Calls and jumps into the GFA-BASIC runtime now name the destination label wherever the target is verified code, instead of a bare address — including routines entered partway through shared code.
• Data behind the call: Length words and strings tucked after a runtime call now list as data instead of stray instructions, and the call names the label where execution continues.

0.9.41 — 2026-10-04

Vetoes phantom string heuristics across bounded instruction sequences, and anchors ASCII-shaped branch displacements to loader fixups.

Bug fixes

• Phantom string heuristic veto: Rejects spurious C-string classifications across bounded code runs when execution flows past the region boundary, preventing valid branch sequences from being demoted to data blobs.
• Reloc-anchored branch classification: Preserves short branches with ASCII-like displacement bytes as executable code when anchored by nearby loader fixups holding visited routine addresses.
• Basepage preamble commentary: Harmonizes Mshrink sizing and parameter comments in startup preamble analysis with standard GEMDOS ABI terminology.

0.9.40 — 2026-10-03

Prevents valid short branch instructions from being incorrectly demoted to raw data words.

Bug fixes

• Short branch demotion: Prevents short branch instructions whose bytes resemble string terminators from being demoted to data words, preserving continuous instruction disassembly.

0.9.39 — 2026-10-03

Synthesizes instruction-start labels for code branches and subroutine calls, eliminating self-relative branch expressions and anchoring mid-instruction references to instruction boundaries.

Improvements

• Synthesized code labels: Replaces self-relative branch expressions with synthesized instruction-start labels (_Lxxxxxx), preserving transparent control flow and clean re-assembly across all supported dialects.
• Instruction-anchored SMC offsets: Formats mid-instruction modifications as _Lxxxxxx+N, ensuring multi-word instructions stay intact rather than splitting into raw data words.
• String label veto: Prevents branch and subroutine call targets from resolving against string literals.

0.9.38 — 2026-10-03

Prevents false-positive GFA-BASIC runtime commentary on ordinary binaries, and adds statistical code-likelihood classification for ambiguous regions.

Bug fixes

• GFA-BASIC runtime detection: Restricts anonymous runtime calls to emitted instructions, removing spurious commentary from non-GFA binaries while preserving recognition across compiled GFA-BASIC programs.

Improvements

• Code-likelihood rescue: Data regions whose words statistically resemble valid instructions are marked unknown rather than data.

0.9.37 — 2026-10-03

Adds address-level classification explanation and rule logging in the regions view.

Improvements

• --explain <addr> prints why an address was classified as code, data, or string.
• --record-decisions populates the rule column in --inspect regions.

0.9.36 — 2026-10-03

Unifies code and data checks into an ordered vote table with documented priority.

Improvements

• Overlapping data checks resolve through a deterministic vote order.

0.9.35 — 2026-10-02

Consolidates the character mapping; disassembly output is unchanged.

Maintenance

• Shared Atari ST charset: Unifies character mapping across the toolchain so extracted string glyphs remain consistent.

0.9.34 — 2026-10-02

Adds automatic startup basepage and Mshrink annotations, and fixes subroutine target label resolution near strings.

New features

• Startup basepage annotation: Automatically detects TOS startup preambles, annotating basepage fields, Mshrink ($4A) sizing, stack reservations, and buffers. Disable with --no-annotate-basepage.

Bug fixes

• Subroutine label resolution: Ensures call targets prefer exact routine labels rather than resolving as offsets into preceding string literals.

0.9.33 — 2026-10-02

Prevents parameter block smart labels from misidentifying executable code instructions following zero-padding or entry preambles.

Bug fixes

• Parameter block validation: Rejects parameter block smart labels that overlap executable code instructions or fall-through execution streams, preserving clean instruction disassembly.

0.9.32 — 2026-10-01

Adds Devpac and vasm program header flags, improves raw binary data detection, and clarifies output dialect options.

New features

• Program header flags: Emits Fastload, TTRAM_RUN, and TTRAM_Malloc definitions and COMMENT HEAD=... header directives for TOS executables under Devpac and vasm dialects.

Bug fixes

• Raw binary data detection: Prevents PC-relative data tables in raw binary images from being mis-decoded as instructions after routine endings.
• CLI dialect guidance: Clarifies that --dialect vasm must be passed for Motorola vasm reassembly.

0.9.31 — 2026-10-01

Adds vasm Motorola dialect export directives, clean byte immediate masking, backward branch target preservation, and pointer table extent fixes.

Bug fixes

• vasm dialect Motorola directives: Emits Motorola-syntax section directives (SECTION TEXT, SECTION DATA, SECTION BSS), XDEF symbol declarations, and OPT P=68000 header when outputting vasm dialect assembly.
• vasm byte immediate masking: Fixes masking 8-bit byte immediates.
• Backward branch target preservation: Protects backward branch targets (BRA.W targets) from being subsumed by preceding data blobs.
• Pointer table relocation field runs: Preserves continuous 32-bit relocation field arrays as data longwords (dc.l).

0.9.30 — 2026-09-30

Adds GFA-BASIC 2.x header probing and runtime preamble recognition.

New features

• GFA-BASIC 2.x runtime header recognition: Detects compiler header validation magic and Run-Only preamble strings, ensuring GFA-BASIC 2.x executables qualify for runtime annotations.

0.9.29 — 2026-09-30

Decodes unlabelled short branches as self-relative instructions rather than raw data words.

Bug fixes

• Unlabelled short branch decoding: Decodes short branch instructions whose targets lack resolvable labels using self-relative target expressions (*+rel), preserving routine contiguity while maintaining re-assemblable output.

0.9.28 — 2026-09-30

Prunes redundant GFA-BASIC operand annotations.

Improvements

• GFA-BASIC commentary precision: Restricts GFA-BASIC annotation comments to named workspace vectors, procedure descriptions, and system register roles, removing redundant commentary that merely restated operand displacements.

0.9.27 — 2026-09-29

Stops GFA-BASIC runtime annotations bleeding onto Pure C binaries.

Bug fixes

• GFA-BASIC runtime detection: Restricts anonymous GFA runtime qualification to verified dispatch patterns or library signatures, removing false-positive GFA-BASIC commentary from Pure C binaries using A4/A6 registers while preserving recognition across compiled GFA-BASIC binaries.

0.9.26 — 2026-09-29

Adds multi-version GFA-BASIC runtime recognition, routine parameter descriptions, and documented command form annotations. Expands routine signature coverage across all major GFA-BASIC 3.x release libraries and identifies exact compiler runtime versions on disassembly headers.

New features

• Multi-version GFA-BASIC runtime identification: Detects compiled GFA-BASIC runtime library versions (3.50, 3.50F, 3.60, 3.6DE, 3.6TTB) and reports the identified runtime version and signature match count in listing preambles.
• Curated GFA-BASIC routine descriptions: Annotates runtime subroutine calls with distinct per-routine descriptions for graphics, math, string, array, sound, disk, and GEM VDI/AES operations.
• Documented GFA-BASIC command syntax: Displays canonical command syntax from the GFA-BASIC interpreter manual (e.g. COLOR C, EXEC flg,name,cmd,env) at recognized runtime call sites.

Improvements

• Probed GFA-BASIC ABI dispatch: Gates A6 runtime call and jump annotations on verified GFA dispatch initialization sequences, resolving unnamed indirect runtime dispatches to target image addresses while preventing false-positive annotations on standard C frame pointers.
• Expanded GFA-BASIC signature bank: Extends runtime routine coverage across all signature patterns extracted across all vendored GFA-BASIC 3.x release libraries.
• Clean routine commentary: Emits routine descriptions without raw library module filenames on call commentary lines.

Bug fixes

• GFA-BASIC tail-call jumps: Recognizes indirect jumps through A6 (JMP -d(A6)) as runtime dispatches rather than local stack frame accesses.
• A4 vector lookup bounds: Prevents small negative A4 displacements from matching unassociated A6 routine definitions.

0.9.25 — 2026-09-29

Fixes mid-routine instruction demotions around odd region starts and relocated absolute calls.

Bug fixes

• Short branches demoted mid-routine: Prevents odd byte boundaries at region starts from causing valid short branches to demote to raw data words.
• Relocated absolute calls: Resolves relocation-targeted absolute calls as instructions when splitting label regions.

0.9.24 — 2026-09-29

Stops GFA-BASIC commentary appearing on binaries without a GFA-BASIC runtime.

Bug fixes

• GFA-BASIC runtime detection: Restricts GFA-BASIC annotation triggers to explicit GFA runtime dispatches and signatures, preventing false-positive GFA comments on standard C function-pointer calls.

0.9.23 — 2026-09-28

Adds user-defined code and data regions, and fixes pointer-read table classification.

New features

• User-defined code/data sections (--regions, --region-code, --region-data): Overrides automatic code/data classification for specified guest address ranges (<START>:<END>) on raw images and TOS/PRG executables.

Bug fixes

• Pointer-read tables with an unlabelled skip target: Tables read via pointer indexed loading are classified as data even when the skipping branch targets an unlabelled address.

0.9.22 — 2026-09-28

Fixes PC-relative operand formatting for assembler compatibility.

Bug fixes

• PC-relative operands: Formats d16(PC) and d8(PC,Xn) operands as target addresses (*+N / *-N) instead of bare displacements, avoiding syntax errors under Devpac 2 and related assemblers.

0.9.21 — 2026-09-28

Classifies pointer-read data tables as data.

Improvements

• Pointer-read tables: Constant tables accessed via PC-indexed operands (d(PC,Dn.W)) or LEA pointers are classified as data directives rather than instructions, even without a skipping branch.

0.9.20 — 2026-09-28

Improves code and data classification for unstripped binaries.

Improvements

• Digit-only strings: Recognises numeric string constants (e.g. "68010") as data instead of decoding them as instructions.
• Branch-skipped data tables: Classifies unlabelled, zero-filled, or partially-labelled constant tables behind forward BRA instructions as data.

0.9.19 — 2026-09-28

Fixes value handling for user-defined equates.

Bug fixes

• User-defined equate constants: Treats --equate values as absolute constants rather than image-relative offsets.

0.9.18 — 2026-09-27

Adds user-defined labels and equates, region classification inspection, and option validation.

New features

• User-defined labels (--label, --labels): Supports custom address labels and label renames via inline arguments (--label LOCATION=NAME) or TSV files.
• User-defined equates (--equate, --equates): Defines constant symbol values via inline arguments (--equate NAME=VALUE) or TSV files.

Improvements

• Region classification inspection (--inspect regions): Reports code, data, string, and BSS segment ranges in table or JSON format.

Bug fixes

• Option validation: Refuses raw-only options (--org, --offset, --len) on container listings, and --sym on disk images or container members.
• Data runs after forward branches: Prevents non-code data words between BRA.S and its branch target from decoding as instructions.

0.9.17 — 2026-09-26

Improves instruction cycle annotations for 68020–68060.

Improvements

• Cycle annotations: Shows instruction cycle costs for 68020–68060 targets under --annotate-cycles.

0.9.16 — 2026-09-26

Devpac indexed addressing compatibility, tab-delimited formatting, and multi-line string recognition.

Improvements

• Devpac indexed addressing compatibility: Emits explicit .w size suffixes on word index registers for (d8,An,Xn.w) and (d8,PC,Xn.w) addressing modes.
• Tab-delimited formatting (--tabs): Uses single tab characters (\t) for directive and equate formatting to reduce listing file sizes.
• Multi-line string recognition: Identifies string spans containing internal newlines, tabs, and escape sequences as data string directives.

0.9.15 — 2026-09-26

Adds instruction cycle annotations for additional 680x0 CPU variants.

Improvements

• Per-variant cycle annotations: Adds 68010, 68020, 68040, and 68060 cycle lookup tables to --annotate-cycles.

0.9.14 — 2026-09-26

Improves alignment padding detection and string table boundaries.

Improvements

• Subroutine alignment padding: Identifies NOP and zero alignment padding following RTS instructions as data padding.
• String table boundaries: Prevents instruction classification from resuming inside multi-entry string tables.

0.9.13 — 2026-09-26

Fixes 68040 cache instruction decoding length.

Bug fixes

• 68040 cache instruction length: Fixed instruction length for 68040 cache operations (cpusha, cinva, etc.) to 2 bytes.

0.9.12 — 2026-09-26

Improves GFA-BASIC floating-point decoding and argument annotations.

Improvements

• GFA-BASIC 48-bit floating-point decoding: Decodes 6-byte floating-point values into decimal representation for loop bounds and float arguments.
• Parameter tracing and annotations: Annotates GFA runtime calls with parameter descriptions and decimal values for graphic coordinates, delays, and allocation sizes.
• GFA runtime descriptions: Expands routine descriptions across AES/VDI helpers, string operations, disk I/O, and sound routines.

Bug fixes

• Argument register tracking: Excludes comparison and test instructions from register tracking during argument resolution.

0.9.11 — 2026-09-25

Preserves multiple annotations on individual instructions.

Bug fixes

• Multiple instruction annotations: Preserves and joins annotations when multiple note categories apply to the same instruction line.

0.9.10 — 2026-09-25

Relocation-seeded code discovery, dialect byte immediate formatting, and expanded GFA-BASIC runtime definitions.

Improvements

• Relocation entries seed code discovery: Uses pointer targets from executable relocation tables as code entry points during disassembly traversal.
• Byte immediate formatting across dialects: Formats byte-sized immediate operands within valid range limits for target dialects.
• GFA-BASIC runtime dictionary: Expands named runtime routine coverage for GFA-BASIC binaries.

0.9.9 — 2026-09-24

Devpac immediate formatting, Line-A operand syntax, and ELF formatting flags.

Improvements

• Devpac byte immediate formatting: Formats byte-sized immediate operands as 8-bit values under --dialect devpac.
• Line-A operand formatting: Formats Line-A opcode vectors without # prefixes across target dialects.
• ELF text disassembly formatting: Propagates --dialect, --lower, --sp, and --no-abs-parens formatting flags to ELF disassembly.

0.9.8 — 2026-09-24

GFA-BASIC vector routine naming, workspace member dictionaries, and indirect jump target resolution.

Improvements

• GFA-BASIC vector routine names: Maps negative A6 dispatch offsets (JSR -disp(A6)) to named GFA runtime routines.
• GFA workspace field dictionary: Decodes d(A4) workspace accesses with named GFA data fields (sys_base, vdi_handle, mouse_x, etc.).
• Indirect jump target resolution: Traces register initialization prior to JMP (An) and JMP d(An) calls to resolve branch targets.

0.9.7 — 2026-09-24

GFA-BASIC vector annotations, variable and frame naming, and indirect call tracing.

Improvements

• GFA-BASIC vector annotations: Names GFA runtime library calls (A6) and workspace vectors (A4).
• GFA variable and stack frame naming: Reconstructs typed global variable names for d(A5) accesses and distinguishes stack arguments from local variables for d(A6) frames.
• Indirect call register tracing: Traces register loading prior to JSR (An) and JSR d(An) calls to annotate call targets.

0.9.6 — 2026-09-24

Devpac directive syntax formatting and instruction branch table recovery.

Improvements

• Instruction branch tables: Decodes inline BRA.S and BRA.W arrays following JMP d(PC,Dn) dispatches as instruction targets rather than data bytes.

Bug fixes

• Devpac directive formatting (--dialect devpac): Omits leading dots on data and BSS directives (dc.b, dc.l, ds.b) for Devpac syntax compatibility.

0.9.5 — 2026-09-23

Branch table detection and indexed PC-relative switch table resolution.

Improvements

• Instruction branch table detection: Identifies scaled register index JMP d(PC,Dn) dispatches to prevent instruction words from being parsed as jump table offsets.
• Indexed PC-relative switch tables: Resolves displacements for MOVE.W d(PC,D1),D0 + ADD.W D1,D0 + JMP 2(PC,D0) switch idioms to label jump targets.

0.9.4 — 2026-09-23

Decodes short conditional branches and absolute subroutine calls.

Improvements

• Short conditional branch decoding (Bcc.S): Decodes symbolic Bcc.S branch instructions across all 16 condition codes.
• Absolute subroutine calls (JSR): Decodes JSR instructions with symbolic target labels in mixed code regions.
• Relocation-seeded code entries: Uses relocation targets to seed code classification for function pointer tables.

0.9.3 — 2026-09-23

MOVEM post-increment decoding, Devpac header options, and GFA annotation precision.

Improvements

• MOVEM post-increment decoding: Decodes single and double register stack restores as symbolic MOVEM.L (A7)+,regs instructions.

Bug fixes

• Devpac 1 and 2 header directives: Omits unsupported OPT P= and OPT F= CPU directives for devpac1 and devpac2 export dialects.
• GFA data pattern filtering: Restricts library function pattern matching to valid instruction boundaries to avoid false-positive annotations on data tables.

0.9.2 — 2026-09-23

Default GFA-BASIC runtime recognition and library signature precision.

New features

• GFA-BASIC annotation control (--annotate-gfa, --no-annotate-gfa): Enables GFA-BASIC runtime routine recognition by default (disable with --no-annotate-gfa).

Bug fixes

• Library signature precision: Restricts subroutine signature matching to code instruction boundaries to avoid false positives in data tables.

0.9.1 — 2026-09-23

Adds assembler export dialects (--dialect) and fixes decoder regressions.

New features

• Assembler export dialects (--dialect): Formats output source for 23 assembler dialects (devpac, purec, gas, rmac, madmac, etc.), adjusting directives, labels, CPU options, and alignment syntax per dialect family.

Bug fixes

• Sign-extended byte immediates: Corrects decoding for sign-extended byte immediate operands.
• UNLK before RTS epilogues: Classifies UNLK An epilogue instructions preceding labelled RTS targets as code.

0.9.0 — 2026-09-23

GFA-BASIC runtime routine recognition and parameter tracing.

New features

• GFA-BASIC version support: Identifies runtime signatures across GFA-BASIC v2.02, v3.02, v3.50, v3.60, and v3.6TT compiled executables.
• GFA-BASIC runtime library dictionary: Recognizes 1,187 GFA-BASIC runtime routines across graphics, math, sound, memory, and VDI/AES helpers.
• GFA calling convention annotations: Traces register parameter setup (A4, A5, A6, D0–D3) at GFA runtime call sites.
• GFA annotation flag: Added --annotate-gfa option (aliased to --annotate-stdlib).

0.8.2 — 2026-09-23

Standard C library signature recognition and parameter typing.

New features

• Compiler library recognition: Identifies over 1,000 standard library routines across Pure C, VBCC, AHCC, Lattice C, Sozobon, Alcyon, Megamax, Mark Williams, and Mintlib.
• VBCC library coverage: Identifies functions across VBCC standard and math libraries (libvc.a, libm.a, etc.).
• Prefix signature indexing: Uses opcode prefix indexing for fast signature lookups during disassembly.

Improvements

• Calling convention argument typing: Binds parameter descriptors at call sites for Pure C, VBCC fastcall, Lattice regargs, math helper, and cdecl conventions.

0.8.1 — 2026-09-22

Standard library attribution, fastcall argument tracing, and expanded VBCC coverage.

Bug fixes

• Signature attribution priority: Prioritizes bytecode pattern matching over symbol table lookups for compiler attribution.
• AHCC signature masks: Corrects AHCC signature masks to prevent false fastcall tagging.

Improvements

• Fastcall argument tracing: Traces register arguments (A0, A1, D0) for @-prefixed fastcall routines.
• Expanded VBCC signatures: Adds signature coverage for common VBCC memory, string, and formatting routines.
• Function header comments: Emits descriptive comments on recognized function definition labels.

0.8.0 — 2026-09-22

Adds standard C library function recognition and call-site argument tracing (--annotate-stdlib).

New features

• Standard library identification: Automatically identifies and labels standard C functions, runtime arithmetic helpers, and OS wrappers across Atari C compilers under --annotate-stdlib.
• Call-site argument tracing: Annotates function parameters at call sites (BSR/JSR) across cdecl, fastcall, and math intrinsic calling conventions.
• Library function commentary: Labels recognized library functions with canonical names and descriptive comments.

0.7.12 — 2026-09-22

Fixes floppy disk disassembly across sector boundaries and unifies disk selections into a single continuous address space with sector boundary markers.

Bug fixes

• Branches across sector boundaries: Branches and jumps spanning sector boundaries now resolve cleanly to target labels instead of falling back to raw data words.
• Cross-sector instructions: Multi-byte instructions crossing sector boundaries decode cohesively across the boundary.

New features

• Sector boundary markers: Emits track/side/sector labels or equates at each sector boundary for easy referencing in multi-sector and full-disk disassemblies.
• Byte window support for disks: --offset and --len slice selections accurately within disk images, and --annotate-offsets stamps addresses across disk listings.

Improvements

• Repeated byte collapsing: Long sequences of identical filler or padding bytes collapse into compact .ds.b or .dcb.b directives.

0.7.11 — 2026-09-21

Expands smart string labeling to PC-relative text and data targets, binds dual-word trap arguments on single long instructions, and refines variable load and disk disassembly formatting.

Improvements

• Smart string labels on PC-relative data: Automatically labels string references (including PC-relative references in text and data) as descriptive STR_* symbols derived up to CR/LF delimiters with non-label characters converted to underscores.
• Dual-word trap argument binding: Single long instructions (CLR.L -(A7) or MOVE.L -(A7)) that supply two adjacent 16-bit word arguments in TOS and XBIOS trap frames now bind and annotate both arguments on the instruction line.
• Clean address load annotations: LEA and PEA address calculations on system variables and hardware registers now display the variable name and description without an inaccurate "read" verb.
• Formatted disk preambles: Disk sector disassembly headers now format sector counts and byte sizes with thousands separators and omit redundant origin addresses.

0.7.10 — 2026-09-21

Fixes string truncation caused by false opcode detection in data blocks, and polishes --lower label casing and --tabs comment alignment.

Bug fixes

• Reachable instruction anchor validation: Validates code reachability before creating PC-relative instruction anchors, preventing false opcode matches in data tables from truncating string literals.
• Lowercase labels with --lower: Ensures auto-generated and synthetic label identifiers in definitions and operand expressions follow the requested lowercase casing.
• Tab-stop comment alignment with --tabs: End-of-line annotations now calculate column width across tab stops and use tab characters for clean alignment.

0.7.9 — 2026-09-21

Improves multi-line ASCII string formatting, adds formatting customization flags, and fixes floppy disk and raw disassembly edge cases.

Improvements

• Multi-line and CRLF string detection: Disassembles multi-line ASCII menus and messages with CRLF/LF line endings into cohesive quoted strings.
• Exact PC-relative displacement labels: References into unvisited tables or data structures now receive exact target labels instead of relative offsets from preceding instructions.
• Floppy sector disassembly: Disassembles executable code and structured data across all selected floppy sectors with --disk.
• Formatting options: Adds --no-abs-parens to omit parentheses on absolute addresses, --case lower/--lower for lowercase output, --sp for SP register alias, and --tabs for tab indentation and column separation.

Bug fixes

• Raw --org base calculation: Explicit --org sets the exact assembly base address when slicing files with --offset.
• Absolute short addressing: Low-RAM system variable references remain absolute short operands without generating unnecessary local labels.
• Multi-sector disk label scoping: Multi-sector --disk disassemblies now scope labels across the full image to prevent duplicate label definitions across sectors.

0.7.8 — 2026-09-20

Moves the semantic annotation engine into a shared library. Listing output and re-assembly behavior remain identical.

Improvements

• Shared hardware and OS annotations: Moves semantic annotation tables (hardware registers, OS traps, and AES/VDI calls) into one shared set, so every tool names them the same way.

Compatibility

• Preserved output fidelity: Disassembly output, annotation comments, JSON schema, and round-trip reassembly remain unchanged across our test suite.

0.7.7 — 2026-09-20

Wraps long string and data directives across multiple lines to respect standard line length limits.

Improvements

• Long string line wrapping: Breaks long strings and mixed data directives across multiple dc.b / .dc.b lines keeping lines within the standard 80-column budget while preserving exact address offset stamping for each line.

0.7.6 — 2026-09-20

Cleans up listing headers and improves branch and relocation label resolution in mixed code and data sections.

Improvements

• Cleaner listing headers: Removes internal CPU scope comments from disassembly output.

Bug fixes

• Label and relocation resolution: Improves branch target and rebased relocation matching so labels in mixed code and data regions resolve accurately for round-trip reassembly.

0.7.5 — 2026-09-20

Emits un-encodable destination addressing modes and byte-sized address register tests as raw data words to ensure clean round-trip reassembly.

Bug fixes

• Un-encodable destination addressing modes: Emits instructions using PC-relative destination operands as raw dc.w data words instead of invalid mnemonics.
• Byte address register tests: Emits TST.B with address register operands as raw data words, as the architecture only supports word and long sizes for this form.

0.7.4 — 2026-09-20

Emits reserved and un-encodable effective address forms as raw data words so listings re-assemble cleanly without assembler warnings.

Bug fixes

• Reserved effective address encodings: Emits invalid operand combinations (such as invalid predecrement destinations or non-encodable register operations) as raw dc.w words so listings assemble without errors.

0.7.3 — 2026-09-19

Streamlines string inspection with string-first table formatting and updates listing documentation.

Improvements

• String-first inspection tables (--inspect strings): Places extracted string content in the primary column of terminal tables and keeps metadata compact.
• Unified string table formatting: Standardizes string inspection output across executables, object files, raw binary buffers, and floppy disk images.

0.7.2 — 2026-09-18

Adds directory timestamps and attributes to disk inspection, fixes multi-word offset annotations, and improves annotation flag composition.

Improvements

• File metadata in directory listings (--inspect disk): Adds last-written dates, DOS attribute flags (read-only, hidden, system, archive, directory, volume label), and attribute legends to directory tables.
• Filesystem volume date span: Reports the earliest and latest directory write timestamps in the filesystem summary, and exposes them under --json as volume.file_dates.
• Nominal media descriptor reporting: Labels legacy boot sector media descriptor codes as nominal descriptions, avoiding contradictions with actual measured disk geometry.

Bug fixes

• Multi-word raw instruction address annotations (--annotate-offsets): Stamped addresses on every word line when multi-word instructions fall back to split raw dc.w representations.
• Annotation flag composition: Allows combining --annotate with specific --no-annotate-<family> flags to selectively disable individual annotation categories.

0.7.1 — 2026-09-18

Enforces 16-bit word alignment on code entry points and unreachable segment traversals.

Bug fixes

• Word alignment in code start heuristics: Rejects odd byte addresses during code entry validation and unreachable region walks to preserve 16-bit 68000 alignment invariants.

0.7.0 — 2026-09-17

Adds per-line memory address annotations for disassembly listings and structured table formatting for disk inspection reports.

New features

• Per-line memory addresses (--annotate-offsets): Annotates instruction and data lines with their loaded memory addresses at a uniform column width (included in --annotate and --json). When combined with --annotate-cycles, the address column is rendered alongside execution timings.

Improvements

• Structured disk inspection tables (--inspect disk): Formats geometry, allocation, directory listings, container members, and filesystem defect summaries into aligned boxed tables.
• Floppy media descriptor reporting: Reports the boot sector media descriptor byte as its corresponding 3.5-inch disk format.

0.6.27 — 2026-09-17

Adds floppy disk inspection without disassembly, fixes MOVEM and trap call comment fidelity, and clarifies round-trip reassembly verification documentation.

New features

• Floppy disk inspection (--inspect disk): Reports disk geometry, boot sector metadata, filesystem layout, space usage, volume labels, and recursive directory trees directly from metadata without disassembling.
• Executable detection and unreadable disk handling: Identifies GEMDOS executables within disk file listings and reports invalid sector geometry errors instead of attempting raw disassembly.

Bug fixes

• Single-register MOVEM stores: Emits single-register stack stores as valid MOVEM instructions rather than raw data words.
• Call-site trap annotation filtering: Annotates subroutine calls (JSR/BSR) with TOS trap names only when the target is a dedicated wrapper subroutine.

Documentation

• Round-trip reassembly documentation: Clarifies documentation and web copy to specify that round-trip fidelity verifies byte-identical code and data reassembly rather than symbol table reproduction.

0.6.26 — 2026-09-17

Fixes undefined symbol emissions when resolving displaced absolute operands in disassembly listings.

Bug fixes

• Displaced absolute operand name resolution: Strips displacement offsets when checking symbol definitions for operands such as (NAME+4).L, preventing undefined labels from being emitted.
• Unified operand symbol scanning: Unifies base symbol extraction across undefined-symbol and collision scanners by splitting bracketed operands at displacement operators.

0.6.25 — 2026-09-17

Extends undefined symbol elimination to word-sized absolute addressing modes.

Bug fixes

• Word-sized absolute operand validation: Checks word-sized absolute operands ((NAME).W) against defined symbols to prevent emitting undefined labels.
• Operand suffix matching: Updates the scanner to recognise both .W and .L absolute operand suffixes.

0.6.24 — 2026-09-17

Prevents undefined symbols from being emitted for absolute operands pointing into unlabelled data regions.

Bug fixes

• Undefined absolute symbol suppression: Emits raw numeric addresses instead of unlabelled .text symbols for absolute operands, preventing reassembly failures.
• Symbol emission pass consistency: Aligns absolute operand label verification with branch target and PC-relative label checks in Pass 2.

0.6.23 — 2026-09-17

Ensures disassembled listings define all referenced labels, improves relocation immediate formatting, and clarifies CPU directive scope.

Bug fixes

• Referenced label emission: Emits all referenced symbol table code targets as labels to ensure disassembled source links cleanly.
• Relocated immediate instruction decoding: Renders long immediate instructions bearing relocations as valid instructions instead of raw data words.
• Illegal instruction demotion: Demotes invalid address-register operand encodings to data directives.
• Mid-word code region alignment: Handles odd-byte boundaries at code region ends as raw data bytes to prevent label skipping.

Improvements

• CPU directive scope comments: Adds preamble comments clarifying when listing .cpu/.fpu directives cover all emitted code regions while --inspect cpu reports reachable code only.

0.6.22 — 2026-09-17

Filters opcode false positives from string inspection, synchronises summary string counts, and fixes UTF-8 console output on Windows.

Improvements

• Opcode filtering in string inspection: Excludes decoded instruction regions from --inspect strings by default to suppress false positives (configurable via --strings-include-code).
• String count synchronisation: Aligns total string counts in bare --inspect summaries with --inspect strings table output.
• Windows console UTF-8 support: Ensures banners and diagnostic notes render correctly on Windows consoles without character encoding errors.

0.6.21 — 2026-09-16

Improves reassembly fidelity for branch targets in data sections and handles unsupported FMOVEM register masks.

Bug fixes

• Branch targets in data sections: Emits branch targets as labels only when defined within the listing, preserving round-trip reassembly for mixed code and data across our test suite.
• FMOVEM dynamic register masks: Emits raw data words for FMOVEM register masks that cannot be expressed with standard register list syntax.

0.6.20 — 2026-09-16

Improves CPU inspection output and updates documentation for round-trip testing and container inspection.

Improvements

• CPU inspection summary details: Reports the minimum required CPU and FPU alongside the analysed .text byte count in --inspect cpu.
• Round-trip fidelity documentation: Updates documentation to clarify the scope of verified round-trip reassembly across our test suite.
• Container inspection documentation: Documents container member listing options in --help and manual pages.

0.6.19 — 2026-09-16

Automatically routes floppy disk images to the disk inspection pipeline and improves disassembly performance for large binaries.

New features

• Automatic floppy image detection: Automatically routes .ST, .MSA, and .STX disk images to the floppy inspection pipeline by file header and extension, with --input-format disk available to force handling.

Improvements

• Disk fallback handling: Falls back to raw binary disassembly with a warning on stderr if floppy header autodetection fails.
• Pipeline routing documentation: Updates --help and documentation to explain automatic disk routing and fallback options.
• Disassembly throughput: Optimises pass traversal to disassemble large raw images and executables up to 9× faster.

0.6.18 — 2026-09-15

Emits non-executable boot sectors and non-boot floppy tracks as collapsed data directives.

Improvements

• Non-executable boot sector formatting: Emits boot sectors with the executable flag cleared as collapsed .dc.b/.ds.b/.dcb.b data directives rather than instructions.
• Disk data-track listings: Emits non-boot sectors with unified preambles, per-sector org directives, and collapsed data runs.

0.6.17 — 2026-09-15

Improves CPU/FPU preamble auto-targeting accuracy, adds non-executable boot sector comments, and stabilises test defaults.

Improvements

• Conservative CPU auto-targeting: Derives .cpu and .fpu preamble directives strictly from emitted instructions, preventing embedded data bytes from inflating target requirements.
• Fixed disk track target defaults: Disassembles non-boot disk sectors against a fixed 68000 target to avoid escalating target directives across disk images.
• Non-executable boot sector comments: Adds a ; non-executable boot sector comment following the preamble when the bootable flag is clear.

Bug fixes

• Raw round-trip test target stability: Disables auto-targeting in raw round-trip test helpers to maintain consistent baseline targets across partial slices.

0.6.16 — 2026-09-15

Adds raw hex fallback for undocumented IKBD command writes and preserves PC-relative data blobs.

New features

• Undocumented IKBD command fallback: Emits raw hex values for IKBD command bytes that do not match known hardware constants.

Bug fixes

• PC-displacement data blob preservation: Protects PC-relative data blobs across corpus fixtures under default 68030/68882 decode settings.

0.6.15 — 2026-09-13

Adds configurable line indentation, validates data-to-code flow transitions, and aligns Pass 2 rescans across padding.

New features

• Configurable line indentation (--spaces, --tabs): Adds --spaces [N] and --tabs [N] options to configure listing indentation width and style.

Bug fixes

• Data-to-code flow validation: Requires candidate code runs transitioning out of data blobs to terminate with valid control-flow instructions, preventing data tables from being misidentified as code.
• Pass 2 padding alignment: Aligns Pass 2 rescan across null padding runs before known labels and relocations in .text, avoiding skipped branch targets and misdecoded subroutine prologues.
• Spurious branch fallback suppression: Suppresses invalid dc.w fallback emission for branch targets entering valid code preceded by padding.
• Smart label index formatting: Formats duplicate smart label variables with underscore-separated indices (e.g. OLD_HZ_200_2).

0.6.14 — 2026-09-13

Identifies OS system call wrappers and annotates caller argument setup instructions.

New features

• OS system call wrapper labelling: Automatically labels leaf subroutines wrapping GEMDOS, BIOS, XBIOS, and VDI/AES traps with semantic names (e.g. XBIOS_FLOPRD, GEMDOS_MSHRINK).
• Caller argument register annotations: Annotates setup instructions preceding wrapper calls with corresponding OS parameter names based on register mappings.
• Wrapper call site annotations: Annotates subroutine calls (BSR/JSR) targeting wrapper routines with the target OS trap class and function name.
• MFP interrupt register clear annotations: Annotates 32-bit clears to MFP interrupt enable and mask register pairs with concise semantic descriptions.

0.6.13 — 2026-09-13

Improves string extraction across unlabelled data runs and refines VT-52 detection thresholds.

Improvements

• Continuous unlabelled string extraction: Scans ahead through unlabelled .data blocks to extract valid string and VT-52 runs instead of demoting entire blocks to hex.

Bug fixes

• Unlabelled string and VT-52 validation: Enforces minimum character and termination criteria for unlabelled string candidates to avoid fragmented lines and false-positive VT-52 annotations.

0.6.12 — 2026-09-13

Packs binary data into continuous 16-byte lines, tightens string detection heuristics, and fixes unaligned data relocation loops.

Improvements

• Continuous binary data packing: Formats binary .data blocks into uniform 16-byte .dc.b lines without premature line breaks on isolated printable characters.
• Representative integration test suite: Enrolls 8 curated binaries into the default test suite for fast integration testing.

Bug fixes

• String candidate detection threshold: Requires at least 4 alphabetic characters and valid termination for string candidates in raw data blocks.
• Unaligned data relocation handling: Fixes an infinite loop when encountering unaligned relocation offsets in .data sections.

0.6.11 — 2026-09-12

Restricts GEM parameter buffer labels to data and BSS segments, and adds boundary awareness to string smart labels.

New features

• Label-bounded string detection: Recognises known symbol and section boundaries as string delimiters, enabling smart label generation for packed string arrays.

Bug fixes

• GEM parameter buffer segment gating: Restricts VDI and AES parameter block smart labels to .data and .bss sections, preventing spurious labels in executable .text.

0.6.10 — 2026-09-09

Improves relocation reconstruction and operand fidelity for disassembled TOS executables.

Improvements

• Relocation boundary pointer slicing: Slices data blocks at relocation offsets to emit symbolic .dc.l pointers, preserving relocations on reassembly.
• Displaced relocatable address resolution: Resolves displaced absolute long operands against relocatable labels with offsets rather than emitting absolute equates.
• Symbolic pointer resolver validation: Verifies target label emission for symbolic pointers in data blobs to prevent unvisited addresses falling back to absolute equates.

0.6.9 — 2026-09-09

Adds .prgflags directive emission for TOS header flags and improves data segment relocation fidelity.

New features

• PRG flags directive (.prgflags): Emits a .prgflags directive in disassembly output when non-zero TOS executable header flags are detected.

Bug fixes

• Data segment relocation preservation: Preserves relocations and labels across .data symbol blobs to maintain pointer alignment and structure integrity.

0.6.8 — 2026-09-08

Adds --color, --ascii, and --banner display control options for terminal styling, ASCII table borders, and banner formatting.

New features

• Terminal display controls (--color, --ascii, --banner): Adds --color to control ANSI output, --ascii for standard ASCII table borders, and --banner to select stderr masthead style.

0.6.7 — 2026-09-08

Improves CPX header inspection layout and fixes table column alignment with null-padded identifiers.

Improvements

• CPX header inspection layout: Reorders CPX header rows to place title before icon text and adds a dedicated flags group.

Bug fixes

• CPX ID column alignment: Strips trailing null bytes and whitespace from CPX identifiers to prevent table border misalignment.

0.6.6 — 2026-09-08

Prevents synthetic smart labels from encroaching on user data blobs and preserves relocation-targeted labels.

Bug fixes

• Smart label blob pruning and auto-label retention: Excludes synthetic smart labels from user symbol boundaries and protects relocation targets from auto-label pruning.

0.6.5 — 2026-09-07

Preserves interior labels within GEM parameter blocks and prevents synthetic equates from dropping relocations.

Bug fixes

• GEM parameter block interior labels: Preserves labels at interior offsets within VDI and AES parameter blocks to maintain relocations on reassembly.

0.6.4 — 2026-09-07

Fixes GEM parameter block pointer resolution in binaries over 64 KB and prevents spurious entry point renaming.

Bug fixes

• GEM parameter block slot pointer resolution: Resolves relocated parameter block slots from file offsets to ensure correct label emission in binaries larger than 64 KB.
• Parameter block target bounds checking: Validates address bounds before rebasing parameter blocks and prevents null pointers from renaming the entry point.

0.6.3 — 2026-09-07

Restricts GEM parameter block detection to immediate and address-register pointer sources.

Bug fixes

• GEM parameter block address detection: Requires immediate operands or explicit LEA instructions for TRAP #2 parameter block recovery, avoiding misidentification of indirect variable loads.

0.6.2 — 2026-09-07

Adds structured formatting and annotations for GEM VDI/AES parameter blocks, control size tables, and subsystem selectors.

New features

• VDI and AES parameter block formatting (--annotate-vdi, --annotate-aes): Recognises and formats VDI and AES parameter blocks as structured .dc.l pointer tables with descriptive field comments.
• AES control size table decoding: Identifies and annotates AES opcode control size tables with function names and expected parameter counts.
• GEM subsystem selector annotations: Annotates D0 register setups before TRAP #2 with identified VDI or AES subsystem selectors.

0.6.1 — 2026-09-07

Adds --unpack decompression support, fixes CPX header parsing and character decoding, and handles broken stdout pipes cleanly.

New features

• Executable unpacking (--unpack): Automatically detects and decompresses executables packed with Atari ST crunchers (Ice, Atomik, Automation, Pompey, SpeedPacker, Fire) prior to disassembly.

Improvements

• CPX header parsing and charset decoding: Aligns CPX header field offsets with the XControl specification and decodes strings using the Atari ST character set.

Bug fixes

• Broken pipe error handling: Exits cleanly with code 0 when stdout is closed by downstream tools like head or less.

0.6.0 — 2026-09-07

Rebuilds CPU requirement inspection using control-flow reachability analysis, expands 68020 instruction coverage, fixes cycle annotation defaults, and adds padded CPX header support. Consolidates development from 0.5.29 through 0.5.45.

New features

• CPU requirements inspection (--inspect=cpu): Inspects minimum CPU and FPU architecture requirements based on control-flow reachability analysis.
• Padded CPX header support: Detects and disassembles Control Panel Extension files with padded headers.
• JSON and interactive CPU reporting: Emits CPU requirement tables in interactive output and structured cpu objects under --json.

Improvements

• Control-flow CPU requirement analysis: Traces executable control flow across branches, jump tables, and subroutines to exclude embedded data from CPU requirement classification.
• Object file routine traversal: Traverses all defined function symbols across relocatable object sections.
• Expanded 68020 instruction classification: Recognises EXTB.L, LINK.L with 32-bit displacements, 32-bit branches, and extended TST/CMPI addressing modes.
• Indirect call discovery: Seeds reachability traversal from relocation fixups and symbol definitions to analyse routines reached via jump tables.
• Line-A opcode traversal: Recognises Line-A opwords ($A000–$A00F) as system calls to continue control-flow traversal.
• Architecture discovery ceiling: Decodes up to 68040 and 68882 FPU during inspection regardless of default target flags.
• Target flag handling: Honours explicit --cpu and --fpu CLI arguments during requirement inspection.
• Non-TTY CPU inspection output: Renders requirement summaries in clean plain text when stdout is redirected.

Bug fixes

• Intra-function label validation: Prevents local labels from causing candidate code components to be discarded during CFG validation.
• Forward and non-returning subroutine calls: Fixes false section overrun detection on forward calls and supports non-returning subroutines in relocatable objects.
• Raw binary analysis slicing: Slices past synthetic wrapper headers to prevent payload truncation during CPU analysis.
• Data pointer filtering: Filters data operands and data relocations from reachability worklists to prevent evaluating data structures as code entry points.
• Component error recovery: Skips invalid decode sequences on unreachable branches rather than discarding entire candidate code components.
• Unmodelled CPU cycle timing: Omits timing output and warns on stderr when --annotate-cycles is used with unmodelled CPU targets or instructions.
• Invalid instruction rejection: Rejects invalid CMPI An encodings and malformed CHK2/CMP2 addressing modes to prevent inline data raising false 68020+ requirements.
• Code versus data classification: Restores instruction-to-data fallback classification consistency across target CPUs.
• Inspection argument parsing: Fixes space-separated --inspect cpu <file> syntax to parse input filepaths correctly.

0.5.28 — 2026-09-05

Suppresses cycle annotations on data directives and fixes multi-line comment column alignment.

Bug fixes

• Data directive annotations: Suppresses cycle timings and semantic annotations on demoted dc.w and ds.w directives.
• Multi-line comment column alignment: Aligns trailing annotation comments based on final line width in multi-line instruction blocks.

0.5.27 — 2026-09-05

Adds CPX file detection, GEMDOS Pterm0 decoding, expanded header diagnostics, and CPU requirements inspection.

New features

• CPX file detection: Detects and disassembles Atari Control Panel Extension (.CPX) files and provides header metadata tables in --inspect.
• CPU and FPU requirements inspection (--inspect=cpu): Detects minimum CPU and FPU requirements and reports non-68000 instructions and addressing modes.

Improvements

• Pterm0 call recognition: Decodes TRAP #1 invocations with zero arguments as GEMDOS function 0 (Pterm0).
• Executable header diagnostics: Adds annotations and table breakdowns for Fastload, TT-RAM, MiNT memory protection, and TPA limit flags.

0.5.26 — 2026-09-05

Documents default target architecture and updates release download links.

Improvements

• Default CPU documentation: Documents the default 68030 target architecture across CLI help and reference docs.
• Release documentation: Adds platform binary download links across release documentation.

0.5.25 — 2026-09-05

Adds per-instruction CPU cycle execution cost annotations.

New features

• Cycle cost annotations (--annotate-cycles): Annotates instruction lines with estimated CPU execution cycle counts based on the target architecture.

0.5.24 — 2026-09-05

Fixes guest address resolution for 68020+ base and outer displacements in indexed addressing modes.

Bug fixes

• 68020+ displacement resolution: Fixes base and outer displacement address resolution in memory-indirect addressing modes to prevent double-rebasing during symbol lookup.

0.5.23 — 2026-09-05

Interim fix for 68020+ indexed addressing displacement resolution (superseded by 0.5.24).

Bug fixes

• Full extension displacement resolution (interim): Reads displacements directly from decoded operands rather than raw extension words (superseded by 0.5.24).

0.5.22 — 2026-09-05

Adds support for SR/CCR bit operations, explicit zero displacements, and expanded Falcon memory-mapped I/O annotations.

Improvements

• SR and CCR bit operations: Disassembles ORI, ANDI, and EORI instructions targeting SR and CCR to standard mnemonics instead of raw data words.
• Zero-displacement addressing: Emits explicit 0(An) displacements for address register indirect operands to preserve reassembly fidelity.
• 68020+ base-suppressed indexing: Adds support for base-suppressed indexed addressing ((Xn,bd)) with symbol table resolution.
• Subroutine spacing: Restricts subroutine boundary spacing to terminal RTS/RTE instructions to keep epilogues contiguous.
• Branch target boundary classification: Recognises branch targets following null padding words during label collection.
• Falcon memory-mapped I/O annotations: Adds hardware register annotations for Falcon system configuration, bus control, and Videl timing.

0.5.21 — 2026-09-04

Adds CLI flags to control VT-52 escape sequence annotations.

New features

• VT-52 annotation flags (--annotate-vt52): Adds flags to control VT-52 escape sequence decoding annotations independently.

0.5.20 — 2026-09-04

Adds PC-relative string pointer support to smart label generation.

Improvements

• PC-relative string pointers: Recognises PEA str(PC) operands during string analysis to generate contextual STR_ and VT52_ labels.

0.5.19 — 2026-09-04

Adds VT-52 terminal escape sequence decoding, smart labelling, and console call annotations.

New features

• VT-52 escape sequence decoding: Decodes standard VT-52 control commands and Atari ST extensions (screen clear, cursor movement, video attributes).
• VT-52 smart labels: Generates VT52_ prefixed labels for detected escape sequence buffers under --smart-labels.
• Console call annotations: Annotates GEMDOS Cconws and console string arguments with decoded escape command summaries.

0.5.18 — 2026-09-04

Improves branch target spacing for object files and corrects Atari ST character classification.

Improvements

• Object file branch spacing: Includes branch target auto-labels in vertical spacing plans for GST and a.out object formats.
• Greek character classification: Adjusts Atari ST Greek character ranges to exclude mathematical symbols from string scoring.

0.5.17 — 2026-09-04

Improves loop header vertical spacing containment and refines string extraction scoring.

Improvements

• Loop header stack cleanup spacing: Bounds stack cleanup scans by basic block boundaries to keep loop header branch targets separate from preceding calls.
• String scoring adjustments: Excludes symbol padding bytes from vowel scoring and enables accented Latin script anchoring.

0.5.16 — 2026-09-04

Adds Hebrew and Greek string scoring support and constrains return consumer spacing scans.

Improvements

• Hebrew and Greek string extraction: Adds script continuity scoring for Atari TOS Hebrew, Greek, and accented Latin character ranges.
• Call return spacing: Prevents forward return consumer scans from crossing basic block boundaries into labelled loop headers.

0.5.15 — 2026-09-04

Refines Atari ST character set scoring heuristics and bounds return consumer spacing.

Improvements

• Character set string scoring: Restores ASCII and Latin accent validation in string scoring heuristics to filter false-positive opcode sequences.
• Return consumer spacing: Restricts return consumer scans to verified symbol boundaries and entry points.

0.5.14 — 2026-09-04

Improves call spacing for return value bit tests, preserves symbol boundaries, and filters non-letter glyphs.

Improvements

• BTST return consumer spacing: Keeps BTST #n, D0 return value tests contiguous with preceding system call blocks.
• Symbol boundary spacing: Preserves function and entry boundaries by incorporating symbol and label addresses into spacing calculations.
• Character filtering: Restricts high-byte letter classification to accented Latin, Hebrew, and Greek characters, excluding math and typography symbols.

0.5.13 — 2026-09-04

Maintains contiguity for argument push sequences and bounds return consumer spacing.

Improvements

• D0 argument push spacing: Keeps MOVE.W D0, -(SP) argument setup contiguous with subsequent function calls.
• Basic block boundary containment: Prevents forward return consumer scans from crossing branch target boundaries.

0.5.12 — 2026-09-03

Maintains spacing contiguity for return value stores to stack offsets.

Improvements

• Stack return store spacing: Keeps return stores to stack offsets (MOVE.W D0, d(SP)) contiguous with call blocks without misidentifying them as argument pushes.

0.5.11 — 2026-09-03

Improves LEA stack cleanup vertical spacing and adds character scoring for Hebrew and Greek.

Improvements

• LEA stack cleanup spacing: Keeps positive-displacement stack cleanups (LEA n(SP), SP) contiguous with preceding system calls.
• Hebrew and Greek character scoring: Adds classification support for Atari TOS Hebrew and Greek character ranges in string scoring.

0.5.10 — 2026-09-03

Maintains contiguous spacing for multiple return value stores following trap calls.

Improvements

• Multiple return store spacing: Keeps sequential stores or tests of trap return values (D0 or A0) contiguous with the call block.

0.5.9 — 2026-09-03

Maintains contiguous spacing for non-predecrement stack argument stores preceding function calls.

Improvements

• Stack argument store spacing: Treats direct stores to (SP), d(SP), and d(SP,Xn) as argument setups, keeping them contiguous with call instructions.

0.5.8 — 2026-09-03

Fixes vertical line spacing around FPU instructions.

Bug fixes

• FPU instruction spacing: Restricts non-stack system call vertical spacing to Line-A traps, preventing unwanted blank lines around FPU instructions.

0.5.7 — 2026-09-03

Improves string extraction filtering for the Atari ST character set and adds unfiltered extraction.

Improvements

• Atari charset string scoring: Evaluates high-byte density and clustering under --strings-charset atari to filter false positives from compressed data while retaining localized text.
• Unfiltered string extraction (--strings-min-score 0): Bypasses heuristic scoring to output all extracted character runs.

0.5.6 — 2026-09-03

Adds unfiltered string extraction option and corrects section names in documentation.

Improvements

• Unfiltered string extraction (--strings-min-score 0): Disables heuristic filtering and code-region length minimums to extract all printable runs.
• Section documentation: Corrects segment listings in documentation from BSS to TEXT, DATA, or named sections.

0.5.5 — 2026-09-03

Enables ColdFire on-chip FPU defaults, decodes 32-bit multiply and divide instructions, and validates MOV3Q destinations.

Improvements

• ColdFire FPU default: Defaults ColdFire targets to enable on-chip FPU (.fpu coldfire).
• 32-bit arithmetic decoding: Enables disassembly and instruction length calculation for 32-bit MULU.L and DIVS.L on ColdFire targets.
• MOV3Q operand validation: Restricts MOV3Q destination decoding to alterable effective addresses, rejecting PC-relative destinations.

0.5.4 — 2026-09-02

Supports address register operands in ALU operations and validates ColdFire instructions.

Improvements

• ALU address register operands: Supports ADD, SUB, and CMP disassembly with address register sources (An), while demoting invalid byte and logical operations to data words.
• ColdFire Line-A validation: Enforces opcode mask checks for ColdFire Line-A instructions.
• STLDSR and MOV3Q instructions: Adds disassembly support for STLDSR with immediate operands and MOV3Q with address register destinations.

0.5.3 — 2026-09-02

Emits ColdFire listing directives, adds MAC parallel load decoding, and tightens opcode validation.

Improvements

• Listing directives: Emits .cpu coldfire and .fpu coldfire target directives in ColdFire listings.
• MAC parallel loads: Adds decoding support for ColdFire MAC parallel loads, displacements, accumulator selectors, and scale factors.
• ColdFire opcode validation: Validates brief-format index register sizing, validates TPF opcodes, and rejects memory-destination Scc encodings.

0.5.2 — 2026-09-02

Unifies ColdFire FPU command-line options.

Improvements

• ColdFire FPU CLI options: Adds coldfire and cf aliases directly to --fpu.

0.5.1 — 2026-09-02

ColdFire instruction set decoding, MAC/EMAC, and on-chip FPU support.

New features

• ColdFire ISA support: Adds decode support for ColdFire targets (-m coldfire, --fpu coldfire) including MAC/EMAC and on-chip FPU.
• CPU target aliases: Adds CLI aliases for target CPUs (68k, 000, 010, 020, 030, 040, 060, cf, cfv4e).

0.5.0 — 2026-09-02

Initial public release. Disassembles Atari ST, TT, and Falcon executables, object files, and disk images to Motorola 680x0 assembly source with round-trip reassembly fidelity across our test suite.

New features

• Multi-Format Disassembly: Disassembles Atari GEMDOS executables (.TOS, .PRG, .APP, .GTP), relocatable objects (DRI, Devpac GST, VBCC a.out), static libraries (ar archives), and raw binary images.
• Floppy Disk & Container Support: Extracts and disassembles boot sectors and disk sectors from Pasti .STX, .ST, .MSA, .ZIP, and .LZH images with geometry-aware CHS extraction.
• Round-Trip Reassembly: Produces assembly source verified for round-trip reassembly across our test suite when reassembled with size optimisation disabled.
• 680x0 and FPU instruction coverage: Disassembles MC68000 through MC68060 CPUs and 68881/68882 FPUs (defaulting to 68030 with 68882 FPU).
• Semantic annotations: Decodes GEMDOS, BIOS, and XBIOS trap calls with stack argument tracking, alongside hardware register annotations across Atari systems.
• Symbol table reconstruction: Loads DRI, GST, and .SYM symbol tables to reconstruct routine, branch, and data labels (prunes unreferenced equates by default; configurable via --unused-equates).
• Metadata inspection (--inspect): Summarises binary headers, functions, cycle counts, and extracted strings, with structured --json output.