Add full compiler toolchain, libc, examples and reference docs

First substantive commit: the entire Sprinter C compiler tree on top of
the bare README+gitignore initial commit.

What's in here:
  bin/sprinter-cc        — driver script invoking SDCC + linker + mkexe
  libc/                  — Sprinter-specific libc layer over ESTEX/BIOS
                           (conio, gfx, io, mem, stdio + headers)
  runtime/               — crt0 variants (default/small/banked/minimal)
                           + heap + bank trampolines
  toolchain/             — mkexe (SprintEXE packer, C + tests)
  examples/              — 30 demo programs (gfx, file I/O, env, time, …)
  lib/Makefile           — builds the libc archive (sprinter.lib)
  docs/                  — converted Sprinter manuals + asm reference samples
  third_party/           — solid-c reference compiler dump + sdcc setup script
  release_docs/          — packaging / release notes

gitignore overhaul:
  • Drop dangerous blanket patterns: *.asm (would hide docs/samples/*.asm)
    and *.exe (case-insensitive match was hiding third_party/solid-c/*.EXE
    on macOS APFS).  Replaced with examples/*/*.{asm,exe,…} and lib/*.lib.
  • Restore tracking of toolchain/mkexe/tests/{one,big}.bin — those are
    INPUT fixtures, not build outputs.
  • Collapse the duplicated SDCC/C/Sdcc sections into one section per
    concern (build outputs / vendored / OS-junk).
  • Add .sprinter-cc-*/, build/ (catches lib/build/ too), .claude/.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
2026-06-03 16:13:21 +03:00
parent f542608b3f
commit c71e249a4e
404 changed files with 75155 additions and 58 deletions
+86
View File
@@ -0,0 +1,86 @@
*** Area: ZX.SPECTRUM Date: 19 Mar 01 1:02:50
*** From: Ivan Mak (2:5030/529.24)
*** To : Stanislav Udin
*** Subj: Ž ‘¯p¨­â¥p¥.
ਢ¥âáâ¢ãî ‚ á, Stanislav!
<Sunday March 18 2001> <23:48> Stanislav Udin wr®te to Ivan Mak:
IM>> Œ © ¬¥áïæ, ¥á«¨ ­¥ ¡y¤¥â ­ ¢®¤­¥­¨©, §¥¬«¥âpïᥭ¨© ¨ â.¯.
IM>> ª â ª«¨§¬®¢, ­ ¯®¤®¡¨¥ ®¡­ py¦¥­¨ï ªpy¯­ëå £«îª®¢ ¢ ¯« â¥....
SU> ‚ ¯p¨­æ¨¯¥ áp®ª ¤®áâ â®ç­® ­¥ ¡®«ì让.
Hã â ª ¢¥¤ì p ¡®â ¥¬ :)
IM>> †¤¥èì ᥪy­¤ë 2-3 ¯®ª  ­¥ § £py§¨âáï system.bat á ¯p®¯¨á ­­ë¬
IM>> ¢ ­¥¬ scorpion.exe
IM>> ®á«¥¤­¥£®, ¯p ¢¤ , ­¥â, ­® ª ¦¤ë© ª®¤¥p ᬮ¦¥â ­ ¯¨á âì,
IM>> ¥á«¨ ¡y¤¥â ­¥ «¥­ì ¯®âp â¨âì ¤¥­ì...
SU> â® ¡y¤¥â £¤¥-­¨¡y¤ì ¤®ªy¬¥­â¨p®¢ ­®?
„®ªã¬¥­â¨p®¢ ­®, ª ª ¯®¤ª«îç âì ¢¬¥áâ® áâ ­¤ âp­®© ¯p®è¨¢ª¨ ‡“ «î¡ãî
¤pã£ãî. € p á¯p¥¤¥«¥­¨¥ ¯ ¬ï⨠¨ ¯®¤ª«î祭¨¥ ‡“ ¯® 1FFD â ª®¥ ¦¥ ª ª ¢
‘ª®p¯¨®­¥, §  ¨áª«î祭¨¥¬ ­¥ª®â®pëå ¬¥«ª¨å ¤¥â «¥© (¢ ‘ª®p¯¨®­¥, ¥á«¨ ¬­¥ ­¥
¨§¬¥­ï¥â ¯ ¬ïâì, ¯p¨ ¢ª«î祭­®© ¡ ­ª¥ 0 ¯®pâë TR-DOS § ªpëâë,   ¢ ‘¯p¨­â¥p¥
®­¨ ®âªp®îâáï ¯p¨ ¢å®¤¥ ¢ ®¡« áâì #3dxx) ¨ § ªp®îâáï ⮫쪮 ¯p¨ ¢ë室¥
¯p®£p ¬¬ë
¨§ 0-© ¡ ­ª¨.
SU> ‚ â ª®¬ á«yç ¥ ¢®¯p®á á«¥¤yî騩. ƒ¤¥-­¨¡y¤ì ç¥p¥§ £®¤ ­¥ª¨© ¬y§ëª ­â
SU> ­ å®¤¨â ®è¨¡ªy ¢ í¬y«ï樨 AY, ®¡p é ¥âáï ¢ ¥â¥pá,   â ¬ ¥¬y £®¢®pïâ,
SU> çâ®, ¬®«, ¨§¢¨­¨, ­® ¬ë ¡®«ìè¥ ‘¯p¨­â¥p ¬¨ ­¥ § ­¨¬ ¥¬áï. ‘ª®«ìª®
SU> 祫®¢¥ª, ªp®¬¥ â¥¡ï ¯®¤¤¥p¦¨¢ îâ ¨¤¥®«®£¨î ‘¯p¨­â¥p  ¢ ¥â¥pᥠ¨ ­ 
SU> ᪮«ìª® ¢p¥¬¥­¨ 墠â¨â í­ây§¨ §¬ ?
­â㧨 §¬  墠⠥â. ‘®¢á¥¬ ­¥¤ ¢­® ¡ë« ¯p¨­ïâ ¥é¥ ®¤¨­ 祫®¢¥ª ¨¬¥­­®
¤«ï p ¡®âë ¯® ⥬¥ ‘¯p¨­â¥p . Šp®¬¥ ⮣® ¨¬¥¥âáï ¯ çª  § ª §®¢,
ç⮠ᥩç á ¦¤¥â ¬ ©áª¨å ¯« â.
IM>> ¥ «¨§ æ¨ï ª¥¬¯áâ®­  ¢ â¥ç¥­¨¥ í⮣® £®¤ . ®«¥¥ â®ç­® ¢pï¤ «¨
IM>> ᪠¦y...  p¨ ­â, çâ® ®ª ¦¥âáï y¦¥ ¢¬¥áâ¥ á ¯« â®© ª ¬ î ­¥
IM>> ¨áª«îç î...
SU> € ®â ª®£® íâ® § ¢¨á¨â?
â® § ¢¨á¨â ®â ¬®¥© £®«®¢ë. …᫨ á㬥¥â ᤥ« âì ¡ëáâp®, §­ ç¨â ¡ã¤¥â ¡ëáâp® :)
SU> ˆ§ í⮩ ¨ ¯®á«¥¤yîé¨å äp § ï ¯®­¨¬ î, çâ® p ¬-¤¨áª®¢ ¬®¦¥â ¡ëâì
SU> ­¥áª®«ìª®, ¤«ï ª ¦¤®£® ¤¨áª®¢®¤  ᢮©?
 ¬-¤¨áª®¢ ¤® 16-⨠èâ. Ž¡ê¥¬ ª ¦¤®£® ªp â¥­ 16ª¡ ¨ ¢ á㬬¥ ­¥ ¯p¥¢ëè ¥â
~3.4Mb. Žáâ «ì­ ï ¯ ¬ïâì ¨á¯®«ì§ã¥âáï ¢ p §­ëå ¬¥áâ å ¨ § ­ïâ  ¯®áâ®ï­­®.
®¤ª«îç âìáï ª ¤¨áª®¢®¤ ¬ ®­¨ ¬®£ãâ ª ª 㣮¤­®, â.¥. ¯p®£p ¬¬  ¬®¦¥â ¯®
᢮¥¬ã ãᬮâp¥­¨î ¯®¤ª«îç¨âì/®âª«îç¨âì «î¡®© p ¬¤¨áª ®â ⥪ã饣® ¤¨áª®¢®¤ .
p¨ ­¥®¡å®¤¨¬®á⨠¬®¦­® ¯®¤ª«îç¨âì å®âì ª® ¢á¥¬ ç¥âëp¥¬ ¤¨áª®¢®¤ ¬ ç¥âëp¥
p ¬¤¨áª ...
SU> H¥ ᫨誮¬ ¬­®£® :( € ¯®ç¥¬y â ª ¬ «® p¥ª« ¬ë? Š®¬¯ìîâ¥p áy¤ï ¯®
SU> ¢á¥¬y ¢¥á쬠 ­¥¯«®å®©, 業  ¢¯®«­¥ ¯p¨¥¬«¥¬ ï. ®ç¥¬y ¦¥ ¢á¥£® 25
SU> ¯®«ì§®¢ â¥«¥©? —¥¬ ¡®«ìè¥ p¥ª« ¬ë, ⥬ ¡®«ìè¥ ¯®«ì§®¢ â¥«¥©
SU> áâ ­¤ pâ­ëå ¢®§¬®¦­®á⥩ ‘¯¥ªâpy¬  ­  ‘¯p¨­â¥p¥,   ¢ ¤ «ì­¥©è¥¬ ®­¨
SU> ¬®£«¨ ¡ë § ¤¥©á⢮¢ âì ¨ ®áâ «ì­ë¥ p¥ááypáë ¬ è¨­ë. ‚®â §¤¥áì
SU> ­¥ª®â®pë¥ ¢®®¡é¥ ­¥ á«ëè «¨ ¯p® ‘¯p¨­â¥p.  §¢¥ íâ® ¯p ¢¨«ì­®? H¥
SU> ¬­®£¨¥ §­ îâ, çâ® á¯p¨­â¥p¥ ¬®¦­® ªy¯¨âì ¯® ¯®çâ¥. â® ¢ è¨ y¯y饭¨ï.
‚ íå¥ p¥ª« ¬ë ¡ë«® ­¥ ¬ «® (¬®¦¥â, ª®­¥ç­®, ¨ ­¥ ¤®áâ â®ç­®). ë«  ¨
¢ ¤pã£¨å ¬¥áâ å, ¢ í«¥ªâp®­­ëå ¨§¤ ­¨ïå. ‘¥©ç á ­ ¨¡®«ìè ï p¥ª« ¬­ ï
­ £p㧪  ¢ ¨­â¥p­¥â¥, ¨ ¤¥«® ¯®á⥯¥­­® ¤¢¨¦¥âáï...
SU> ˆ ¯®á«¥¤­¨© ¢®¯p®á. Œ®¦­® «¨ ¯¥p¥¢¥á⨠¤¥­ì£¨ §  ‘¯p¨­â¥p ¯® ¡¥§­ «y,
SU> ª ª ®â í⮣® ¡y¤¥â § ¢¨á¥âì æ¥­  ¨ áp®ª¨?
® ¯®¢®¤ã ¡¥§­ «  ¨ ᮮ⢥âáâ¢ãî饩 業ë, «ãçè¥ áp §ã ®¡p â¨âìáï ¯®  ¤p¥áã
peters@atlant.ru ï ¯® í⨬ ¢®¯p®á ¬ ­¥ ¢ ªãpá¥. „®£®¢ p¨¢ âìáï ® ¯®ªã¯ª¥, ¢
«î¡®¬ á«ãç ¥, ¨¬¥­­® ¯® íâ®¬ã  ¤p¥áã.
‘p®ª ­¥ ¤ã¬ î, çâ® áãé¥á⢥­­® ¨§¬¥­¨âáï (¯®« £ î, § ¢¨á¨â ⮫쪮 ®â
§ ¬®p®ç¥ª á ¯p®å®¦¤¥­¨¥¬ ¤¥­¥â ¨ â.¯. ­®, ᪮p¥¥ ¢á¥£®, í⮣® ­¥â).
à®â®áë á¡¥¦ «¨. ‡¥à£¨ § ª®¯ «¨áì. ®à  ¨ ¬­¥ § ªà㣫ïâìáï. Ivan.
-  §¢®¤¨áì á奬ª , ¡®«ìè  ¨ ¬ «¥­ìª ... [ Sprinter-II ] [Forth-CPU] [ZX]
... ivan_mak@mail.ru * http://st-rektal.chat.ru * http://www.atlant.ru/peters
--- GoldED+/386 1.0.0
* Origin: The Sprinter has You! (2:5030/529.24)