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
+110
View File
@@ -0,0 +1,110 @@
*** Area: ZX.SPECTRUM Date: 9 Apr 01 22:35:00
*** From: Alex Goryachev (2:5030/529.56)
*** To : Sergey Krinitsin
*** Subj: Sprinter News
ਢ¥âáâ¢ãî, Sergey!
Saturday April 07 2001 Sergey Krinitsin -> Alex Goryachev.
AG>> ‚®â ­  íâ®â á«ãç © ¨ ¯p¥¤ãᬮâp¥­ ¢ p¨ ­â ¨á¯®«ì§®¢ ­¨ï
AG>> ⥫¥¢¨§®p .
SK> € ¢ë á ¬¨ ¯à®¡®¢ «¨ ¯®à ¡®â âì á ⥫¥¢¨§®à®¬ ¢¬¥áâ® ¬®­¨â®à ?
SK> Žá®¡¥­­® ­  ¢ë᮪¨å à §à¥è¥­¨ïå? Œ®¦¥â ¤ ¦¥ ¯®­à ¢¨«®áì?
‘ 94 ¯® 98 £®¤ ã ¬¥­ï ¡ë«® ­¥áª®«ìª® ¬®¤¥«¥© ‘¯¥ªâp㬠 ¨ ¢á¥ ¡ë«¨ ®¡®p㤮¢ ­ë
‚— ¬®¤ã«ïâ®p ¬¨ ¯®áª®«ìªã ¢ ª ç¥á⢥ ¬®­¨â®p  ï ¨á¯®«ì§®¢ « ⥫¥¢¨§®p ¡¥§
SCART- . ®â®¬ ï ¯®¯p®¡®¢ « ¯®¤ª«î祭¨¥ ª SCART-ã ­  ¤p㣮¬ ⥫¥¢¨§®p¥ (NEC,
89 £®¤ ) ¨ ®æ¥­¨« p §­¨æã. ˆ ¬®£ã á 㢥p¥­­®áâìî £®¢®p¨âì, ç⮠ᮢp¥¬¥­­ë¥
⥫¥¢¨§®pë (  p §ê¥¬ë SCART ­  ¤p¥¢­¨å ­¥ ­ ©¤¥èì) ¢¯®«­¥ ¬®£ãâ ââìáï á
¬®­¨â®p ¬¨ ¯® ª ç¥áâ¢ã ¨§®¡p ¦¥­¨ï. € Sprinter á ⥫¥¢¨§®p®¬, ¢®â 㦥
¤«¨â¥«ì­®¥ ¢p¥¬ï, ¨á¯®«ì§ã¥â Ivan Mak.
‚®¡é¥¬ Sprinter ¯p¥¤« £ ¥âáï ¯®¤ª«îç âì ª ⥫¥¢¨§®pã ¨¬¥­­® ¢ SCART, ¢ í⮬
á«ãç ¥ ¨§®¡p ¦¥­¨¥ ¡ã¤¥â ç¥âª¨¬.
>>> ‘®§¤ ¥âáï ¢¯¥ç â«¥­¨¥, çâ® ¢ è  ä¨à¬  § âà â¨¢ ®¯à¥¤¥«¥­­ë¥
>>> á।á⢠ (¨¬å® ᮢᥬ ­¥ ¡®«ì訥), ¯ëâ ¥âáï «î묨 ᯮᮡ ¬¨
>>> á¡ £à¨âì ª®¬¯
>>> ª ª
>>> ¬®¦­® ¡®«ì襬ã ç¨á«ã «î¤¥©, ­ ¤¥ïáì ­  ¯à¨â®ª
>>> 堫®£® á®äâ , çâ®¡ë ¥é¥ ¡®«¥¥ 㢥«¨ç¨âì ¯à®¤ ¦¨. H® ¬ è¨­ 
AG>> H¥ ¡ã¤ã ®¡p é âì ¢­¨¬ ­¨¥ ­  ¨§¢p é¥­­®¥ ¯p¥¤áâ ¢«¥­¨¥
AG>> ª®¬¬¥pç¥áª¨å 楫¥© ­ è¥© ä¨p¬ë.
SK> Š®­¥ç­ ï æ¥«ì «î¡®© ŠŽŒŒ…—…‘ŠŽ‰ ¤¥ï⥫쭮áâ¨- ¯®«ã祭¨¥
SK> ¯à¨¡ë«¨.
‘ í⮩ ä®p¬ã«¨p®¢ª®© ï ᮣ« á¥­,   ¢®â á ¯p¥¤ë¤ã饩 - ­¥â.
AG>> …᫨ ªâ®-â® ¥é¥ ­¥ §­ ¥â 楫¨ ­ è¥£® ®¡é¥­¨ï ¢ í⮩
AG>> ª®­ä¥p¥­æ¨¨, â® ¯®ïá­î, çâ® ®­  á®á⮨⠭¥ ¢ ¯®¨áª¥
AG>> ¯®ªã¯ â¥«¥©,   ¢ ¦¥« ­¨¨ ¯®§­ ª®¬¨âì ¨­â¥p¥áãîé¨åáï á®
AG>> Sprinter-®¬, á ®¤­®© áâ®p®­ë, ¨ ­ ©â¨ «î¤¥©, ¦¥« îé¨å
AG>> ¯®ãç á⢮¢ âì ¢ ¯p®¥ªâ¥, á ¤p㣮©. Œë áâ p ¥¬áï á®§¤ âì
AG>> ãá«®¢¨ï ¤«ï ®¡®î¤®¢ë£®¤­®£® á®âp㤭¨ç¥á⢠.
SK> [...]
>>> ˆ ¨¬¥âì ᮢ¬¥á⨬®áâì ⮫쪮 ­  ã஢­¥ ª®¬¬ ­¤ ¯à®æ¥áá®à ? :)
AG>>  §¢¥ ï £®¢®p¨«, çâ® ®­¨ ¤®«¦­ë ¨¬¥âì ᮢ¬¥á⨬®áâì? Š ª ï
AG>> ¬®¦¥â ¡ëâì ᮢ¬¥á⨬®áâì ã "ãâ" ¨ "宫®¤¨«ì­¨ª "? Šp®¬¥
AG>> p §¢¥ çâ® ˆ­¥â®¢áª¨å ¤p ©¢¥p®¢... :)
AG>> ¥çì ¢¥¤ì ­¥ ® ¬®¤¥«ïå ª®¬¯ìîâ¥p®¢, ¥áâì ¨ ¤p㣨¥
AG>> ãáâp®©á⢠.
SK> ’®£¤  ª ª®¥ ®â­®è¥­¨¥ ®­¨ ¨¬¥îâ ª Sprinter'ã ?
Ÿ ®â¢¥ç « ­  ¢®¯p®á ® ¤ «ì­¥©è¥¬ p §¢¨â¨¨ â¥å­®«®£¨¨, ­  ®á­®¢¥ ª®â®p®© á®§¤ ­
Sprinter.
AG>> ‚ ï­¢ p¥ í⮣® £®¤  ¯p®¨§®è«¨ ¨§¬¥­¥­¨ï, ­ ¯p ¢«¥­­ë¥ ­ 
AG>> p¥è¥­¨¥ ¨ ¯p®¡«¥¬ë á¢ï§¨ á ¯®«ì§®¢ â¥«ï¬¨, ¢ ⮬ ç¨á«¥.
AG>> H è¥ ®¡é¥­¨¥ ¢ í⮩ ª®­ä¥p¥­æ¨¨ ç áâì íâ¨å ãᨫ¨©.
SK> € ¯®ç¥¬ã ¡ë ¢ ¬ ¯à®áâ® ­¥ á¯à®á¨âì 㠫©, ª ª¨¬ ¤®«¦¥­ ¡ëâì
SK> Sprinter çâ®¡ë ®­¨ à¥è¨«¨ ¥£® ¯à¨®¡à¥áâ¨? ˆ ­®¢ãî ¬®¤¥«ì
SK> à §à ¡ â뢠âì ­  ®á­®¢ ­¨¨ § ¯à®á®¢ ¯®â¥­æ¨ «ì­ëå ¯®ªã¯ â¥«¥©.
Sprinter p §p ¡ â뢠«áï ¤«¨â¥«ì­®¥ ¢p¥¬ï. ’¥å­¨ç¥áª¨¥ å p ªâ¥p¨á⨪¨ ¨ p¥è¥­¨ï
­¨ª®£¤  ­¥ ¡ë«¨ â ©­®© ®â «î¤¥© ¨­â¥p¥áãîé¨åáï ¯p®¥ªâ®¬. ˆ ¯®áâ®ï­­®
¢ë¤¢¨£ «¨áì p §«¨ç­ë¥ ­®¢ë¥ âp¥¡®¢ ­¨ï ¨ ¯p¥¤«®¦¥­¨ï. H ¨¡®«¥¥ §¤p ¢ë¥ ¨¤¥¨
¢®¯«®é «¨áì ¢  på¨â¥ªâãp¥ ª®¬¯ìîâ¥p . ˆ§¬¥­¥­¨¥  på¨â¥ªâãpë ¢ ­¥ª®â®pëå
á«ãç ïå ¯p®å®¤¨«® ­¥ ᮢᥬ ¡¥§¡®«¥§­¥­­® ¤«ï p ¡®â®á¯®á®¡­®á⨠ª®¬¯ìîâ¥p  ¢
楫®¬.
ˆáá«¥¤®¢ ­¨ï âp¥¡®¢ «¨ ¢p¥¬¥­¨, â ª ª ª ¢® ¬­®£®¬ Sprinter ¡ë« ­®¢ â®p᪨¬
ª®¬¯ìîâ¥p®¬. ®áâ®ï­­® ¢®§­¨ª «¨ ᮡ« §­¨â¥«ì­ë¥ ¢®§¬®¦­®á⨠­ ¢¥p­ãâì ¬ è¨­ã
¥é¥ ¨ ¥é¥. ‚¥¤ì Sprinter ¢ëp®á ¨§ ‘¯¥ªâp㬠 ¨ ¯®«¥ ¤¥ï⥫쭮á⨠¤«ï
¬®¤¥p­¨§ æ¨¨ ¡ë«® ®ç¥­ì ¢¥«¨ª®. „ ¦¥ ᥩç á, ª®£¤  Sprinter ¨¬¥¥â ¢®§¬®¦­®áâ¨
® ª®â®pëå ¢ 96 £®¤ã ­¥«ì§ï ¡ë«® ¨ ¬¥çâ âì, ã ­¥£® ¯® ¬­¥­¨î p鸞 ¯®«ì§®¢ â¥«¥©
®áâ «¨áì á« ¡ë¥ ¬¥áâ  (­¥ 32 p §pï¤­ë© ¯p®æ¥áá®p, ­¥ SVGA-è­ë© ¬®­¨â®p).
p ¢¤  ⥯¥pì í⨠᫠¡ë¥ ¬¥áâ  ã¦¥ áp ¢­¨¢ îâ á ¢®§¬®¦­®áâﬨ PC,   ­¥
‘¯¥ªâp㬠. ;)
‚®¡é¥¬, ¯p®¥ªâ § â¢ «áï ¨ ­¥ ã ¢á¥å «î¤¥©, ªâ® ¯®¤¤¥p¦¨¢ « p §p ¡®â稪®¢
å®âï ¡ë ¬®p «ì­®, 墠⠫® â¥p¯¥­¨ï ¤®¦¤ âìáï p¥§ã«ìâ â  ¨ ¯®î§ âì ¥£®. € ª®£¤ 
ª § «®áì ¡ë ª®¬¯ìîâ¥p ¡ë« £®â®¢ ª ¢ë室㠢 ᢥâ, á«ã稫áï  ¢£ãáâ 98 £®¤ . ‚ᥬ
áâ «® ­¥ ¤® ª®¬¯ìîâ¥p®¢.
‘¥£®¤­ï, ­ è  ä¨p¬  ­ è«  ¢ ᥡ¥ á¨«ë ¤«ï á¥p쥧­®©  ªâ¨¢¨§ æ¨¨ p ¡®âë ­ ¤
¯p®¥ªâ®¬. ˆ ¬ë £®â®¢ë ª ®¡á㦤¥­¨î ¢á¥¢®§¬®¦­ëå ¢®¯p®á®¢ á¢ï§ ­­ëå á®
Sprinter-®¬. H® ­¥ã¦¥«¨ ­¥¢®§¬®¦­®áâì ­ §¢ âì Sprinter á㯥p¯ã¯¥pª®¬¯ìîâ¥p®¬,
íâ® ¯p¨ç¨­  ¤«ï ⮣® çâ® ¡ë ­¥ ¯p¥¢p é âì ¥£® ¨§ « ¡®p â®p­®£® ¯p¨¡®p  ¢
¯®«¥§­ãî ¤«ï á¥¡ï ¨ ¤pã£¨å ¢¥éì?
Œ®¦¥â ¯ p ««¥«ì­® á p §£®¢®p ¬¨ ¡ã¤¥¬ á®§¤ ¢ âì á®äâ? H  ¯« â¥ Sp2000
¯p¥¤á⮨⠦¨âì ª ª ¬¨­¨¬ã¬ âp¨ £®¤  (­ á⮫쪮 ¡®«ì让 ã ­¥¥ ¯®â¥­æ¨ «).
⨠áp®ª¨ ¡ã¤ãâ ­ ¬¨ ¢ë¤¥p¦ ­ë ¤«ï ¢®§¬®¦­®á⨠ᮧ¤ ­¨ï ¯p®£p ¬¬­®£®
®¡¥á¯¥ç¥­¨ï ¡¥§ ¡®ï§­¨ ¯®â¥pïâì ¯®ªã¯ â¥«¥©.
„® ¯®ï¢«¥­¨ï á«¥¤ãî饣® ¢ p¨ ­â  ¦¥«¥§  ¡ã¤¥â ¢p¥¬ï ¨ ¢ë᪠§ âì ¨ ¢ëá«ãè âì
¯®¦¥« ­¨ï.
“¤ ç¨!
Alex Goryachev.
[ZX]...[Sprinter]...
---
* Origin: PETERS PLUS LTD (2:5030/529.56)