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
+104
View File
@@ -0,0 +1,104 @@
*** Area: ZX.SPECTRUM Date: 22 Mar 01 17:42:00
*** From: Alex Goryachev (2:5030/529.48)
*** To : All
*** Subj: Sprinter News
ਢ¥âáâ¢ãî, All!
Žâ¢¥ç ï ­  ¢®¯à®áë ® ª®¬¯ìîâ¥à¥ Sprinter, ¯®ï¢¨¢è¨¥áï ¢ ª®­ä¥à¥­æ¨¨,
­ ¤¥îáì ­  ¯®­¨¬ ­¨¥ ¨ ¤®¡à®¦¥« â¥«ì­®¥ ®â­®è¥­¨¥.
‚ ­ áâ®ï騩 ¬®¬¥­â ¯à®¥ªâ "Sprinter" (ªáâ â¨, ¯¨á âì ­ã¦­® ¨¬¥­­® ¯®
 ­£«¨©áª¨, ¯®â®¬ã ª ª - Trade Mark :-)  ªâ¨¢­® à §¢¨¢ ¥âáï.
“ç¨âë¢ ï ¢á¥¬ ¨§¢¥áâ­®¥ ¯®«®¦¥­¨¥ á ¯¥àá®­ «ì­ë¬¨ ª®¬¯ìîâ¥à ¬¨ ¨
à á¯à®áâà ­¥­¨¥¬ ¯à®£à ¬¬­®£® ®¡¥á¯¥ç¥­¨ï ã ­ á ¢ áâà ­¥, ¬ë ­ ¤¥¥¬áï ᥩç á
­  ¨­â¥à¥á ª Sprinter-ã á® áâ®à®­ë ¨­®áâ࠭楢.
H  ᥣ®¤­ïè­¥¬ íâ ¯¥ à ¡®âë ¬ë å®â¨¬ ¯à¥¤áâ ¢¨âì ¬¨àã ª®¬¯ìîâ¥à ᯮᮡ­ë©
§ ¨­â¥à¥á®¢ âì ¢ ¯¥à¢ãî ®ç¥à¥¤ì à §à ¡®â稪®¢ ¯à®£à ¬¬­®£® ®¡¥á¯¥ç¥­¨ï 8-¬¨
¨ 16-⨠¡¨â­ëå ª®¬¯ìîâ¥à®¢, ¯à¨áâ ¢®ª ¨ ¨£à®¢ëå  ¢â®¬ â®¢, ¨¬¥îé¨å
ª ª®©-«¨¡® àë­®ª á¡ëâ  á¢®¨å ¯à®£à ¬¬ ¨ ᮯãâáâ¢ãîé¨å ⮢ à®¢.
’ ª¨¥ ª®¬ ­¤ë ¥áâì ¯®áª®«ìªã §  £à ­¨æ¥© ¯« âïâ ¤¥­ì£¨ §  Ž, ¥áâì ª«ã¡ë ¨
¯®áâ®ï­­ë¥ ¯®«ì§®¢ â¥«¨. ˆ ¯®í⮬㠭 è¨ ¤¨áâਡìîâ®àë ­  ‡ ¯ ¤¥ ᬮ£ãâ
¯à®¤ ¢ âì ᢮¥ ­®¢®¥ Ž ¢¬¥á⥠ᮠSprinter-®¬. ® § ¯ ¤­ë¬ ¬¥àª ¬ Sprinter
á⮨⠭¥ ¤®à®£® (ãç¨âë¢ ï ¢®§¬®¦­®á⨠¨ 㤮¡á⢮ ¨á¯®«ì§®¢ ­¨ï ¯¥à¨ä¥à¨¨),
â ª çâ® §¤¥áì ¢®§¬®¦¥­ á¥à쥧­ë© ¡¨§­¥á.
ਠãá«®¢¨¨ á®§¤ ­¨ï Ž ¤«ï Sprinter-  ­  ‡ ¯ ¤¥, ­ è ª®¬¯ìîâ¥à ¬®¦¥â
®ª § âìáï ¢®áâॡ®¢ ­­ë¬ ¨ ­  ¢­ãâ७­¥¬ àë­ª¥. H ¤¥¥¬áï ­  íâ®.
‘¥©ç á ã ­ á § ¢ï§ «¨áì ®â­®è¥­¨ï á ¤¢ã¬ï ¯®â¥­æ¨ «ì­ë¬¨ ¤¨áâਡìîâ¥à ¬¨
(¢ ˆá¯ ­¨¨ ¨ ¢ ‘˜€). ˆ¬¨ 㦥 ¯à¨®¡à¥â¥­ë â¥áâ®¢ë¥ íª§¥¬¯«ïàë, ¨¤¥â  ªâ¨¢­ ï
¯¥à¥¯¨áª  ¨ ¯¥àᯥªâ¨¢ë ¢¯®«­¥ ®¡­ ¤¥¦¨¢ î騥. …áâì ¨ ç áâ­ë¥ «¨æ , § ª § ¢è¨¥
Sprinter.
®í⮬ã à ¡®âë ­ ¤ ¯à®¥ªâ®¬ ¢¥¤ãâáï ᥩç á ¢ âà¥å ¯«®áª®áâïå: ¤®à ¡®âª 
¦¥«¥§ ; ®¯â¨¬¨§ æ¨ï ¡ §®¢®£® Ž, ¯®§¢®«ïî饣® ¨á¯®«ì§®¢ âì ¦¥«¥§® ¨ á®§¤ ¢ âì
­  ­¥¬ ¯à¨ª« ¤­®¥ Ž; ¯à®¤¢¨¦¥­¨¥ Sprinter-  ­  ¢­¥è­¥¬ àë­ª¥ ¨  ªâ¨¢­ë© PR.
‚ ¡ §®¢®¥ Ž ¢ ­ è¥¬ ¯à¥¤áâ ¢«¥­¨¨ ¢å®¤¨â: DOS, ä ©«®¢ë© ¬¥­¥¤¦¥à,
⥪áâ®¢ë© ¨ £à ä¨ç¥áª¨© । ªâ®àë,  áᥬ¡«¥à, ª®¬¯¨«ïâ®àë á ï§ëª®¢
¯à®£à ¬¬¨à®¢ ­¨ï, ­ ¡®à ã⨫¨â (ª®­¢¥àâ¥àë, ¢ìàë).
—â® ª á ¥âáï ¦¥«¥§ , ⮠ᥩç á â¥áâ¨àã¥âáï ­®¢ ï ¯« â  Sp2000 ­  ‹Œ
EP1K30QC208-3 (á ®¡ê¥¬®¬ ¢ âਠࠧ  ¡®«ìè¥), ª®â®à ï ¤®«¦­  áâ âì ®á­®¢®©
«¨­¨¨ ¬®¤¥«¥© Sprinter. ’ãâ ­¥®¡å®¤¨¬® à §¤¥«¨âì ¯®­ïâ¨ï "¯« â  ª®¬¯ìîâ¥à "
¨ " ¬®¤¥«ì ª®¬¯ìîâ¥à  ". ®¤ ¯« â®© ­ ¤® ¯®­¨¬ âì ᮡá⢥­­® ¯« âã, ª ª
¦¥«¥§®,   ¯®¤ ¬®¤¥«ìî ª®¬¯ìîâ¥à  ­ ¤® ¯®¤à §ã¬¥¢ âì ­ ¡®à ª®­ä¨£ãà æ¨©,
¢ë¯®«­¥­ëå ¢ €«ìâ¥à¥. …᫨ £®¢®à¨âì ® ¯®â¥­æ¨ «¥ ¯« âë Sp2000, â® ¬®¦­®
¯¥à¥ç¨á«¨âì â® ­®¢®¥, çâ® ®­  ¯®§¢®«ï¥â ॠ«¨§®¢ âì:
1. 16-⨠ࠧà來ãî  àå¨â¥ªâãàã ᮯà殮­¨ï ‹Œ á ®á­®¢­®© ¯ ¬ïâìî ¨ IDE
(¯®§¢®«¨â 㢥«¨ç¨âì ᪮à®áâì à ¡®âë á HDD ¨ ᪮à®áâì à ¡®âë  ªá¥«¥à â®à )
2.  §¤¥«ì­ãî á奬ã à §¢®¤ª¨ ¡«®ª  ®á­®¢­®£® އ“, IDE, FDD á ¡«®ª®¬
¯à®æ¥áá®à , ‡“, Š˜-އ“, ISA. ®§¢®«¨â:
- ®à£ ­¨§®¢ âì ¯àאַ© ¤®áâ㯠ª ¯ ¬ï⨠¤«ï IDE, FDD ¨ ­¥ ⮫쪮;
- ¥é¥ ¡®«¥¥ 㢥«¨ç¨âì ᪮à®áâì IDE;
- ®à£ ­¨§®¢ âì ¡ëáâàãî ¯ à ««¥«ì­ãî à ¡®âã IDE ¨ ¯à®æ¥áá®à ;
- ®à£ ­¨§®¢ âì ¢¨¤¥®à¥¦¨¬ë á à á¯®«®¦¥­¨¥¬ ¤ ­­ëå ¢ ®á­®¢­®¬ އ“;
3. 16-¡¨â­ë© ¤¢ã媠­ «ì­ë© §¢ãª®¢®© –€. € íâ® ¯®«­®æ¥­­ë© 16-¡¨â­ë© §¢ãª.
4. ˆ ­¥ª®â®àë¥ ¤®¯®«­¨â¥«ì­ë¥ ¢®§¬®¦­®áâ¨:
- ¯®¤ª«î祭¨¥ 72-pin SIMM ®â 4-å ¤® 64-å ¬¥£ ¡ ©â;
- ‡“ ¤® 256Kb
- ¯®«­ë© ¯®à⠯ਭâ¥à .
ਭ樯¨ «ì­®¥ ®â«¨ç¨¥ ¯« âë Sp2000 ¢ ⮬, çâ® ®­  ¯®§¢®«ï¥â ¯à®¢®¤¨âì
 ¯£à¥©¤ ¬®¤¥«¨ ª®¬¯ìîâ¥à  ¡¥§ § ¬¥­ë ¯« âë. â® ®áãé¥á⢫ï¥âáï á ¯®¬®éìî
¯à®£à ¬¬ë § ¯ã᪠¥¬®© ­  á ¬®¬ Sprinter-¥ ¨ ¯¥à¥§ ¯¨á뢠î饩 ¨­ä®à¬ æ¨î ¢
稯 å ¯« âë. ‘⮨¬®áâì ¯®¤®¡­®£®  ¯£à¥©¤  ¡ã¤¥â ­¥¢¥«¨ª . ⮠ᤥ« ¥â
Sprinter ¤¥©á⢨⥫쭮 £¨¡ª¨¬ ã­¨¢¥àá «ì­ë¬ ª®¬¯ìîâ¥à®¬.
‘¥£®¤­ïè­ïï ¬®¤¥«ì Sprinter ª 㦥 ¨§¢¥áâ­ë¬ ¯ à ¬¥âà ¬ ¤®¡ ¢¨«  ¯®«­ë©
¯®àâ LPT ¨ 16 ¡¨â­ë© §¢ãª®¢®© –€. ‘⮨¬®áâì ¯®¤®¡­®© ª®­ä¨£ãà æ¨¨ á®áâ ¢«ï¥â
95 ¤®«« à®¢.
‚ ­ áâ®ï騩 ¬®¬¥­â ¯« â  Sp2000 ¯à®å®¤¨â â¥áâ¨à®¢ ­¨¥ ¨ ¯®ª  ­¥ £®â®¢  ¤«ï
¯à®¤ ¦¨ ª®­¥ç­ë¬
¯®«ì§®¢ â¥«ï¬. ‚ ­¥© ¡ë«® ॠ«¨§®¢ ­® ¬­®£® ­®¢¨­®ª, çâ® ­¥ ¯®§¢®«ï¥â
¢ë¯ãáâ¨âì ¥¥ ¢ ¯à®¤ ¦ã ¡¥§ âé â¥«ì­®© ¯à®¢¥àª¨ ¨ ¤®¢®¤ª¨.
‘ ãç¥â®¬ í⮣®, ¬ë à¥è¨«¨ à áè¨à¨âì «¨­¥©ªã ¯« â Sprinter-  ¨ £®â®¢ë
¯à¥¤«®¦¨âì ¯®«ì§®¢ â¥«ï¬ ¯« âã Sp2000-Light. Žâ«¨ç¨¥ ®â Sp2000 á®á⮨⠢
®âáãâá⢨¨ ISA ᫮⮢, ¢â®à®£® IDE ࠧꥬ  ¨ ®£à ­¨ç¥­¨¨ ¢¨¤¥® އ“ ¤® 256Kb.
â® ¯®§¢®«¨«® á­¨§¨âì á⮨¬®áâì "¦¥«¥§ " ¤® 85 ¤®«« à®¢. ਠí⮬ ¯« â 
á®åà ­¨«  ¢®§¬®¦­®áâì ¯à®£à ¬¬­®£®  ¯£à¥©¤  ¬®¤¥«¨ ª®¬ìîâ¥à .
H ¤¥¥¬áï, çâ® ­®¢ ï ¯« â  ᬮ¦¥â § ¨­â¥à¥á®¢ âì ¯®«ì§®¢ â¥«¥©, ª®â®àë¬
Sprinter
¨­â¥à¥á¥­ ¢ ¯¥à¢ãî ®ç¥à¥¤ì ª ª "¯à®¤¢¨­ãâë©" Specrtum.
…᫨ ¢ë å®â¨â¥ § ª § âì ¯« âã Sp-2000-Light ¨«¨ ã ¢ á ¥áâì ª ª¨¥ «¨¡® ¢®¯à®áë
¯¨è¨â¥:
FIDO: 2:5030/529.48
e-mail: peters@atlant.ru
ˆ§®¡à ¦¥­¨ï ­®¢ëå ¯« â ¤®áâã¯­ë ­  ­ è¥¬ ᠩ⥠http://www.petersplus.da.ru
’ ª¦¥, ¥á«¨ ¢ë ¦¨¢¥â¥ ¢ ‘ ­ªâ-¥â¥à¡ãࣥ, ¢ë ¬®¦¥â¥ ¯®§­ ª®¬¨âìáï á
ª®¬¯ìîâ¥à®¬ Sprinter ¥á«¨ § ©¤¥â¥ ¢ ®ä¨á ä¨à¬ë "…’…«îá" ¯®  ¤à¥áã
ã«.‚®ááâ ­¨ï 35, ®ä.31 (4 íâ ¦),
(¯® à ¡®ç¨¬ ¤­ï¬, ⮫쪮 á 17 ¤® 19 ç á®¢)
⥫. (812) 327-3531
“¤ ç¨ ¢á¥¬!
€«¥ªá¥© ƒ®àï祢 (¬¥­¥¤¦¥à ¯à®¥ªâ  "Sprinter")
... Ÿ ¤ãå §« , ­ á¨«¨ï ¨ ᬥàâ¨. â® ¬¥­ï ®â£®­ï«¨ ¡¥ááâà è­ë¥ ¬®­ å¨, 㤠àïï
¢
---
* Origin: PETERS PLUS LTD (2:5030/529.48)