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
+75
View File
@@ -0,0 +1,75 @@
*** Area: ZX.SPECTRUM Date: 18 Mar 01 11:50:05
*** From: Ivan Mak (2:5030/529.24)
*** To : Stanislav Udin
*** Subj: Ž ‘¯p¨­â¥p¥.
ਢ¥âáâ¢ãî ‚ á, Stanislav!
<Tuesday March 13 2001> <15:11> Stanislav Udin wr®te to Ivan Mak:
SU> € ¯p¨¬¥p­ë¥ áp®ª¨ ᪠§ âì ¬®¦¥èì?
Œ © ¬¥áïæ, ¥á«¨ ­¥ ¡ã¤¥â ­ ¢®¤­¥­¨©, §¥¬«¥âpïᥭ¨© ¨ â.¯. ª â ª«¨§¬®¢,
­ ¯®¤®¡¨¥ ®¡­ p㦥­¨ï ªp㯭ëå £«îª®¢ ¢ ¯« â¥....
SU>>> Œ®¦­® «¨ ­ áâp®¨âì ‘¯p¨­â¥p â ª, çâ®¡ë ¢ª«î稢 ¥£® ¤ ¦¥ ¨ ­¥
SU>>> ¯®¤®§p¥¢ âì, çâ® p ¡®â ¥èì ­¥ ­  ‘ª®p¯¨®­¥?
IM>> ’ ª çâ® ¡ë ᮢᥬ ­¥ ¯®¤®§p¥¢ âì, ­¥ ¯®«yç¨âáï :-)
SU> € ª ª ¡y¤¥â ¢ë£«ï¤¥âì ¯¥p¥¢®¤ ‘¯p¨­â¥p¥  ¢ p¥¦¨¬ ‘ª®p¯¨®­ . ‚ª«îç ¥èì
SU> ª®¬¯ìîâ¥p ¨ ...
†¤¥èì ᥪ㭤ë 2-3 ¯®ª  ­¥ § £p㧨âáï system.bat á ¯p®¯¨á ­­ë¬
¢ ­¥¬ scorpion.exe
®á«¥¤­¥£®, ¯p ¢¤ , ­¥â, ­® ª ¦¤ë© ª®¤¥p ᬮ¦¥â ­ ¯¨á âì,
¥á«¨ ¡ã¤¥â ­¥ «¥­ì ¯®âp â¨âì ¤¥­ì...
IM>> H ¤¥îáì, ¯p®¡«¥¬ ­¥ ¡y¤¥â.
IM>> ‚ ¯®á«¥¤­¥© ¢¥pᨨ ­ ©¤¥­ ¥é¥ ®¤¨­ £«î箪 (¯ p  ®£¨¡ îé¨å
IM>> ­¥¯p ¢¨«ì­®), ®­ ¡y¤¥â ¨á¯p ¢«¥­.
SU> ‚ᥠ⠪¨ í¬y«ïæ¨ï ¥áâì í¬y«ïæ¨ï. ƒ¤¥ £ p ­â¨ï, çâ® íâ  ¯ p  ®£¨¡ îé¨å
SU> ¡ë«  ¯®á«¥¤­¥©.
ƒ p ­â¨¨ â ª®© ­¥â, ­® ¥áâì ¨­ ï. ‚®§¬®¦­ë¥ ­®¢ë¥ £«îª¨ ¨á¯p ¢«ïîâáï
ç¨áâ® ¯¥p¥è¨¢ª®© ‡“. p¨­æ¨¯¨ «ì­ëå á«®¦­®á⥩ ­¥â, ­ ¤® ⮫쪮 §­ âì
¢ ª ª®¬ ¬¥á⥠£«îª ¨ ª ª ¤®«¦­® ¡ëâì ¢¥p­®.
IM>> ‚®â íâ® ¡ë«® ¢¥p­® ¤«ï ¯p¥¤ë¤y饩 ¯« âë, â ¬ ¬¥áâ  ¤«ï ¬ëè¨ ­¥
IM>> 墠⠫®. ‚ ­®¢®© ®­® ¥áâì, ¯®á¥¬y ª®­âp®««¥p Kempston-Mouse
IM>> ­ å®¤¨âáï ¢ ¯« ­¥ p ¡®â...
SU> ޝïâì ¦¥ å®â¥«®áì ¡ë y§­ âì ® áp®ª å.
¥ «¨§ æ¨ï ª¥¬¯áâ®­  ¢ â¥ç¥­¨¥ í⮣® £®¤ . ®«¥¥ â®ç­® ¢pï¤ «¨ ᪠¦ã...
‚ p¨ ­â, çâ® ®ª ¦¥âáï 㦥 ¢¬¥áâ¥ á ¯« â®© ª ¬ î ­¥ ¨áª«îç î...
IM>> Š ª p § ® 3d13 p¥çì ¨ ¥áâì. ‘ ¢¨­ç¥áâ¥p®¬ ¬®¦­® p ¡®â âì ¯pאַ ¨§
IM>> ª®¬ ­¤­®© áâp®ª¨ TR-DOS. Š®¬ ­¤ë CAT, SAVE, LOAD. ” ©« ä®p¬ â 
IM>> .trd § £py¦ ¥âáï ¢ RAM-Disk, ¤ «ìè¥ á ­¨¬ ¬®¦­® p ¡®â âì ª ª á
IM>> TR-DOS ç¥p¥§ 3d13.
SU> ’® ¥áâì ª ª y H¥¬® ­  Š ¥ (¨«¨ y H¥¬® ª ª ¢ ‘¯p¨­â¥p¥)?
Š®£¤  ¢ ‘¯p¨­â¥p¥ 㦥 ¡ë«¨ p ¬¤¨áª¨ ¯® 3d13, H¥¬® £®¢®p¨«, çâ® ‘¯¥ªâpã¬ã
¡®«ìè¥ 256Š ­¥ ­ ¤®âì, â ª çâ® ¢ë¢®¤ ᮮ⢥âáâ¢ãé訩 :-)
SU> € ¥á«¨ ᤥ« âì RST0, ¢ p ¬-¤¨áª¥ ®áâ ­¥âáï âp¤-®¡p §?
Žáâ ­¥âáï. ˆ ¥á«¨ ctrl+alt+del, ⮦¥ ®áâ ­¥âáï.
—â® ¡ë ¨á祧 ¥áâì ᯥæ-ª®¬ ­¤  ¢ TR-DOS-¥:
/CLEAR x ¤«ï ª®­ªp¥â­®£® p ¬¤¨áª  ¨
/INIT ¤«ï ¢á¥å áp §ã...
Hã ¨ ¥é¥ ª­®¯ª  Power :)
SU> € ¬­®£® «¨ ¢®®¡é¥ ¯®«ì§®¢ â¥«¥© ‘¯p¨­â¥p ? Œ­®£® «¨ ¨§ ­¨å ¯¨èyâ Ž
SU> ¤«ï ¤®¯®«­¨â¥«ì­ëå p¥¦¨¬®¢ í⮣® ª®¬¯ìîâ¥p ?
®«ì§®¢ â¥«¥© ¯p¨¬¥p­® 25, â®ç­¥¥ ᥩç á ­¥ §­ î.
ˆ§ ¯¨èãé¨å Ž â®ç­® ¥áâì ¤¢®¥ (ï ­¥ ¢ áç¥â),   ¯® á«ãå ¬
ªâ®-â® ¥é¥ ⮦¥ § ­¨¬ ¥âáï ¯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)