Files
gw-basic-2026/docs/index.md
T
Eremey Valetov c488cb526d Update Sphinx docs with v0.14.0 roadmap and fix stale references
Expand roadmap with detailed implementation plans for the next three
features: MBF binary file compatibility (token-stream conversion at
load/save boundary), hardware I/O simulator (portio.c with PIT/speaker/
CGA/joystick port emulation), and DRAW command fixes (M parsing bug,
scale semantics, A rotation, TA/variable substitution). Remove hardware
I/O from known limitations (moving to planned). Fix stale test counts
(64 -> 66) and version string (0.11.0 -> 0.13.0) across docs.
2026-03-11 08:11:13 -04:00

1.6 KiB
Raw Blame History

GW-BASIC 2026

A portable C reimplementation of Microsoft GW-BASIC, using the original 8088 assembly source (released by Microsoft in 2020) as the authoritative reference.

This is not a transpilation — it reimplements the algorithms in clean C11 with modern data structures while targeting bug-compatible behavior. Unlike the original assembly (43,771 lines across 43 .ASM files), this version is structured as modular C suitable for new feature development.

Highlights

  • Authentic full-screen editor — dynamically sized screen buffer (25×80 default, full terminal with --full), free cursor movement, Enter-on-any-line, F1-F10 function keys, Insert/Overwrite toggle
  • Binary and ASCII file formatsSAVE writes tokenized binary by default, LOAD auto-detects format (just like the real thing)
  • INKEY$ extended keys — arrow keys, F-keys, and navigation keys return proper CHR$(0) + scan code two-byte sequences
  • Sixel graphicsSCREEN 1/SCREEN 2 rendering in compatible terminals
  • SoundSOUND, BEEP, PLAY (MML) via PulseAudio
  • Full file I/O — sequential, random-access, SAVE/LOAD/MERGE/CHAIN/COMMON
  • Printer outputLPRINT/LLIST to file or real hardware via --lpt
  • Classic programs — Hamurabi, Lunar Lander, Gunner, and Diamond from David Ahl's BASIC Computer Games (1978) run out of the box
  • 66 test programs with golden-file regression testing and DOSBox-X compatibility testing against real GWBASIC.EXE
  • MIT License
:maxdepth: 2

getting-started
language-reference
architecture
development
roadmap