Document TI-99/4A controller limits and keyboard shortcuts in README

Joystick buttons beyond the first only reach digit keys 1-9 in
ti99sim-sdl's own source (src/sdl/ti994a-sdl.cpp) - there's no path to
0, Enter, Q, or Esc from a gamepad. Documents the real Esc-to-exit
behavior and full FCTN key row (Alt+1 through Alt+9, Alt+=), both
confirmed against the emulator's own bundled doc/README.html.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VLX1yYKJExGSXmgUhxKQG6
This commit is contained in:
Claude
2026-09-03 14:39:48 +00:00
parent e3874b2ebe
commit 9714bfca2e
+13
View File
@@ -3824,6 +3824,19 @@ when the TI-99/4A prompt ran, the installer offered to copy it there for
you (tab-completing path prompt); otherwise copy it there by hand. Then
just drop \`.ctg\`/\`.rpk\`/\`.bin\` cartridge files into \`roms/ti994a/\`.
**Controls.** \`ti99sim-sdl\` maps a real gamepad's stick to the TI-99
joystick directly, and any joystick button beyond the first (the fire
button) to the number keys 1-9 (confirmed against its own source —
\`( VIRTUAL_KEY_E ) ( VK_0 + std::clamp(( int ) event.jbutton.button, 1, 9 ))\`
in \`src/sdl/ti994a-sdl.cpp\`) — there's no source-level path from a
joystick button to 0, Enter, Q, or Esc, so those need a real keyboard
reaching the stream. **Esc exits the emulator** (confirmed against its
own bundled \`doc/README.html\`) and hands focus back to ES-DE once the
process closes. The TI-99/4A's own FCTN function-key row, for anything
needing keys beyond what a joystick provides, is (also confirmed
against that same doc): Alt+1 DEL, Alt+2 INS, Alt+3 ERASE, Alt+4 CLEAR,
Alt+5 BEGIN, Alt+6 PROC'D, Alt+7 AID, Alt+8 REDO, Alt+9 BACK, Alt+= QUIT.
## MAME: sample packs showing up as games
MAME sample packs (audio for a handful of older analog-sound games) use the
exact same \`.zip\`-per-game naming as real ROMs, so if they're sitting in