Skip to content

Latest commit

 

History

History
198 lines (172 loc) · 15.9 KB

File metadata and controls

198 lines (172 loc) · 15.9 KB

BASIC Manual Map

elderheim maps BASIC support from manuals to explicit compiler dialect names. When a new manual is found, classify it here before changing parser behavior or making compatibility claims.

Intake Rule

  1. Identify whether the source is a primary manual, standard, vendor manual, or secondary summary.
  2. Map it to one explicit compiler dialect name.
  3. Add the dialect to the roadmap as active, planned, reserved, or rejected.
  4. Add manual-backed fixtures before the dialect is marked complete.
  5. Do not expose a public CLI selector until parser, semantic validation, and diagnostics fail closed for unsupported constructs.

Current Local Manual Map

Source Classification Compiler dialect Roadmap status
/home/eldryoth/Work/test/basicmanuals/first edition may 1964.pdf Dartmouth First Edition manual, image-only dartmouth-basic-1 Active pre-1.0 profile, target 0.50.0.
/home/eldryoth/Work/test/basicmanuals/second edition october 1964.pdf October 1964 Dartmouth manual with CARDBASIC section dartmouth-basic-2, cardbasic Active pre-1.0 profiles, target 0.60.0.
/home/eldryoth/Work/test/basicmanuals/196801_BASIC_4th_Edition_text.pdf Dartmouth Fourth Edition manual dartmouth-basic-4 Active pre-1.0 profile, target 0.70.0.
/home/eldryoth/Work/test/basicmanuals/BASIC_4th_Edition_Jan68_djvu.txt Searchable text export of Dartmouth Fourth Edition dartmouth-basic-4 Fixture and search companion for 0.70.0.
/home/eldryoth/Work/test/basicmanuals/altair BASIC Manual 75.pdf MITS Altair BASIC Reference Manual, 1975, searchable PDF altair-basic-1975 Planned early MITS/Microsoft microcomputer BASIC dialect. 4K, 8K, and Extended BASIC subprofile split remains an implementation decision.
/home/eldryoth/Work/test/basicmanuals/BASIC-80_MBASIC_Reference_Manual_text.pdf Microsoft BASIC-80 / MBASIC Reference Manual, release 5.0 and later, searchable PDF microsoft-basic-80-50 Planned Microsoft BASIC-80 profile. Covers 8K, Extended, Disk, CP/M, ISIS-II, TEKDOS, Intel SBC/MDS, standalone disk BASIC, BASIC-86 comparison, and Microsoft BASIC Compiler notes.
/home/eldryoth/Work/test/basicmanuals/IBM BASICA v1.10 Manual_text.pdf IBM Personal Computer BASIC release 1.10 manual, Second Edition, May 1982, searchable PDF ibm-pc-basic-110 Planned IBM PC BASIC family profile. Cassette BASIC, Disk BASIC, and Advanced BASIC / BASICA subprofile split remains an implementation decision.
/home/eldryoth/Work/test/basicmanuals/How_to_Program_Commodore_64_BASIC_for_Beginners.pdf How to Program Your Commodore 64 BASIC for Beginners, HPBooks / Knight-Ridder Press, 1983, searchable PDF commodore-64-basic-v2 Planned Commodore 64 BASIC V2 / CBMBASIC profile source. This is a beginner book, not the final vendor reference boundary.
/home/eldryoth/Work/test/basicmanuals/Commodore_128_BASIC_Programming_Techniques.pdf Commodore 128 BASIC Programming Techniques, TAB Books, 1986, searchable PDF commodore-basic-70 Planned Commodore 128 BASIC 7.0 profile source. This is a third-party techniques book, not the final vendor reference boundary.
/home/eldryoth/Work/test/basicmanuals/Basic Programming (Atari 2600)(US)_text.pdf Atari 2600 / Video Computer System BASIC PROGRAMMING cartridge manual, 1979, searchable PDF atari-2600-basic-programming Planned constrained cartridge BASIC profile. Not Atari 8-bit BASIC.
/home/eldryoth/Work/test/basicmanuals/Atari ST BASIC Quick Reference Guide for the Advanced Programmer (1987)_text.pdf Atari ST BASIC Quick Reference Guide for the Advanced Programmer, Atari Corporation, 1987, searchable PDF atari-st-basic-enhanced Planned Enhanced ST BASIC profile source. This is a quick reference for advanced programmers and points to the ST BASIC Sourcebook and Tutorial as the complete guide.
/home/eldryoth/Work/test/basicmanuals/Understanding_Atari_ST_BASIC_Programming.pdf Understanding Atari ST BASIC Programming, SYBEX, 1986, searchable OCR PDF atari-st-basic-enhanced Supplemental Atari ST BASIC programming source. Useful for tutorial examples and ST-specific programming context, but not the final vendor reference boundary.
/home/eldryoth/Work/test/basicmanuals/Atari_ST-Basic_Training_Guide.pdf ST BASIC Training Guide, Data Becker / Abacus Software, 1985/1988, searchable OCR PDF atari-st-basic-enhanced Supplemental Atari ST BASIC training and reference source. Useful for command, reserved-word, GEM, disk, graphics, and error-list cross-checks, but not the final vendor reference boundary.
/home/eldryoth/Work/test/basicmanuals/NEC+()+-+N60-BASIC_ocr.pdf NEC PC-6001 N60-BASIC manual, Japanese OCR PDF nec-n60-basic Planned Japanese NEC PC-6001 BASIC profile. Requires explicit source encoding, keyboard/input, kana/graphics, and character-set decisions. Not NEC N88-BASIC.
/home/eldryoth/Work/test/basicmanuals/NEC8300-BASIC.pdf NEC PC-8300 N82-BASIC Reference Manual, NEC Home Electronics (U.S.A.), 1986, searchable OCR PDF nec-n82-basic Planned NEC PC-8300 N82-BASIC profile. Portable-computer BASIC with LCD, full-screen editing, TEXT/TELCOM integration, memory-bank files, graphics, sound, and machine-language notes. Not NEC N60-BASIC or N88-BASIC.
/home/eldryoth/Work/test/basicmanuals/19980300B_BASIC_Language_Version_2_Reference_Nov74.pdf Control Data BASIC Language Version 2 Reference Manual, revision B, CYBER 170 / CYBER 70 / 6000 systems, image-only cdc-basic-v2 Planned Control Data timesharing BASIC dialect after the manual-backed Dartmouth profiles.
/home/eldryoth/Work/test/basicmanuals/fullbasic-ansi_x3.113-1987.pdf ANSI X3.113-1987 / FIPS PUB 68-2 Full BASIC standard ansi-basic Planned Standard BASIC dialect after the manual-backed Dartmouth profiles.
/home/eldryoth/Work/test/basicmanuals/ecma-116_1st_edition_june_1986.pdf ECMA-116 BASIC standard, image-only ecma-basic-1, ecma-basic-2 Planned Standard BASIC dialects after ansi-basic; ECMA Graphics remains a module decision.
/home/eldryoth/Work/test/basicmanuals/Structured BASIC 2nd Edition (1989)(SouthWestern Publishing).pdf South-Western textbook, Structured BASIC Second Edition, IBM PC/TRS-80 version, image-only structured-basic-pc-trs80 Planned instructional PC/TRS-80 BASIC profile after Microsoft-family and TRS-80 behavior are scoped. Not Dartmouth sbasic.
/home/eldryoth/Work/test/basicmanuals/ZBASIC-Interactive_BASIC_Compiler.pdf Zedcor ZBasic Interactive BASIC Compiler manual, fourth edition, 1987, searchable PDF zbasic-1987 Planned multi-platform interactive BASIC compiler profile. Covers MS-DOS, Apple DOS 3.3, Apple ProDOS, Macintosh, CP/M/Z80, and TRS-80 appendices.
/home/eldryoth/Work/test/basicmanuals/Microsoft QuickBASIC 1.01 Manual.pdf Microsoft QuickBASIC Compiler manual for IBM Personal Computers and compatibles, image-only quickbasic-101 Planned early Microsoft QuickBASIC Compiler profile. The visible title page says "Microsoft QuickBASIC Compiler"; the 1.01 version label comes from the file/manual identification.
/home/eldryoth/Work/test/basicmanuals/Microsoft_QuickBASIC_4.5_2nd_Edition_Manual.pdf Microsoft QuickBASIC Version 4.5 manual for IBM Personal Computers and compatibles, searchable PDF quickbasic-45 Planned Microsoft QuickBASIC 4.5 profile. Do not collapse into QBasic or generic quickbasic without an explicit compatibility decision.

Reserved Dartmouth Dialects

These names stay reserved because they are part of the known Dartmouth line, but they are not part of the fixed 1.0.0 support set:

  • dartmouth-basic-3
  • dartmouth-basic-5
  • dartmouth-basic-6
  • sbasic
  • dartmouth-basic-7
  • dartmouth-basic-ansi

If a matching manual appears, map it here and add it as a later compatibility release unless the project explicitly reopens the first-stable support boundary.

Planned BASIC Dialect Names

  • ansi-basic: ANSI X3.113-1987 / Full BASIC.
  • ecma-basic-1: ECMA-116 BASIC-1.
  • ecma-basic-2: ECMA-116 BASIC-2.
  • altair-basic-1975: MITS Altair BASIC Reference Manual, 1975.
  • microsoft-basic-80-50: Microsoft BASIC-80 / MBASIC release 5.0 and later.
  • ibm-pc-basic-110: IBM Personal Computer BASIC release 1.10.
  • commodore-64-basic-v2: Commodore 64 BASIC V2 / CBMBASIC.
  • commodore-basic-70: Commodore 128 BASIC 7.0.
  • atari-2600-basic-programming: Atari 2600 BASIC PROGRAMMING cartridge.
  • atari-st-basic-enhanced: Enhanced Atari ST BASIC.
  • nec-n60-basic: NEC PC-6001 N60-BASIC.
  • nec-n82-basic: NEC PC-8300 N82-BASIC.
  • cdc-basic-v2: Control Data BASIC Language Version 2 for CYBER 170, CYBER 70, and 6000 systems.
  • structured-basic-pc-trs80: South-Western Structured BASIC, Second Edition, for IBM PC compatibles and TRS-80 Models III/4.
  • zbasic-1987: Zedcor ZBasic Interactive BASIC Compiler, fourth edition.
  • quickbasic-101: early Microsoft QuickBASIC Compiler for IBM Personal Computers and compatibles.
  • quickbasic-45: Microsoft QuickBASIC Version 4.5 for IBM Personal Computers and compatibles.

ecma-basic should not be used as a public compiler dialect because ECMA-116 defines two different BASIC subsets. The graphics module should be handled as a documented feature/module decision once the core ECMA dialects exist.

structured-basic-pc-trs80 should stay separate from Dartmouth sbasic. Dartmouth sbasic refers to the 1975 Structured BASIC line and still needs a Dartmouth-specific primary source. The South-Western book is an instructional structured-programming BASIC text for IBM PC and TRS-80 systems.

cdc-basic-v2 should stay separate from Dartmouth profiles and later microcomputer BASIC dialects. It is a Control Data timesharing BASIC with SCOPE, KRONOS, and NOS operating-environment behavior, plus files, matrix operations, and error processing.

altair-basic-1975 should stay separate from later Microsoft BASIC, QuickBASIC, and generic BASIC profiles. The manual identifies MITS Altair BASIC as a licensed product, credits Bill Gates, Paul Allen, and Monte Davidoff as joint authors of the Altair BASIC interpreter, and documents direct/indirect commands, line-numbered programs, terminal and paper-tape workflows, 4K/8K constraints, Extended BASIC notes, ACR loading, and BASIC/machine-language interfaces.

microsoft-basic-80-50 should stay separate from Altair BASIC, IBM PC BASIC, QuickBASIC, and generic Microsoft BASIC aliases. The manual identifies Microsoft BASIC-80 release 5.0 and later, with 8K, Extended, and Disk versions for 8080/Z80-era systems. It also documents operating-environment behavior for CP/M, ISIS-II, TEKDOS, Intel SBC/MDS systems, standalone disk BASIC, conversion from earlier BASICs, BASIC-86 comparison notes, and Microsoft BASIC Compiler compatibility notes.

ibm-pc-basic-110 should stay separate from Altair BASIC, QuickBASIC, QBasic, and generic Microsoft BASIC profiles. The manual identifies IBM Personal Computer BASIC release 1.10 as three upward-compatible interpreter versions: Cassette BASIC, Disk BASIC, and Advanced BASIC. The public compiler profile may later split these into narrower selectors such as ibm-cassette-basic-110, ibm-disk-basic-110, and ibm-basica-110 once profile gating is designed. The manual covers graphics, sound, light pen and joystick support, disk I/O, communications, machine-language subroutines, and BASIC Compiler compatibility notes.

commodore-64-basic-v2 should stay separate from Commodore PET BASIC, Commodore 128 BASIC 7.0, and generic Commodore BASIC profiles. The local HPBooks / Knight-Ridder Press beginner source identifies Commodore 64 BASIC V2, also called CBMBASIC, and covers C64-specific keyboard modes, character sets, screen-display codes, ASCII codes, disk and cassette files, printer use, sprites, bit graphics, sound, and music. A Commodore vendor reference is still preferred before this profile is marked complete.

commodore-basic-70 should stay separate from Commodore 64 BASIC V2, generic Commodore BASIC, and later Microsoft BASIC profiles. The local book is a third-party TAB Books techniques source for Commodore 128 BASIC 7.0 and covers C-128 BASIC features such as DOS commands, relative files, TRAP, graphics, sprites, animation, music, sound, and C-64/C-128 compatibility concerns. A vendor reference manual is still preferred before this profile is marked complete.

atari-2600-basic-programming should stay separate from Atari 8-bit BASIC and from generic Atari BASIC. The manual is for the Atari Video Computer System / Atari 2600 BASIC PROGRAMMING cartridge, uses paired Keyboard Controllers, and documents a constrained visual programming environment with PROGRAM, STACK, VARIABLES, OUTPUT, STATUS, and GRAPHICS regions. It includes cartridge-specific commands/functions such as KEY, NOTE, PRINT, GRAPHICS movement through HOR/VER variables, HIT/ELSE behavior, MOD arithmetic, two-digit numeric limits, and console switch behavior.

atari-st-basic-enhanced should stay separate from Atari 8-bit BASIC, Atari 2600 BASIC PROGRAMMING, and generic Atari BASIC profiles. The local Atari quick reference covers Enhanced ST BASIC for the Atari ST, GEM/TOS integration, conversion from earlier ST BASIC and non-ST BASIC dialects, 32-bit integers, IEEE floating point, structured FOR/NEXT and WHILE/WEND restrictions, GEMDOS, GEMSYS, VDISYS, and ST-specific graphics/window variables. The SYBEX Understanding Atari ST BASIC Programming book and the Data Becker / Abacus ST BASIC Training Guide are useful supplemental sources for examples, GEM usage, graphics, disk handling, command lists, reserved words, and error lists. The complete ST BASIC Sourcebook and Tutorial is still preferred before this profile is marked complete.

nec-n60-basic should stay separate from NEC N88-BASIC, generic NEC BASIC, and generic Microsoft BASIC profiles. The local OCR PDF identifies PC-6001, N60-BASIC, and NEC front matter. Because this is a Japanese NEC microcomputer profile, implementation must explicitly decide source encoding, keyboard/input behavior, kana and graphics character handling, and diagnostics for unsupported machine-specific operations before exposing a public selector.

nec-n82-basic should stay separate from NEC N60-BASIC, NEC N88-BASIC, generic NEC BASIC, and generic Microsoft BASIC profiles. The manual identifies the NEC PC-8300 N82-BASIC Reference Manual and describes Microsoft's N82-BASIC language as developed specifically for the PC-8300. It covers direct and program modes, LCD screen behavior, full-screen editing, TEXT and TELCOM integration, memory-bank file handling, N82-BASIC commands/statements/functions, machine-language programming, error messages, sample programs, memory maps, control codes, character codes, and escape sequences.

zbasic-1987 should stay separate from Microsoft QuickBASIC, Microsoft BASIC-80, and generic compiled BASIC profiles. The manual identifies ZBasic as a Zedcor interactive BASIC compiler with fourth-edition documentation from April 1987. It includes shared language reference material plus machine appendices for MS-DOS, Apple DOS 3.3, Apple ProDOS, Macintosh, CP/M/Z80, and TRS-80 Model 1/3/4 variants. Implementation should decide whether platform appendices become subprofiles before exposing a public selector.

quickbasic-101 should stay separate from quickbasic-45, QBasic, and from any future generic quickbasic alias. The manual describes the early Microsoft QuickBASIC Compiler as a compiler-oriented product for users familiar with the Microsoft BASIC 2.0 interpreter, BASICA, or compatible interpreter manuals. OCR confirms compiler/interpreter differences, alphanumeric labels, metacommands, linking, run-time libraries, structured programs, subprograms, COMMON, CHAIN, and assembly-language subroutines.

quickbasic-45 should also stay separate from QBasic and from any future generic quickbasic alias. The manual covers the QuickBASIC 4.5 programming environment, compiler, stand-alone executable generation, procedures, modules, Quick libraries, graphics, file I/O, user-defined types, and BASICA/GW-BASIC conversion notes.