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
+105
View File
@@ -0,0 +1,105 @@
*** Area: ZX.SPECTRUM Date: 4 Feb 03 16:20:59
*** From: Ivan Mak (2:5030/529.24)
*** To : Vadik Akimoff
*** Subj: Sprinter
ਢ¥âáâ¢ãî ‚ á, Vadik!
<Monday February 03 2003> <20:21> Vadik Akimoff wr®te to Ivan Mak:
IM>> Š®â®pë© ­  3 ï祩ª¨ ª®p®ç¥ 祬 â®â ¦¥ ª®­âp®««¥p ª« ¢¨ âãpë, ­®
IM>> ¡¥§ «¨è­¥© ®¤­®ªp¨áâ «ª¨.
VA> —â®, ª®­â஫«¥à § ­¨¬ ¥â 3 ï祩ª¨? ˆ«¨ ®­ ¡¥§ ¤ ¡«-¡ãää¥à¨­£ ? :)
’ë ¯p¨ç¨­ã ­¥®¡å®¤¨¬®á⨠"¤ ¡«-¡ãä¥p¨­£ " ­  ª« ¢¥ §­ ¥èì? :-)
Ž­  ¢ ⮬, çâ® ª®­âp®««¥p _­¥ ãᯥ¢ ¥â_...
‹Œ í⮣® ­¥ ­ã¦­®, ¯®â®¬ã çâ® ®­  _ãᯥ¢ ¥â_.
H ¦ â¨¥ ª« ¢¨è¨ - íâ® § ¬ëª ­¨¥ ª«îç . ‚ ‹Œ á奬  ¢ 40 ª«î祩 ¨ ¢á¥!
(p §ã¬¥¥âáï, ¢  «ìâ¥p¥ ­¥ â㯮 40 ª«î祩, ­® í⮠㦥 ­¥ ¨¬¥¥â §­ ç¥­¨ï)
IM>> ƒë-£ë... H¥... â® § ¬¥­  ¨§¢p â  á ¯«¨á¨­®© ­  ¨§¢p â á
IM>> ª®­âp®««¥p®¬... ޤ­  䨣­ï... ‚ ¯«¨á¨­¥ ᢮© _ª®­âp®««¥p_.
VA> Ž­ å®âï ¡ë ¯® ®è¨¡ª¥ ¯à¨ñ¬  ¡ ©â  á ª« ¢¨ âãàë ¬®¦¥â ᪠§ âì ¥©
VA> '¯¥à¥¯®è«¨-ª  ¯®á«¥¤­¨© ¡ ©â'? …᫨ ­¥ ¬®¦¥â -> íâ® ­¥ ª®­â஫«¥à,  
VA> ­ ¡®à ¦ñá⪮© «®£¨ª¨ :)
Hã, ®ç-ç¥­ì ¨­â¥p¥á­ ï «®£¨ª  ®¯p¥¤¥«¥­¨ï ⮣®, çâ® "­¥ ª®­âp®««¥p" :-))
IM>> H¨ 䨣 . „«ï í⮣® ­ ¤® pi/2 ï祥ª ¯«¨á¨­ë ¢ª«îç¨âì... p®áâ®
IM>> § ¢¥á⨠ᨣ­ « § ¯¨á¨ ¢ އ“ ª®­âp®««¥p  ª« ¢ë,   ¤ «ìè¥ ¯¨è¨ ª
IM>> ­¥© ¯p®£p ¬¬ë ᪮«ìª® ¢«¥§¥â ¨ «î¡®© p¥¬ ¯... ˆ ­¥ ®¡ï§ â¥«ì­®
IM>> ¥£® ¢ eeprom, ¬®¦­® ¨ ­  ¢¨­â...
VA> €£ , 祣®©-â® ­  ®ää⮯¨ª¥ ª®­ä¨£ ¡¨®á  ­¥ ­  ¢¨­â¥ åà ­ïâ.
€ â ¬, ¯®-⢮¥¬ã, p¥¬ ¯¯¨­£ ª« ¢¨è ¢ CMOS § áã­ãâ? :-( )
Š®­ä¨£ ¡¨®á  - íâ® ­¥¬­®£® ¤pã£ ï ¢¥éì...
VA> Š â®¬ã ¦¥, âë ¢¥¤ì íâ®â ᨣ­ « ­¥ § ¢ñ«? ‡­ ç¨â - £¨¡ª®á⨠­¥â.
Ÿ ¥£® ­¥ § ¢¥« ⮫쪮 ¯®â®¬ã, çâ® ­¥ á¯p®á¨«¨. € á ¬ ᨣ­ « ¥áâì...
Ž­ § p¥§¥p¢¨p®¢ ­ ¨ ­¥ ¯®¤ª«î祭 ⮫쪮 ¤«ï ¨§¡ ¢«¥­¨ï ®â ¢®§¬®¦­ëå £«îª®¢...
VA> ’¥¬ ¡®«¥¥, çâ® ¢®§¬®¦­®áâì ᤥ« âì £¨¡ª¨© ६ ¯ ª« ¢¨ âãàë âë ­¥
VA> ¯à¥¤ãᬮâ५ ¨ ­¥ ᮡ¨à ¥èìáï, ¤à㣨¬ í⮠ᤥ« âì ­¥ ¤ èì ⥬
VA> ¡®«¥¥...
€ í⮠㦥 ­ £«®¥ ¢p ­ì¥!
VA>>> ‚®-¢®, ¯®ª  â®, ¯®ª  áñ, ¯®ª  á奬㠡㤥èì ¯«¨á¨­ë
VA>>> ¯¥à¥«®¯ ç¨¢ âì...
IM>> €£ , ¯®ª  ª®­âp®««¥p ¡ã¤¥èì ¯¥p¥¯p®£p ¬¬¨p®¢ âì... - ®¤­ 
IM>> 䨣­ï...
VA> —â®? 10 ᥪ㭤 ­  ¯¥à¥§ £à㧪㠯à®è¨¢ª¨...
ˆ íâã ­®¢ãî ¯p®è¨¢ªã âë §  10 ᥪ㭤 ᤥ« ¥èì??
€ ᠬ㠯p®è¨¢ªã ¢ ¯«¨á¨­ã ï ¨ §  0.5 ᥪ㭤 § «ìî...
[skip ¯p® ¬ëèì]
VA> …éñ ®¤¨­ '¯¨ª®¯à®æ¥áá®à' £®à®¤¨âì ¡ã¤¥èì ¨«¨ ¯à¨¤¥« ¥èì ª 㦥
VA> ¨¬¥î饬ãáï ¤«ï ª®¬¬ë誨? ˆ«¨ ã â¥¡ï ª®¬¬ë誠 ¡¥§ ®­®£® ¨ ¤ ¦¥ ­¥
VA> ¨­â¥à¯®«¨àã¥âáï?
Š ª®© ¯¨ª®¯p®æ¥áá®p? ‘ ¬ëè¨ ¡ ©âë ¨¤ãâ,   çâ® ¢ ª ª®¬ ¡ ©â¥ - p §¡¨p ¥âáï
á¨á⥬ ,   ­¥ ¯«¨á¨­ ...
IM>> €£  :) H  42-å ¬¥£ £¥pæ å â®p¬®§¨â ¨ ¯¨é¨â â ª, çâ® ®â AY ­¥
IM>> ®â«¨ç¨èì :-))
VA> ‡­ ç¨â â ª¨ â®à¬®§¨â, ⮫쪮 ¡ëáâà®,   çâ® ­¥ ®â«¨ç¨èì - â ª íâ®
VA> ®â­®á¨â¥«ì­®... ®¬­¨âáï, ­  䠭⮯¥ âë ⮦¥ £®¢®à¨«, çâ® ®âáãâá⢨¥
VA> ®£¨¡ î饩 - ­¥ ¡¥¤ ...
ˆ ¯p ¢¨«ì­® £®¢®p¨«. _H¥ ¡¥¤ _. ®â®¬ã çâ® ®£¨¡ î騥 ¢ AY 㦥 3 £®¤  ª ª
ᤥ« ­ë.
IM>> Š ª-â® áâp ­­® âë £®¢®p¨èì. ‚ ª« ¢¥ ⥡¥ ª®­âp®««¥p ¯®¤ ¢ ©,   ¢
IM>> AY ­¥ å®ç¥èì?
VA> Šáâ â¨, ¥áâì â ª¨¥ ª®­â஫«¥àë - msp430, ®­¨ ¯®§¢®«ïîâ ¯®«-ayª  ­ 
VA> ¢áâ஥­­ëå áçñâ稪 å á«¥¯¨âì...
€ ¥é¥ ¥áâì AY-3-8910, ¢ ­¥¬ æ¥«ë© AY :-))
IM>>>> H®p¬ «ì­® ⮫쪮 ­  ç¨á⮬ Z80...
VA>>> Hã ¢®â, ¯®â®¬ã ¥£® ¨ ­ ¤® à冷¬ ¯®áâ ¢¨âì :)
IM>> Ž­ ¨ á⮨â. ’®«ìª® á ¤®¯.¯®pâ ¬¨ ­  ªp¨áâ ««¥.
VA> ˆ ¡¥§ ­¥¤®ªã¬¥­â¨à®¢ ­­ëå ª®¬ ­¤ ¢ ­ñ¬ ¦¥ :)
‚p ­ì¥! H¥ ¢¨¤¥« ­¨ ®¤­®© ­¥¤®ªã¬¥­â¨p®¢ ­­®© ª®¬­ ¤ë,
ª®â®p ï ¡ë p ¡®â «  ­  Z84C00 ¨ ­¥ p ¡®â «  ­  Z84C15...
à®â®áë á¡¥¦ «¨. ‡¥à£¨ § ª®¯ «¨áì. ®à  ¨ ¬­¥ § ªà㣫ïâìáï. Ivan.
-  §¢®¤¨áì á奬ª , ¡®«ìè  ¨ ¬ «¥­ìª ... [Sprinter] Sprinter-II [Forth-CPU]
... ivan_mak@mail.ru * http://winglion.spb.ru * http://www.petersplus.ru
--- GoldED+/386 1.0.0
* Origin: The Sprinter has You! (2:5030/529.24)