GFA BASIC Rust Documentation

Amiga GFA BASIC source and topic index

Research Note

Amiga GFA BASIC source and topic index

Purpose: page-addressable navigation through the supplied Amiga references and the project's source-derived extraction notes. This is a research index, not a claim that every listed feature is implemented or runtime-tested.

Source/version key

Source ID Source and scope How to use it
AM-INTERPRETER-35 GFA BASIC 3.5 Interpreter; 3.0 base manual plus explicit 3.5 update material Normative source for explicit 3.5 addendum features. Base-manual material remains 3.0 evidence unless separately confirmed by the addendum or runtime.
AM-INTERPRETER-30-35-UPDATE-SCAN Combined 3.0 + 3.5 update scan, including explicit Chapter 13, Chapter 14 and editor update Independent pagination witness for the same 3.5 update. Chapter 13 matrix material and Chapter 14 additions use printed pp. 14-1–14-7 in this scan.
AM-BOOK-DE-1990 Bleek/Hecht/Litzkendorf, Das große GFA-BASIC-Buch zum Amiga, Data Becker 1990, ISBN 3-89011-399-0 Broad historical Amiga reference. Foreword says interpreter 3.0; section 1 identifies V3.03. Do not treat the cover's “bis Version 3.5” wording as proof of 3.5 interpreter semantics.
AM-BOOK-FR French translation of the 1989 Amiga book, ISBN 2-86899-207-2 Historical 3.0 corroboration; keep its page numbering separate.

Bibliographic provenance, scan access and copyright notes are in the source register, the German OCR index, and the 3.5 primary reference notes. The supplied scans are external research material and are not stored in this repository.

Topic index: German 1990 book

All pages below are printed page numbers, not PDF viewer page numbers. Detailed source-derived summaries and page-image corrections are in the command/API extraction, with section anchors.

Topic / command family Printed pages Extraction
Book applicability, BASIC introduction, language foundations 13–65 §1–§6
Screen/input/output, files, channels, ports 75–119 §1, §14
AmigaDOS library calls 120–132 §11
Printer and hardcopy 132–138 §12
Sound, WAVE, SAY and speech 139–143 §13
Program structure, loops, branches, procedures and functions 145–191 §7, §15
Text and string operations 193–200 §16
Operators, arithmetic, numeric and bit functions 201–224 §17
Graphics definitions, drawing, DRAW$, SCROLL, GRAPHMODE 225–256 §18, §37
GET/PUT bitmap strings, hardware sprites, BOB/OBJECT 257–278 §19, §38
Number conversion and formatting 279–290 §20
Arrays, OPTION BASE, sorting 291–304 §21
Memory, typed access, allocation, pointers 305–316 §22
Amiga Exec tasks, signals, ports, lists, libraries, devices 317–328 §23
Program control, errors, debugging, DUMP, MODE 331–361 §8, §24, §39
ALERT, FILESELECT, mouse, joystick, STICK/STRIG 363–374 §25, §40–§41
Windows, screens, IDCMP, Window flags 375–388 §26, §36
MENU creation and attributes 389–393 §27, §36
Intuition event handling, MENU() payload, dispatch 395–404 §28–§29, §42–§43
Compiler and linker (not interpreter API) 405–450 §33
3.5 matrix/vector operations (compare with separate 3.5 addendum) 451–476 §30, 3.5 addendum inventory
FACT, VARIAT, COMBIN, _DATA, editor additions 477–482 §31
Error appendices, command index and back matter 483–508 §32, §35

Version-specific 3.5 addendum index

The GFA BASIC 3.5 Interpreter manual contains a 3.0 base plus explicitly identified 3.5 additions. Use its printed Chapter 13 pagination; the combined update scan uses Chapter 13 for matrix operations and Chapter 14 for further commands.

3.5 feature Supplied interpreter manual pages Combined update scan pages Evidence note
Editor row layout, closed procedure/function search, listing changes, tab keys 1-25 1-25 Explicit 3.5 editor update; not interpreter language syntax
Matrix base and initialization: MAT BASE, MAT CLR/SET/ONE 13-1–13-3 13-1–13-3 Floating-point 1D/2D fields only
Matrix READ/PRINT/INPUT 13-3–13-6 13-3–13-6 MAT PRINT punctuation visually checked; MAT INPUT is ASCII-file input
Matrix copy, transpose and vector special cases 13-8–13-20 13-8–13-20 MAT CPY/XCPY/TRANS and separate MAT COPY forms are distinguished by source
Matrix arithmetic and multiplication 13-16–13-25 13-22–13-33 Element-wise, scalar, matrix and vector forms; MAT MUL array(),scalar multiplies every field element by the scalar in place (3.5 addendum inventory and gfa.language.matrix.mat-mul registry declaration)
Matrix norm, determinant, quick determinant, rank and inverse 13-22–13-30 13-31–13-41 MAT INV destination-first form resolved from detailed definition/example; summary on p. 13-16 is reversed typo
FACT, VARIAT, COMBIN 13-33–13-34 14-1–14-2 Explicit added mathematical functions
Negative-screen OPENW, PCOLOR 13-34 14-3–14-4 Additional interpreter commands
_DATA, _DATA=, _0…_9, GURU statement/function 13-34–13-36 14-5–14-7 Special variables and GURU behavior; preserve error-code caveats

Detailed definitions, examples, disputes and evidence boundaries are in the 3.5 addendum inventory. The German 1990 book's Chapter 18–19 is useful corroboration, but it is not substituted for the version-specific 3.5 source.

Explicit cross-source reconciliation

Topic 3.5 source German 1990 book Treatment
Core command reference version 3.0 base + explicit 3.5 additions Foreword 3.0; section 1 V3.03 Keep base behavior historical unless independently confirmed
Matrix array types Floating-point fields, 1D/2D Broader “numeric fields” phrasing Use narrower explicit 3.5 constraint
Matrix copy Distinct MAT CPY and MAT COPY forms MAT CPY documented Do not merge spellings
Vector multiplication Outer/dyadic, inner/scalar, vector–matrix–vector Less complete treatment Preserve explicit 3.5 addendum forms
Inverse Summary p. 13-16 (469-page manual) / p. 13-22 (combined scan) reverses operands; detailed definition/example p. 13-30 / p. 13-39 respectively specify destination first German book p. 475 independently agrees Use MAT INV destination()=source(); summary line is a typo
FACT/VARIAT/COMBIN vs error #86 3.5 addendum documents FACT/VARIAT/COMBIN Error appendix retains stale FACT/COMBIN/PERMUT wording VARIAT is documented; PERMUT alias is not established; error text is inconsistent
MENU attribute value 64 Not part of 3.5 addendum German page 389 prints 64 for both clear-checkmark and activate-item Preserve source duplicate; do not silently repair
Intuition timer event English manual prints 4194303 beside &H400000 in its IDCMP table German p.378 gives 4194304; event descriptions repeat 4194303 Resolve as decimal typo: &H400000 = 4194304

Page-image validation register

Printed pages Items checked Result
13-1–13-41 and 14-1–14-7 (3.5 addendum) Matrix syntax/operation examples, further 3.5 commands and editor changes Full addendum pass recorded in issue #65; unresolved source disagreements remain explicitly flagged
1-25 (3.5 editor update) Editor changes and Tab/Ctrl+Tab/Shift+Tab operations Visually checked; ambiguous deletion boundary preserved
378–379, 389 IDCMP flags, Window flags, MENU attributes Page-image checked; duplicate MENU value 64 retained
240, 245–250, 272–273 GRAPHMODE examples, SCROLL, DRAW$, OBJECT.VY/OBJECT.PLANES Page-image checked; only documented GRAPHMODE values asserted
257, 261–268 GET/PUT header/modes/bitplanes, hardware SPRITE Page-image checked; PUT mask semantics remain unspecified
352–354, 358 DUMP selectors/output and MODE table Page-image checked; runtime details remain unverified
363–368, 371–373 ALERT, FILESELECT, MOUSE, STICK/STRIG Page-image checked; source-specific hardware behavior not runtime-tested
398–404 MENU() event payloads, ON MENU, SLEEP and handler registration Page-image checked; printed timer mismatch retained

Research and implementation boundaries

  • This index describes source evidence, not parser support, implementation status or runtime conformance.
  • The German 1990 book's 3.0/V3.03 material is not silently promoted to 3.5.
  • Compiler/linker tools are separate from interpreter language/API entries.
  • Direct Amiga OS library wrappers need ABI/layout/runtime validation before implementation decisions.
  • Known source disagreements and unresolved OCR/runtime questions remain visible in the extraction notes and the candidate manifest.
  • Historical scans and OCR dumps must not be committed or redistributed. Only concise citations, source metadata, original summaries and independently authored tests belong in the repository.

Selected command/function navigation

This is a compact name-to-page index for the principal interpreter families extracted in this pass. It is intentionally a selected index, not a claim to reproduce every entry of Appendix D. Where a command is part of the 3.5 addendum, the version-specific 3.5 table above takes precedence over the older book's page number.

Names / family Printed pages Scope
INPUT, LINE INPUT, FORM INPUT, INKEY$, PRINT, WRITE, LOCATE, HTAB, VTAB 75–92 Screen and keyboard I/O; 3.0/V3.03 source
OPEN, CLOSE, INPUT #, LINE INPUT #, PRINT #, WRITE #, FIELD, GET, PUT, SEEK, RELSEEK, RECORD, BGET, BPUT 92–119 File and channel operations; 3.0/V3.03 source
INP, OUT 119 Port I/O; 3.0/V3.03 source
OPENW, CLOSEW, MOVEW, FULLW, LIMITW, TITLEW, FRONTW, SIZEW, WINDOW() 375–388 Amiga window API; negative-screen OPENW variant separately confirmed in 3.5 addendum
OPENS, CLOSES, SCREEN(), SCREEN and screen geometry/mode operations 383–388 Amiga screen API; 3.0/V3.03 source
MENU, MENUTEXT, MENUMENU, MENUKEY, MENUKILL, ON MENU, ON MENU GOSUB, ON MENU BUTTON GOSUB, ON MENU KEY GOSUB, SLEEP 389–404 Menu creation and Intuition event dispatch; page-image verified selected event tables
ALERT, FILESELECT, MOUSE, MOUSEX, MOUSEY, MOUSEK, STICK, STICK(), STRIG() 363–373 Requesters and input devices; 3.0/V3.03 source
PLOT, LINE, DRAW, DRAW$, BOX, PBOX, CIRCLE, PCIRCLE, ELLIPSE, PELLIPSE, POLYLINE, POLYFILL, POINT, SCROLL, TEXT, GRAPHMODE 225–256 Raster and vector graphics; selected syntax page-image verified
GET, PUT, SPRITE, VSYNC, OBJECT.*, ON COLLISION GOSUB 257–278 Bitmap transfer, hardware sprites and Blitter objects; mask/runtime caveats retained
OPTION BASE, DIM, ERASE, INSERT, QSORT, SSORT, ARRAYFILL, ARRPTR 291–304 Arrays and sorting
PEEK, POKE, DPEEK, DPOKE, LPEEK, LPOKE, MALLOC, MFREE, VARPTR, ABSOLUTE, INLINE 305–316 Memory and pointers; low-level ABI/runtime validation required
SOUND, WAVE, SAY, TRANSLATE$ 139–144 Sound and speech output
DATA, READ, RESTORE, DEFBIT, DEFBYT, DEFINT, DEFSTR, DEFWRD, LOCAL, PROCEDURE, FUNCTION, DEFFN, CALL, EXEC, MONITOR, RCALL 145–191 Program structure, declarations and external code
DUMP, MODE, TRACE$, TRON, TROFF, ERROR, ERR, ERR$, RESUME 331–361 Diagnostics, error handling and interpreter control
MAT BASE, MAT CLR, MAT SET, MAT ONE, MAT READ, MAT PRINT, MAT INPUT, MAT CPY, MAT XCPY, MAT TRANS, MAT ADD, MAT SUB, MAT MUL, MAT NORM, MAT DET, MAT QDET, MAT RANG, MAT INV 13-1–13-36 (469-page manual); 13-1–13-41 (combined update scan) Version-specific matrix/vector API; floating-point fields only
FACT, VARIAT, COMBIN, PCOLOR, GURU, _DATA, _DATA=, _0…_9 13-33–13-36 (3.5 addendum) Explicit additional 3.5 interpreter features

Names are normalized only for navigation; this table does not settle OCR spellings where the source is damaged or internally inconsistent. For example, the book's error appendix uses PERMUT where Chapter 19 describes VARIAT, and the function inventory retains disputed CVD/CVF and MKD/MKF name slots. Consult the candidate manifest and the detailed source notes before using any spelling as a parser requirement.

Resolved source discrepancies (2026-11-08)

  • MAT INV: MAT INV destination()=source() is established by the 3.5 addendum's detailed definition and worked example (printed p. 13-30 in the supplied manual; p. 13-39 in the combined update scan), and independently by the German book (p. 475). The reversed summary line on 3.5 p. 13-16 is a typo.
  • INTUITICKS: use decimal 4194304 / hexadecimal &H400000. The repeated decimal 4194303 in event prose is a typo; the hexadecimal representation and German IDCMP table agree.
  • Error #86 / PERMUT: VARIAT is the documented function name; PERMUT occurs only in the inconsistent error catalogue entry. No alias is established.
  • MENU attribute 64: duplicate values are confirmed in the source. The runtime effect remains unknown and requires interpreter testing.