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
+147
View File
@@ -0,0 +1,147 @@
*** Area: ZX.SPECTRUM Date: 18 Jan 03 15:29:25
*** From: Ivan Mak (2:5030/529.24)
*** To : Nick Sevryukov
*** Subj: Sprinter
ਢ¥âáâ¢ãî ‚ á, Nick!
<Friday January 17 2003> <17:48> Nick Sevryukov wr®te to All:
NS> H à®¤, ª ª ¢ë ®â­®á¨â¥áì ª í⮩ ¬ è¨­¥.
Žç¥­ì ¤ ¦¥ å®p®è® ®â­®á¨¬áï!
„ ¦¥ ®ç¥­ì «î¡¨¬ (¨ ®á®¡¥­­® ᨫ쭮 ¢ ¤­¨... ¢ ®á®¡¥­­ë¥ ¤­¨ :-))
NS> Ÿ á« §¨« ¤ ¦¥ ­  ¨å á ©â(¥â¥àá «îá), ®ç¥­ì ®âà ¤­®, çâ® ¯®¤®¡­ë¥
NS> ¢¥é¨ ¥é¥ ¤¥« îâ! Œ­¥ ¯®­à ¢¨« áì  àå¨â¥ªâãà  í⮣® ª®¬¯ 
NS> (¢¥«¨ª®«¥¯­®, çâ® ¢®§¬®¦­® ç áâ¨ç­®¥ ¨§¬¥­¥­¨¥  àå¨â¥ªâãàë ¯ã⥬
NS> ¯¥à¥¯à®£à ¬¬¨à®¢ ­¨ï ‹ˆ‘€ ¯à¨ § £à㧪¥ ¬ è¨­ë).
"— áâ¨ç­®¥" - íâ® ¬ï£ª® ᪠§ ­®. ‘­ p㦨 ®â ‹ˆ‘€ ¢ ‘¯p¨­â¥p¥ ⮫쪮 ¯p®æ,
¯ ¬ïâì ¨ ¯®pâë. ‚ᥠ®áâ «ì­®¥ ¢­ãâp¨, â ª çâ®  på¨â¥ªâãpã ¯®ç⨠¯®«­®áâìî
¬®¦­® ¯®¬¥­ïâì.
NS> ‚®®¡é¥¬ ¢á¥ ªàãâ®!
â á ¬®¥ ¯p ¢¨«ì­®¥ § ¬¥ç ­¨¥! :-)
NS> ®¤­® ­®. “ ¬¥­ï á«®¦¨«®áì ¢¯¥ç â«¥­¨¥, çâ® íâ® å à¤¢ à­®\á®äâ­ë©
NS> ª®¬¯«¥ªá í¬ã«ï樨 ‘¯¥ªª¨ :).
‘ª ¦¥¬ â ª, íâ  ç áâì ‘¯p¨­â¥p  ®ç¥­ì ¤ ¦¥ ­¥ ¯«®å® 㤠« áì.
NS> ‡ £à㦠¥¬áï ¢ ¨å ¤®á¥ (®ç¥­ì ¯® ¨­â¥à䥩áã Œ‘-„Ž‘ ­ ¯®¬­¨«®, ¤  ¨
NS> ä®à¬ â ä ©«®¢, ¤  ¨ ¢¨­â ä®à¬ â¨âáï ¯®¤ ä â16...),   ¯®â®¬ § ¯ã᪠¥¬
NS> spectrum.exe (íâ® ¦¥ ¯® áã⨠í¬ã«ì, ¥¤¨­á⢥­­®¥ ¦¥«¥§®(¯à®æ) á®
NS> ᯥªª¨ ®¤¨­ ª®¢ë©(¯®çâ¨), ¯®í⮬ã í¬ã«ïæ¨ï ­¥ 100% á®ä⢠ୠï), ­ã  
NS> â ¬ 㦥 ¤ «ìè¥ ¦¨¢¥¬... ;) à ¢¤  ­ ¤® ª ¦¤ë© à § § ¯ã᪠âì
NS> spectrum.exe, å®âï ¥áâì ¦¥ ä ©« autoexec.bat!
’ãâ ­ ¤® ᪠§ âì, çâ® § ¯ã᪠âì ¬®¦­® ­¥ ⮫쪮 spectrum.exe, ­® ¨ doom.trx, ¨
video.trd, ¨ ¥é¥ ­¥ ¬ «® ¤pã£¨å ¯p®£p ¬¬ (®á®¡¥­­® forth.exe :))
NS> ( ï ­¥ ¯®­¨¬ î, ¥á«¨ ¢ë¡¨à âì ®¯¥à æ¨®­ªã, § ç¥¬ ¦¥ ­  á⮫쪮 á«¥¯®
NS> á ¬á-¤®á  ª®¯¨à®¢ âì?
€ ®­® ¨ ­¥ á«¥¯® ᪮¯¨p®¢ ­®.
NS> íâ® ®¤­  ¨§ á ¬ëå ­¥ã¤ ç­ëå Ž‘ - ¯®¯ë⪠ à áè¨à¨âì ‘\Œ, ­¥ã¦¥«¨
NS> ­¥«ì§ï ¡ë«® çâ®-â® î­¨ªá®¨¤­®¥ ¤¥« âì?)
Œ®¦­®... ¡ë«®. ˆ ­¥ ⮫쪮 ¡ë«®. „ ¦¥ ᥩç á ¬®¦­®. (Kâ® ¡ë ¢§ï«áï, ë? :))
NS> „ , ¬®¦­® ¢å®¤¨âì ¢ "०¨¬ ᯥªâà㬠" § ¯ã᪠ï TRD ä ©«ë, ª®â®àë¥ ã
NS> ¢ á ­  ¢¨­â¥. (à §¢¥ ­¥ í¬ã«ì? 100%!) H® íâ® ¥é¥ ¤ «¥ª® ­¥ ¢á¥, ­¥â
NS> ¤ ¦¥ ᯥªâà㬮¢áª®© 設ë!
Šáâ â¨, ¤ ¦¥ ¥áâì. ¥p¥å®¤­¨çª®¢ ï â ª ï, á ISA ­  ZX... ˆ ¤ ¦¥ á奬 
¯¥p¥å®¤­¨ª  ᢮¡®¤­® ®â¤ ¥âáï (â ¬ 楫ëå ¤¢¥ ¬¨ªp®áå¥¬ë ¯® 2 pã¡. ¥á«¨ ­¥ ¢pã)
NS> (â.ª. § ç¥¬ ®­  ¢ ¬?! ¢á¥ çâ® ­ã¦­® ¥áâì 㦥 ­  ¯« â¥,   ¡®«ì襣® ¢ë
NS> ¦¥« âì ­¥ ¤®«¦­ë) ­® ¯à ¢¤  ᤥ« «¨ ¨á -8, ¤  ¨ ¯ ¬ïâì ¬®¦­®
NS> ᨬ¬-72(¤® 4Œ) áâ ¢¨â ¨ ¢¨­â ¯®¤ª«îç âì (à §¤¥«ë ¯® 2ƒ)...
... ¯ ¬ïâì 4mb - ¬¨­¨¬ã¬! ˆ ¤® 64mb... ¬®¦­® ¢®âª­ãâì...
NS> ¨ ¯®à⮢ ­¥â ... å®âï ¢àã, ¥áâì ¤¢  ¯®á«¥¤®¢ â¥«ì­ëå ¯®àâ (­® ­¥
NS> RS232 ¨ ª ­¨¬ ¯®¤ª«îç¥­ë ª« ¢  ¨ ¬ë誠, ¯®í⮬ã çâ® ®­¨ ¥áâì, çâ® ¨å
NS> ­¥â...),
‘ ¬ë© £« ¢­ë© ᯥªâp㬮¢áª¨© ¯®pâ - ¥áâì! â® TAPE p §ã¬¥¥âáï! :)
NS> ¨ ¢ ¯à¨­¨æ¯¥ ¥áâì ¯ à ««¥«ì­ë© ¯®àâ(­® ® ­¥¬ ï ­  á ©â¥
NS> ­¨ç¥£® ­¥ ­ è¥«, ªà®¬¥ ⮣®, çâ® ª ­¨¬ã ¬®¦­® ¯®ª«îç âì ¯à¨­â¥à.  
NS> ª ª®©?)
MC6313, ­ ¯p¨¬¥p. ˆ DJ600 ¯®¤ª«îç «áï...
NS> Hã ¥é¥ â ¬ ¢áâ஥­  ¢¨¤îª  á 256ª, ª®â®à ï ¯®¤ª«îç ¥âáï ª CGA
NS> ¬®­¨â®àã ¨«¨ ‘Š€’ ࠧꥬ㠒‚. ‡¢ãª®¢ ï á¨á⥬  ⮦¥ ­®à¬ «ì­ ï - íâ®
NS> ª®¢®ªá ¨ –€(å®à®è¨©! 16¡¨â­ë©). …é¥ ¢¥á¥«®, ®¡à é¥­¨¥ ª ¢¨­âã, ¨§
NS> ᯥªª¨ ¢®§¬®¦­® ¨§ ’-„Ž‘€ ¨ ‚ á¨ª , â.ª. ª®¬ ­¤ë ’-„Ž‘  à áè¨à¥­ë
NS> ¤«ï à ¡®âë á ¢¨­â®¬. ®¤à®¡­¥¥ ­  áâà ­¨çª¥ www.petersplus.ru ¬®¦­®
NS> ¯®ç¨â âì.
¯p® ¢¨¤îªã ­ ¤® ¤®¡ ¢¨âì, çâ® 256 梥⮢ ¨§ 16¬«­ ã ¥£®!
€ ¯p® §¢ãª, â ¬ ­¥ ¯p®áâ® ª®¢®ªá, ª ­¥¬ã ¥é¥ ¡ãä¥p á ¯¥p¥ª«îç ¥¬®© ç áâ®â®©,
ª®â®pë© ¯®§¢®«ï¥â ¨£p âì ¬ã§ëªã ¨ ¯ p ««¥«ì­® ¥é¥ çâ®-â® ¤¥« âì.
€ ªp®¬¥ ª®¢®ªá  ¥é¥ ¨ AY-8910 ¢­ãâp¨ ‹ˆ‘-  (¤«ï ZX-Spectrum-a)...
NS> Ÿ ¯®­¨¬ î â ª , çâ® íâ® ­¥ ᯥªâàã¬,   á ¬®áâ®ïâ¥«ì­ ï ¬ è¨­  á®
NS> ᢮¥©  àå¨â¥ªâãன ¨ "०¨¬®¬ ᮢ¬¥á⨬®á⨠ᮠᯥªâà㬮¬".
„ , £« ¢­®¥ á«®¢® _ᮠ᢮¥©_.
NS> ’ ª ¢®â, ­¥ ¯à®é¥ ¡ë«® ᤥ« âì â ª. ‘¯à¨­â¥à ¡¥§ ¬®­¨â®à  á⮨â 170$,
NS> §  í⨠¦¥ ¤¥­ì£¨ ¬®¦­® ¢§ïâì á«¥¤ãî騩 ª®¬¯: ¯¥­â200ŒŒ•(¨ ¤ ¦¥ ¡®«¥¥
NS> ⮣® ª6-2-300\400), ®¯¥à â¨¢ª¨ 128Œ, ¢¨¤îå  2Œ, ä«®¯, ¢¨­â £¨£®¢ 6
NS> ¨ ¬®­¨â®à ‘‚ƒ€ 14".
‰®! Ÿ ­¥ ï! â® ¦¥ PC ¯®«ãç¨âáï,   ­¥ Sprinter! 8:-( )
®ª ¦¨â¥ ¬­¥ ¢ PC ¬¨ªp®á奬ã, ¢ ª®â®pãî ¬®¦­® _᢮© ¯p®æ¥áá®p_ ¢áâ ¢¨âì?
NS> H  ¯®¤®¡­®© ¬ è¨­¥ ¯à¥ªà á­® ¨¤ãâ ¬­®£¨¥ í¬ã«¨,
NS> ­ ¯¨á âì ­®¢ë¥ ஬ë (ç⮡ë à áè¨à¨âì ¢®§¬®¦­®áâ¨),   ¥á«¨ ­ ¤®
NS> ­ ¯¨á âì ¨ ­®¢ë© í¬ã«ì, ¢ ª®â®à®¬ ¡ã¤ãâ è¨à¥ ¯®¤¤¥à¦¨¢ âìáï ¯®¤®¡­ ï
NS>  àå¨â¥ªâãà , ¤  ¨ ã á¯à¨­â¥à  ⮦¥ ¥áâì í¬ã«ïâ®à ¯®¤ å86.
…áâì í¬ã«ïâ®p ‘¯p¨­â¥p  ­  x86, ⮫쪮 ¥¬ã ¯®ª  ¥é¥ pãçªã ®â £¨p¨ ¯¨«¨âì
¨ ¯¨«¨âì,   ¯®â®¬ ¥é¥ ¨ ᠬ㠣¨pî ¯¨«¨âì ¯p¨¤¥âáï... Œ®¦¥â ¨ p á¯¨«¨âáï
¯ï⨣¨£ £¥p殢®© ­®¦®¢ª®©...
NS> ਠí⮬ ¤ ¦¥ 設  ®áâ ­¥âáï â ª®©¦¥!!! â.ª. ¢ á¯à¨­â¥à¥ ¨á  ¨ â.¯.
NS> ਠí⮬ ¢á¥¬, ã ¯®¤®¡­®©  àå¨â¥ªâãàë ®£à®¬­ë¥ ¯à¨¥¬ãé¥á⢠, â.¥. ­ 
NS> â ª®© ¬ è¨­¥ ¢ ¯à¨­æ¨¯¥ ¬®¦­® ᢮¡®¤­® í¬ã«¨âì ¯à®æë ¡¥§ â®à¬®§®¢
NS> £¤¥-â® ¤® 50Œƒæ, ­ã   ®¤­  ä«íâ ¬®¤¥«ì 祣® á⮨â....
€ ª ª ­  áç¥â í¬ã«¥­¨ï  ªá¥«¥p â®p , çâ® ¢­ãâp¨ ‹Œ ᨤ¨â?
ˆ ª ª ­  áç¥â í¬ã«¥­¨ï ¢á¥© áå¥¬ë ‹Œ?
¥p¥§ £p㧪  áå¥¬ë ¢ ‘¯p¨­â¥p¥ ¢®§¬®¦­  ­¥ ⮫쪮 ¯p¨ ¢ª«î祭¨¨,
­® ¨ _¢ «î¡®© ¬®¬¥­â p ¡®âë_ ¯p®£p ¬¬ë!
0.5 á¥ªã­¤ë ¨  på¨â¥ªâãp  ¬ è¨­ë ¯®«­®áâìî ¨§¬¥­¨« áì!
NS> ‡›† ­  ¯®á«¥¤®ª ᪠¦ã, çâ® ¨¤¥î, ª®â®àãî ᤥ« «¨ ¯¨â¥àá ¯«îá, ï ¡ë
NS> ®à£ ­¨§®¢ « ­  ®â¤¥«ì­®© ¯« â¥ (¨á \¯á¨) ¨ ¢ëè«® ¡ë ¤¥è¥¢«¥ ¨
NS> ¢®§¬®¦­®á⥩ ¡ë«® ¡ë ¡®«ìè¥. ’.¥. å®à®è® ¡ë ¨¬¥âì å à¤¢ à­ãî ¯« âã, á®
NS> ᯥªª¨, ª®â®àãî ï ¡ë ¯®áâ ¢¨« ¢ ¨‘îª ¨ ¯®«ã稫 ¡ë ᯥªâàã¬, ª®â®àë©
NS> ¨¬¥« ¡ë ⥯¥àì ®âªàëâãî  àå¨â¥ªâãàã. ˆ­â¥à¥á­®, ¯®¤®¡­ãî ¨¤¥î £¨¡à¨¤ 
NS> ªâ®-­¨¡ã¤ì ¯ëâ «áï ¤¥« âì?!
ëâ «¨áì. ’®«ìª® ¢á¥ ¯®¯ë⪨ â ª ¯®¯ë⪠¬¨ ¨ ®áâ «¨áì. ‚ á¥p¨î ­¨ç¥£® ­¥ ãè«®.
"„¥è¥¢«¥ ‘¯p¨­â¥p " - í⮠⮫쪮 ª ¦¥âáï. € ¢ p¥ «ì­®á⨠®ª §ë¢ ¥âáï ¤¥è¥¢«¥
¯p®æ¥­â®¢ ­  20, ¬®¦¥â, §  áç¥â "ª®æ ­¨ï 墮á⮢ á奬ë", â ª çâ® á¬ëá«  ¢ ⮬
¨ ­¥â.
à®â®áë á¡¥¦ «¨. ‡¥à£¨ § ª®¯ «¨áì. ®à  ¨ ¬­¥ § ªà㣫ïâìáï. 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)