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
+122
View File
@@ -0,0 +1,122 @@
*** Area: ZX.SPECTRUM Date: 21 Jan 03 16:44:15
*** From: Ivan Mak (2:5030/529.24)
*** To : Nick Sevryukov
*** Subj: Sprinter
ਢ¥âáâ¢ãî ‚ á, Nick!
<Monday January 20 2003> <20:14> Nick Sevryukov wr®te to Ivan Mak:
IM>> â® § ¢¨á¨â ®â ⮣®, çâ® ­ §ë¢ âì "32-åp §pï¤­ë¬ ª®¬¯®¬". ‚ ‹ˆ‘
IM>> ¯p¨ ­¥®¡å®¤¨¬®á⨠¬®¦­® ¨ 128 p §p冷¢ ®p£ ­¨§®¢ âì ¯ p ««¥«ì­®,
IM>>   ¯® 16-â¨p §p來®© 設¥ ¤ ­­ë¥ £®­ïâì âã¤ë-áî¤ë...
NS> „«ï ¬¥­ï 32à §à來 ï  àå¨â¥ªâãà  ­ ¯àï¬ãî á¢ï§ ­  á 32à §à來®©
NS> 設®© ¤ ­­ëå ¯à®æ¥áá®à .
â  á¢ï§ì ᫨誮¬ ¯®¢¥på­®áâ­ , çâ® ¡ë ¥¥ ¯p¨­¨¬ âì §  ®¯p¥¤¥«ïîéãî...
“ USB - 1 ¡¨â - íâ® ­¥ §­ ç¨â, çâ® ¥¥ ®¡á«ã¦¨¢ ¥â 1-¡¨â­ë© ¯p®æ¥áá®p.
IM>> H㠢ᥠp ¢­®, íâ® ¦¥ ­¥ â®â ‘¯¥ªâp㬠¡ë« ¡ë! :-)
IM>> „㬠«¨ ­ ¤ ¯p®æ ¬¨, p §ã¬¥¥âáï...
NS> ˆ§¢¨­¨, ¢ë ¨ ­¥ ¯®«ã稫¨ ᯥªâàã¬,   ¯à®áâ® ¬ è¨­ã ᮢ¬¥á⨬ãî á
NS> ­¨¬.
H® ­ ç¨­ «¨ â® á 祣®? :)
‘ ¯p®á⮣® p áè¨p¥­¨ï ®¡ëç­®£® ‘¯¥ªâp㬠. ¥p¢ë© ¯p®â®â¨¯ ¢®®¡é¥ ¡ë« ¢ ¢¨¤¥
¯« âë 256-£® ‘¯¥ªâp㬠 á ªã祩 ¯p®¢®¤®¢ ¢®ªpã£...
NS> ޤ­  業  祣® £®¢®à¨â. ˆ­â¥à¥á­®, ¬­®£® § ª §®¢ ­ 
NS> á¯à¨­â¥à(â®ç­® ¬®¦­® ­¥ ®â¢¥ç âì, ¥á«¨ íâ® ª®¬¬¥àç¥áª ï â ©­ ) Žªã¯¨«
NS> ‘¯à¨­â¥à á¥¡ï ¨«¨ ¥é¥ ­¥â? (­¨â®«ìª® á⮨¬®áâì , ­® ¨ à §à ¡®âªã, ¨
NS> ¯®¬¥é¥­¨¥, ¨ ®¯« â  á®âà㤭¨ª ¬)
®«­®áâìî ¢á¥ ¯®ª  ­¥ ®ªã¯¨«, ­® ª®«¨ç¥á⢮ § ª §®¢ ᥩç á p áâ¥â...
IM>> —â®-â® ï ᮢᥬ ­¥ ¯®­ï«...
IM>> – ¨á¯®«ì§®¢ âì ª  ª®­âp®««¥p HDD, FDD, KBD, MOUSE ¨ â.¯.?
NS> „ , ¯à¨ç¥¬ ã í⮩ 設ë\ª®­â஫«¥à  ¥áâì ᢮© ¯à®æ¥áá®à, ᢮¥
NS> ¯à®£à ¬¬­®¥ ®¡¥á¯¥ç¥­¨¥, â.¥. ᤥ« âì á«¥¤ãî騩 è £ ¢
NS> ª®¬¯ãâ¥à®áâ஥­¨¨.
‘«¥¤ãî騩 è £ ­ ¤® ­  ᢮¥¬ ¦¥«¥§¥ ¤¥« âì,   ­¥ ­  ç㦮¬. ’® çâ® â ¬ ᢮¥ Ž ¨
â.¯. ­¥ ¨¬¥¥â §­ ç¥­¨ï. ‘¢ï§ì â® á ­¨¬ ­ ¤® ¤¥« âì? € í⮠⥠¦¥ ¯p®£p ¬¬ë ¨
­¨ç¥¬ ­¥ «ãç訥, 祬 ¯p®£p ¬¬ë ¯pאַ ®¡á«ã¦¨¢ î騥 ¯¥p¨ä¥p¨î... Š â®¬ã ¦¥, § 
¨á¯®«ì§®¢ ­¨¥ _ç㦮£®_ ¯p¨¤¥âáï ¯« â¨âì...
IM>> ’®£¤ , ⥠¯« âª¨ á €«ìâ¥p ¬¨ ª ª p § ¨ ¯®¤®©¤ãâ.
IM>> ’ ¬ ¢ €«ìâ¥pã ⮫쪮 ¢¯¨á âì á奬㠭㦭®£® ¯p®æ¥áá®p , PCI
IM>> ª®­âp®««¥p , ¯p®£p ¬¬ã ª ­¥¬ã, á®äâ ¯®ªpãç¥, ¨ ¢á¥£® ¤¥«®¢ â®!..
NS> â® ¤®«¦¥­ ¡ëâì æ¥«ë© ª®¬¯«¥ªá. ’ãâ á«®¦­®áâì ­¥ ¢ â¥å­®«®£¨¨,   ¢
NS> ­ ¯¨á ­¨¨ ⮣®, çâ® ¯à®è¨âì ¨ ®¡é¥© ª®­æ¥¯æ¨¨ ¯®¤®¡­®© ¬ è¨­ë.
ˆ¬¥­­® â ª ¨ ¥áâì.
IM>> Hã â ª ¢ «î¡®¬ á«ãç ¥ íâ® ­¥ ¡ë« ¡ë ‘¯¥ªâp㬠:)
NS> …é¥ à § ¯®¢â®àîáì. Ž­ ã ¢ á ¨ ­¥ ¯®«ã稫áï, ‘¯¥ªâàã¬. ®«ã稫 áì
NS> á ¬®áâ®ïâ¥«ì­ ï ¬ è¨­ , ª®â®à ï ¯® 業¥ àë­®ª ᯥªª¨ ᪮॥ ¢á¥£® ­¥
NS> § ©¬¥â,   ¯® ¢®§¬®¦­®áâï¬ ¥£® ¤ «¥ª® ®¡®£­ « .
ˆ¬¥­­®, çâ® _¯®«ã稫áï_. Ž­ ­ ç¨­ «áï â® á® ‘¯¥ªâp㬠. € ª®£¤  ­ ç¨­ «áï ­¥
¤ã¬ «¨, çâ® ¯®«ãç¨âáï ª ç¥á⢥­­ë© ᪠箪 ª ­®¢®© ¬ è¨­¥...
IM>> ’ ¬ áªp¥é¨¢ âì â® ­¥ç¥£®. Œã«ì⨯«¥ªá®p/¤¥¬ã«ì⨯«¥ªá®p 8<->16 ­ 
IM>> 設¥ ¨ ¢á¥. Ž­ ¢­ãâp¨ ‹Œ, ¥áâ¥á⢥­­®. €  ¤p¥á  ­  Z80 - 16, ­ 
IM>> ¢¨¤¥® - 17, ­  SIMM - 24 (¨ ⮦¥ áªp¥é¨¢ îâáï ¢­ãâp¨ ‹Œ).
NS> Žà¨£¨­ «ì­®, ­® ¬®¥ ¬­¥­¨¥, çâ® à §à來®áâì è¨­ë ¤®«¦­  ¡ëâì
NS> ®¤¨­ ª®¢®©, çâ®¡ë ¬¥­ìè¥ £¥¬®à  ¡ë«®.
ƒ¥¬®p  á p §p來®áâìî ­¥ áãé¥áâ¢ã¥â. H¥ §­ î, çâ® íâ® â ª®¥ ¢®®¡é¥ :-))
Hã, ¯®¤ã¬ ¥èì, 16 ¡¨â ã ¯p®æ ? „®¡ ¢¨« ª ­¨¬ ᢮¨ ¢ ‹Œ ¨ ok! ‘奬  p áè¨p¥­¨ï
 ¤p¥á  އ“ § ­¨¬ ¥â ¬ «ë© ¯p®æ¥­â ®â ¢á¥© ‹Œ. € á ¤ ­­ë¬¨ ¨ ⮣® ¯p®é¥...
IM>> Ÿ ¦¥ ­¥ £®¢®pî, çâ® í⮠⮫쪮 ­  ¢¨¤îåã. H ¤® ¦¥ ¥é¥ ¨ ¬ è¨­ã, ¨
IM>> ª¢ pâ¨pã á ¤ ç¥© :-)
NS> „ , 㠑⨢  „¦®¡á  ­ ¢¥à­®¥ í⮠㦥 ¢á¥ ¡ë«®, ¯®í⮬㠨 ¤¥è¥¢«¥
NS> ¯®«ã稫®áì ;) •®âï ªáâ â¨ ᢮© ¯¥à¢ë© ª®¬¬¥àç¥áª¨© ª®¬¯ãâ¥à(­ §ë¢ «áï
NS> ⮦¥ €¯«) ª®¬¯ ­¨ï Apple (¨§ ¤¢ãå 祫®¢¥ª, ¢â®à®£® ®á­®¢ â¥«ï § ¡ë«)
NS> ᮡ¨à «¨ ¢ £ à ¦¥.
€ ï ᢮© ¯¥p¢ë© ª®¬¯ìîâ¥p ᮡ¨p « ¢ ¤¥p¥¢­¥, ¯¥p¨®¤¨ç¥áª¨ ¯p¥p뢠ïáì ¤«ï
¯p®¯®«ª¨ ®£®p®¤  ¨ ¯®¥§¤®ª ¢ ã­¨¢¥pá¨â¥â :-)
NS> Œ®¦­® ¢®®¡é¥ ¢á¥, çâ® ª ᯥªª¨ ®â­®á¨âìáï ã¡à âì,   çâ® ¦¥ ⮣¤ 
NS> ®â ᮢ¬¥á⨬®áâ¨ á ­¨¬ ®áâ ­¥âáï?
‚ᥠ®áâ ­¥âáï. ˆ ­¨ªã¤  ­¥ ¤¥­¥âáï. ®â®¬ã çâ® § ¯ãá⨢ spectrum.exe
§ ¯ã᪠¥âáï ¨ ¯¥p¥£p㧪  ‹Œ. H®¢ ï á奬  ¬®¦¥â ¡ëâì ª ª®© 㣮¤­®, ãá«®¢¨¥
⮫쪮 ®¤­® - ®áâ ¢¨âì ­¥¨§¬¥­­®© á奬㠯¥p¥£p㧪¨ ¯p®è¨¢ª¨ ¨ ¯¥p¥ª«î祭¨ï ­ 
¤p㣮© á®äâ...
NS> ®â®¬, ï ¯à¥¤áâ ¢«ïî ¯¥à¥¯à®è¨¢ªã ‹ˆ‘  ¢ á¯à¨­â¥à¥, ¤®«¦­ 
NS> ¯à®¨á室¨âì æ¥­âà «¨§¢®¢ ­® (â.¥. ª ¦¤ë© ¬®¦¥â á¢®î ¯¨á âì, ­®
NS> ¯¥â¥àᯫîá ¤®«¦­  ®¡ï§ â¥«ì­® ¯®áâ®ï­® ¢ë¯ã᪠âì á¢®î ¨ ¯à¨ íâ®
NS> ®¡ï§ â¥«ì­® ᤥ« âì ª ª®©-â® áâ ­¤ àâ),   â® ¨­ ç¥ ¬®£ãâ ¡ëâì ®ç¥­ì
NS> ¡®«ì訥 âà ¡«ë á ᮢ¬¥á⨬®áâìî ¨«¨ ¯à¥¤« £ ¥âáï, ¤®¯ãá⨬ ¢¬¥á⥠á
NS> ¨£à®©, à á¯à®áâà ­ïâì á¢®î ¯à®è¨¢ªã?   çâ® ¥á«¨ ®­  ­ àãè¨â à ¡®âã
NS> Ž‘, ª®â®à ï ­  ¤àã£ãî à áç¨â ­ ?
…᫨ ¨£pã誠 p áç¨â ­  ­  ®¯p¥¤¥«¥­­ãî Ž‘, ®­  ¨§ ¯®¤ ­¥¥ ¨ § ¯ãáâ¨âáï. ‘®
᢮¥© ¯p®è¨¢ª®© ¨£pã誨 ¢¯®«­¥ ¬®£ãâ ¡ëâì. ®«¥¥ ⮣® - 㦥 ¥áâì...
¥p¥ª«î祭¨¥ Ž‘, p §ã¬¥¥âáï, 業âp «¨§®¢ ­­® ¤®«¦­® ¡ëâì (ᥩç á í⮣® ­¥â,
¯®ª  Ž‘ ã ‘¯p¨­â¥p  ®¤­ ). ¥p¥è¨¢ª  ‹Œ ⮦¥ 業âp «¨§®¢ ­­® ¤¥« ¥âáï. —¥p¥§
BIOS, ª®â®p®¬ã ­ ¤® ⮫쪮 ¡«®ª á ¤ ­­ë¬¨ ¤«ï ¯¥p¥è¨¢ª¨ ¯®¤ âì...
ˆ, ¥áâ¥á⢥­­®, ¢ ª ¦¤®© ¯p®è¨¢ª¥ ¤®«¦¥­ ¡ëâì ­¥ª¨© áâ ­¤ pâ­ë© ¬¨­¨¬ã¬ á奬ë,
  ¤ «ìè¥ ª ª¨¥ 㣮¤­® ᢮¨ ¨§¬¥­¥­¨ï...
à®â®áë á¡¥¦ «¨. ‡¥à£¨ § ª®¯ «¨áì. ®à  ¨ ¬­¥ § ªà㣫ïâìáï. 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)