Files
gw-basic-2026/docs/development.md
Eremey Valetov 3fa8c6f034 Implement EDIT statement and ON TIMER/ON KEY event trapping, update to v0.9.0
Add event-driven programming: ON TIMER(n) GOSUB with TIMER ON/OFF/STOP,
ON KEY(n) GOSUB with KEY(n) ON/OFF/STOP for F1-F10. Fix F-key escape
sequence parser (F9/F10 detection, push back consumed bytes on unmatched
sequences). Add EDIT statement for TUI line editing. Guard key trap
polling so keystrokes aren't consumed when no traps are configured.
2026-02-27 17:29:09 -05:00

1.7 KiB

Development

Development History

Version Commit Description
0.1.0 d8e8375 Expression calculator with direct mode
0.2.0 6162595 Variables, arrays, program storage, control flow
0.3.0 c2d73e9 File I/O, PRINT USING, SAVE/LOAD, MID$ assignment, graphics stubs
0.4.0 df5c308 CHAIN, RUN "file", random-access I/O (FIELD/PUT/GET), CVI/CVS/CVD/MKI$/MKS$/MKD$
0.5.0 ad21350 Full-screen TUI editor, KEY statement, Ctrl+Break, Sixel graphics, SOUND/BEEP/PLAY, DOSBox-X compat testing, project rename
0.6.0 ece018d DATE$/TIME$/TIMER, FILES, SHELL, CHDIR, MKDIR, RMDIR
0.7.0 da6b513 AUTO, RENUM (with GOTO/GOSUB patching), DELETE, COMMON, LIST range fix
0.8.0 c68167c Dynamic TUI screen buffer, --full flag, LPRINT/LLIST with --lpt
0.9.0 EDIT statement, ON TIMER/ON KEY event trapping, F-key escape parser fixes

Tests

56 test programs in tests/programs/. Run the full suite:

bash tests/run_tests.sh

Each test has a 5-second timeout. When .expected files are present (generated from real GWBASIC.EXE), the runner also reports compatibility match status.

Compatibility Testing

Compare output against real GWBASIC.EXE running under DOSBox-X:

# Generate .expected files from GWBASIC.EXE (requires DOSBox-X Flatpak)
bash tests/run_compat.sh --generate

# Compare gwbasic output against .expected
bash tests/run_compat.sh

CI

GitHub Actions runs on every push to main and on pull requests. The workflow builds the project with PulseAudio support and runs all 56 test programs.

See .github/workflows/ci.yml.