GFA BASIC Rust Documentation

Research materials

Research Note

Research materials

This directory contains research procedures and analysis of historical material. It is not a normative language specification and does not define implementation support.

Research-only policy: Historical manuals, books, ROMs, disk images, and historical sample programs are external references, not project deliverables. Do not add these artifacts to the repository or bundle them with releases. Keep only source metadata, concise citations, original analysis, and independently authored tests.

Amiga GFA BASIC command catalogue

For command/function discovery, start at the dedicated Amiga GFA BASIC command catalogue. It explains which existing source to consult for alphabetical lookup, chapter-level semantics, structured function names, and interpreter-version evidence.

Quick routes:

Counting warning: the German book describes approximately 360 commands and functions, but its alphabetical index mixes statements, functions, aliases, constants, variables, object properties, and other terms. It describes GFA V3.03; it is not a verified 3.5 command list. The function inventory's 117 names and the candidate report's family counts measure different things. See the catalogue for definitions and workflow. Do not add these counts together or report them as a single command total.

Document Scope Status
Aminet GFA BASIC package survey Amiga Aminet dev/basic archive listing Initial package inventory; readmes, archive contents, and rights remain unverified
German Amiga book OCR index Amiga GFA BASIC, German 1990 edition OCR table-of-contents map; version coverage and page-image validation remain open
German Amiga GFA BASIC 3.0 source notes Amiga interpreter 3.0; German first edition, 1989 Front matter and selected pages visually checked; remaining chapter/page review is incomplete
Amiga GFA BASIC 3.5 primary reference Amiga interpreter 3.5 manual Version-specific primary source identified; full manual feature inventory remains in progress
Amiga GFA BASIC 3.5 addendum inventory Amiga interpreter 3.5, explicitly identified editor update and Chapters 13–14 Page-image review of the complete explicitly identified 3.5 addendum/editor update is complete; OCR-sensitive details and recorded source discrepancies remain. This does not revalidate base-manual Chapters 2–12 for 3.5
Amiga GFA BASIC source and topic index Amiga interpreter 3.5 addendum and German 1990 Amiga book Consolidated printed-page navigation, source/version boundaries, cross-source disagreements, and page-image validation register; research index only, not runtime conformance
German Amiga GFA-BASIC book: command and OS API extraction DATA BECKER, 1990, ISBN 3-89011-399-0 German book extraction through Chapter 19 and Appendices B–D plus English 3.5 addendum reconciliation: added PCOLOR, GURU, _0…_9, negative-screen OPENW, MAT COPY and precise floating-point/vector semantics; German book and English 3.5 addendum fully indexed; page-image verified IDCMP flags (p. 378), Window flags (p. 379), and MENU attributes (p. 389, source duplicate value 64 retained); page-image verified SCROLL syntax/sign behavior (pp. 245–246), DRAW$ turtle grammar and DRAW() indices (pp. 248–250), GRAPHMODE examples 1=REPLACE/3=XOR (pp. 240, 250), and OBJECT.VY/OBJECT.PLANES (p. 273); page-image verified GET/PUT header, drawing modes and sprite bitmap/color-register layout (pp. 257, 261–267); DUMP selectors/output and MODE locale bit table (pp. 352–354, 358); ALERT, MOUSE and STICK/STICK() definitions (pp. 363, 371–372); FILESELECT outcomes and sample-only extension/backup routines (pp. 365–368), MOUSE button values (p. 368), STRIG() (p. 373), MENU event values/payloads (pp. 398–402, including OCR correction 264144→262144 and printed timer discrepancy 4194303 vs IDCMP 4194304), and ON MENU/SLEEP dispatch semantics (pp. 403–404) page-image verified; consolidated navigation and cross-source index is in amiga-gfa-basic-source-topic-index.md; runtime delivery, pointer lifetime and event-queue behavior remain untested
Amiga GFA BASIC 3.5 built-in function inventory and machine-readable list Amiga interpreter 3.5 117 unique names across the combined manual; 115 interpreter candidates, including two disputed name slots (CVx and MKx); two compiler-only entries are excluded from the interpreter count
Amiga GFA BASIC candidate manifest and generated verification report Amiga interpreter 3.5 candidate status Structured, version-scoped tracking; unresolved 3.0 families are kept separate from declarations explicitly documented in the 3.5 addendum
Amiga runtime workflow OCR audit Active Amiberry workflow OCR usage, non-OCR evidence, and recommendation Research-only workflow audit; OCR retained only for the post-merge GUI assertion
Amiga emulator experiment lab Amiberry-based native interpreter experiment workflow Native Merge + Run workflow is integrated on main; a 3.52 FACT(0..2) probe passed. Exact 3.5 interpreter media remains unavailable; see the 3.52 runtime baseline
Atari GFA BASIC book diskette Static analysis of examples accompanying an Atari ST reference book Research corpus; file rights and standalone behavior require per-example review
Systematic Atari book review Chapter-by-chapter analysis of the Atari ST GFA BASIC reference book Initial review completed; page-image and semantic validation remain

Research rules

  • Identify source provenance, platform, dialect/version, edition, and page/section.
  • Separate direct source statements, observed behavior, interpretation, and implementation decisions.
  • Do not infer Amiga behavior from Atari ST sources or the reverse.
  • Treat archive names and catalogue descriptions as leads until the underlying material is inspected.
  • Record provenance and applicability, but do not distribute historical manuals/books, ROMs, disk images, or historical sample programs. Do not commit scans, OCR dumps, archive images, or copied source listings. Keep only metadata, concise citations, original analysis, and independently authored fixtures.
  • Promote a research claim into a language/API reference only after its evidence has been reviewed.

See the reference source register, language reference notes, and documentation policy.