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
+132
View File
@@ -0,0 +1,132 @@
*** Area: ZX.SPECTRUM Date: 30 Mar 01 0:19:20
*** From: Alex Goryachev (2:5030/529.48)
*** To : Alex Shevchuk
*** Subj: Sprinter News
 ¤ ¯à¨¢¥âá⢮¢ âì ⥡ï, Alex!
Friday March 23 2001 Alex Shevchuk -> Alex Goryachev.
AS> 1. ISA á«®âë? ˆ 祣® â㤠 § á®¢ë¢ âì?
‹î¡ãî ¯¥à¨ä¥à¨î, ª®â®à ï ¡ã¤¥â ¯®¤¤¥à¦¨¢ âìáï. ‘¥©ç á íâ® ¬®¤¥¬ ¨ ¯¥à¥å®¤­¨ª
­  ᯥªâà㬮¢áªãî 設ã.
AS> 2. Š ª ­ áç¥â à ¡®âë ¢ á¥â¨?  ¡®âë á ¬®¤¥¬®¬?
„«ï à ¡®âë á Hayes-¬®¤¥¬®¬ ¥áâì â¥à¬¨­ «ª  (X,Y,Z ¯à®â®ª®«ë). ¨è¥âáï ¬¥©«¥à.
AS> 3. Œ®¦­® ¯®¯®¤à®¡­¥© ® ¯à®æ¥ ¨ ¯à®£à ¬¬¨à®¢ ­¨¨ ¯®¤ ­¥£®? —â® §­ ç¨â
AS> "¯à®¤¢¨­ãâë© á¯¥ªâàã¬"?
Sprinter, ¨¬¥¥â ०¨¬ à ¡®âë, ®¡¥á¯¥ç¨¢ î騩 ¯®«­ãî ᮢ¬¥á⨬®áâì á®
‘¯¥ªâà㬮¬, ¯à¨ í⮬, ­ ¯à¨¬¥à, ¯®¤¤¥à¦¨¢ ¥âáï à ¡®â  á ­¥áª®«ìª¨¬¨
RAM-¤¨áª ¬¨ ¨ ᪮à®áâì à ¡®âë ª®¬¯ìîâ¥à  ¬®¦¥â ¡ëâì 㢥«¨ç¥­  §  áç¥â
¯®¢ë襭¨ï ç áâ®âë à ¡®âë ¯à®æ¥áá®à  "­  室ã".
‚ ª ç¥á⢥ ¯à®æ¥áá®à  ¨á¯®«ì§ã¥âáï Z84C15 á ç áâ®â ¬¨ 21/3,5MHz.
€ ¯®¤à®¡­¥¥ ® à ¡®â¥ ¯à®æ¥áá®à  ¨ ¥£® ¯à®£à ¬¬¨à®¢ ­¨¨, ¤ã¬ î, ®â¢¥â¨â ­ è
ª®­áâàãªâ®à, Ivan Mak.
AS> 4. ‘ ª ª¨¬¨ ãáâனá⢠¬¨ ¢®®¡é¥ ®­ ¬®¦¥â/¡ã¤¥â à ¡®â âì?
—â® ¨¬¥¥âáï ¢¢¨¤ã ¯®¤ "ãáâனá⢠¬¨ ¢®®¡é¥"? :-)
H  ᥣ®¤­ïè­¨© ¤¥­ì: MS mouse, AT ª« ¢¨ âãà , FDD 3,5" ¨ 5,25", ¢¨­ç¥áâ¥à (á
FAT 16), CD-ROM, ¯à¨­â¥à (¢ ⮬ ç¨á«¥ 梥⭮©), Hayes-¬®¤¥¬, XTR-¬®¤¥¬ ¨
GSound (ç¥à¥§ ¯¥à¥å®¤­¨ª ISA2ZX), CGA ¬®­¨â®à, ⥫¥¢¨§®à á® SCART,
¬ £­¨â®ä®­. ‚த¥ ¢á¥ ¯¥à¥ç¨á«¨«.
€ á ª ª¨¬¨ ¡ã¤¥â, ¯®á¬®âਬ. ’ ª¨¥ ãáâனá⢠ â®ç­® ¥áâì, ­ ¯à¨¬¥à VGA
¬®­¨â®à.
AS> 5. Š ª¨¥ ãáâனá⢠ áâ ­¤ àâ­®£® ¢¢®¤ /¢ë¢®¤  ã ­¥£® ¡ã¤ãâ
AS> ¨á¯®«ì§®¢ âìáï? Ÿ ¨¬¥î ¢¢¨¤ã ª« ¢ã/¬ëèì/¬®­¨â®à.
‘¥©ç á ¨á¯®«ì§ãîâáï ª« ¢¨ âãà  ¨ ¬ëèì, ¯à®¤ î騥áï ¢ «î¡®¬ ª®¬¯ìîâ¥à­®¬
¬ £ §¨­¥, 祣® ­¥ ᪠¦¥èì ¯®ª , ª ᮦ «¥­¨î, ® ¬®­¨â®à¥. H® ®áâ ¥âáï
¢®§¬®¦­®áâì ¨á¯®«ì§®¢ ­¨ï ⥫¥¢¨§®à  á® áâ ­¤ àâ­ë¬ ࠧꥬ®¬ SCART.
AS> 6. Š ª ­ áç¥â 䨤®è­®© ¯®¤¤¥à¦ª¨? 㤥⥠ᮧ¤ ¢ âì íåã ¨ äíåã?
å¨ ¨ äíå¨ ¯®ª  à ­® á®§¤ ¢ âì - ­¥ ⮠稫® ¯®«ì§®¢ â¥«¥©. € çâ® ª á ¥âáï
¯®¤¤¥à¦ª¨, â® ¢ è ¨­â¥à¥á ¨ ¢®¯à®áë ¨ ¥áâì â  á ¬ ï ¯®¤¤¥à¦ª . ”ˆ„Ž ­¨ª®£¤  ­¥
¡ã¤¥â ⮫쪮 ४« ¬­ë¬ ¯®«¥¬, ­¥ ¤«ï ⮣® íâ  á¥âì áãé¥áâ¢ã¥â,   ¢®â ¯®¬®çì ¢
¢ë¡®à¥ ª®¬¯ìîâ¥à  (¥á«¨ â ª ï ¯®âॡ­®áâì ¢®§­¨ª­¥â), ®â¢¥â¨âì ­  ¢®¯à®áë,
¯®«ãç¨âì ¤¥«ì­ë© ᮢ¥â ¨«¨ ¯à¥¤«®¦¨âì ¨¤¥î, ­ ©â¨ ¯à®£à ¬¬¨á⮢, ¦¥« îé¨å
¯®¯à®¡®¢ âì ¢®§¬®¦­®á⨠Sprinter-  ¤«ï ॠ«¨§ æ¨¨ ᢮¨å ¯à®¥ªâ®¢, §¤¥áì ”ˆ„Ž
ª ª à § ¬®¦¥â ¯®¬®çì.
AS> 7. ‚ ª ª¨å ­ ¯à ¢«¥­¨ïå ¢ë ¡ã¤¥â¥ à §¢¨¢ âì íâã â¥å­®«®£¨î?
AS> "„®¬ è­¨© ª®¬¯ìîâ¥à"? ‡­ ç¨â, á®ä⠡㤥â à §à ¡ â뢠âìáï á â ª®© ¦¥
AS> ⥬ â¨ª®©, ª ª ¨ ­  ᯥª¥?
“ç¨âë¢ ï £¨¡ª®áâì  àå¨â¥ªâãàë, Sprinter ¬®¦¥â áâ âì ã­¨¢¥àá «ì­ë¬ ª®¬¯ìîâ¥à®¬.
“­¨¢¥àá «ì­®áâì,
ª®­¥ç­®, ­ ¤® à áᬠâਢ âì ¢ à ¬ª å ¥£®  ¯¯ à â­ëå ¢®§¬®¦­®á⥩. …áâì ¬­®£®
§ ¤ ç, ­¥ ¯®¤¯ ¤ îé¨å ¯®¤ ¢ë¢¥áªã "„®¬ è­¨© ª®¬¯ìîâ¥à", ª®â®àë¥ ¯® ¯«¥çã
Sprinter-ã, ¨¬¥© ®­ ᮮ⢥âáâ¢ãî饥 Ž.
…᫨ £®¢®à¨âì ® â¥å­®«®£¨¨ ¢ 楫®¬, â® ¤®¬ è­¨© ª®¬¯ìîâ¥à - í⮠⮫쪮 á ¬®¥
¡«¨§ª®¥ ¨ ®ç¥¢¨¤­®¥ ­ ¯à ¢«¥­¨¥. ‚ ¯¥àᯥªâ¨¢¥ ¢®§¬®¦­® ¯®ï¢«¥­¨¥ ®¡«¥£ç¥­­ëå
ãáâனá⢠ᯥ樠«ì­®£® ¯à¨¬¥­¥­¨ï. “ ­¨å ¡ã¤ãâ ä㭪樮­ «ì­ë¥ ®£à ­¨ç¥­¨ï, ­®
§ â® ¨ á⮨¬®áâì â ª¨å ãáâனá⢠¡ã¤¥â áãé¥á⢥­­® ­¨¦¥. ⨠ãáâனá⢠ ¡ã¤ãâ
¤à㣨¬¨ ¨ ¢­ãâ७­¥ ¨ ¢­¥è­¥. H ¯à¨¬¥à ˆ­â¥à­¥â-¯à¨áâ ¢ª  ª ¤®¬ è­¥¬ã
⥫¥¢¨§®àã. …© ­¥ âॡã¥âáï ¯®¤¤¥à¦ª  ¡®«ì襣® ç¨á«  ¯¥à¨ä¥à¨¨, ­¥ ­ã¦­ 
áâ ­¤ àâ­ ï ª« ¢¨ âãà  ¨ £à®¬®§¤ª¨© ª®à¯ãá, ­® ᮢ¥à襭­® ­¥®¡å®¤¨¬® ­ «¨ç¨¥
ä«íè-¯ ¬ïâ¨.
AS> 8. Š ª ­ áç¥â ¯¥ç â­ëå ¨§¤ ­¨©? Š­¨£¨, ¦ãà­ «ë, á¯à ¢®ç­¨ª¨
AS> ¨ ¯à®ç ï «¨â¥à âãà . € ¢ í«¥ªâà®­­®¬ ¢¨¤¥?
„®ªã¬¥­â æ¨ï ¥áâì, ®­  ¯®áâ®ï­­® ¯®¯®«­ï¥âáï ¨ ¯à¨ç¥á뢠¥âáï. „® á¨å ¯®à ¬ë
®¡å®¤¨«¨áì ¡à®èîà ¬¨ ᮡá⢥­­®£® ¨§£®â®¢«¥­¨ï, ­® ¯à¨ ª®¬¬¥àç¥áª¨å
ª®«¨ç¥áâ¢ å ¯®­ ¤®¡ïâáï ãá«ã£¨ ⨯®£à ä¨¨.
‚ ¯¥à¨®¤ ¯®¢ë襭­®£® ¨­â¥à¥á  ª ¯à®¥ªâã Sprinter, ¢ 97-98 £®¤ã, ­®¢®á⨠® 室¥
à ¡®â, áâ âì¨ "§ " ¨ "¯à®â¨¢" ॣã«ïà­® ¯®ï¢«ï«¨áì ¢ ᯥªâà㬮¢áª¨å
í«¥ªâà®­­ëå £ §¥â å ¨ ¦ãà­ « å. ‘ â¥å ¯®à ¨§¬¥­¥­¨ï ¢ ¯à®¥ªâ¥ ¯à®¨§®è«¨, ­®
®­¨ ª®á­ã«¨áì ¢ ®á­®¢­®¬ ª ç¥á⢠  ¯¯ à â­®£® ¨ ¯à®£à ¬¬­®£® ¨á¯®«­¥­¨ï, çâ®
­¥ ¯®§¢®«ï¥â ¯àאַ ᥣ®¤­ï § ï¢¨âì ¢® ¢á¥ãá«ëè ­ì¥ ® ⮬, çâ® Sprinter
ï¥âáï ¯à®¤ãªâ®¬, £®â®¢ë¬ ¤«ï è¨à®ª®£® ¯à¨¬¥­¥­¨ï. ®ª  Sprinter ®áâ ¥âáï ­ 
ã஢­¥  ­¤¥£à ã­¤ , ¨ ⮫쪮-⮫쪮 ­ ç¨­ ¥â á¥à쥧­ë¥ è £¨ ª ª®¬¯ìîâ¥à­®¬ã
àë­ªã.
AS> 9. Ÿ «î¡«î ᯥª. Š ª¨¥ ¯à¨ç¨­ë ¤®«¦­ë § áâ ¢¨âì ¬¥­ï ¯®«ì§®¢ âìáï
AS> á¯à¨­...®©, ¨§¢¨­¨, â®à£®¢ ï ¬ àª  =)... Sprinter-®¬?
‚­ ç «¥ ­ ¤® à §®¡à âìáï, § ç¥¬ ⥡¥ ­ã¦¥­ ª®¬¯ìîâ¥à, ¯®â®¬ áà ¢­¨âì
¯®âॡ­®áâ¨ á ¢®§¬®¦­®áâﬨ ª ¦¤®© ª®­ªà¥â­®© ¬®¤¥«¨,   § â¥¬ ⮫쪮 à¥è âì
­ã¦¥­ ¨¬¥­­® íâ®â ª®¬¯ìîâ¥à ¨«¨ ª ª®©-â® ¤à㣮©.
H¥ §­ ï ¯®âॡ­®á⥩ ª®­ªà¥â­®£® 祫®¢¥ª , âà㤭® ¢­ãè âì ¥¬ã ­¥®¡å®¤¨¬®áâì
⮩ ¨«¨ ¨­®© ¯®ªã¯ª¨.
Š á®¦ «¥­¨î, ¤®«£®¥ ¢à¥¬ï ¯à¨ á®§¤ ­¨¨ Sprinter-  ®¡à â­ ï á¢ï§ì ¡ë« 
­¥à¥£ã«ïà­®© ¨ ­¥ ãç¨â뢠« áì, ¯® ¡®«ì讬ã áç¥âã. ˆ§¬¥­¥­¨ï, ª®â®àë¥ ¯à®¨§®è«¨
¢ ­ ç «¥ í⮣® £®¤  ¢ ¯à®¥ªâ¥ Sprinter, ¯à¨§¢ ­ë ª ª à § à¥è¨âì ¯à®¡«¥¬ë
®à£ ­¨§ æ¨¨ à ¡®âë.
AS> 10. € £¤¥ ¡à âì á®äâ ¤«ï ¯à®£à ¬¬¨à®¢ ­¨ï, ¤®ª¨ ¯® á¨á⥬¥ ¨
AS> ¦¥«¥§ª ¬, etc.?
ணࠬ¬¨à®¢ ­¨¥ ¯®¤ Sprinter ¢¯®«­¥ ¯® ᨫ ¬ 祫®¢¥ªã ¯¨á ¢è¥¬ã ¯à®£à ¬¬ë ¤«ï
‘¯¥ªâà㬠.
‘¥£®¤­ï á®äâ ¯¨è¥âáï ¨ ­  Sprinter-¥ ¢ ᯥªâà㬮¢áª¨å  áᥬ¡«¥à å, ¨ ­  PC ¢
ªà®á áᥬ¡«¥à å.
Š á®¦ «¥­¨î, ®ç¥­ì ¯¥àᯥªâ¨¢­ë© ¤¢ã¯à®å®¤­ë© âãà¡® áᥬ¡«¥à TASM,
¨á¯®«ì§ãî騩 ¢á¥ ¢®§¬®¦­®á⨠Sprinter- , ®áâ ¥âáï ¯®ª  ­¥§ ª®­ç¥­­ë¬ ¯® àï¤ã
¯à¨ç¨­.
‚ ¡«¨¦ ©è¨¥ ¯« ­ë ¢å®¤¨â  ¤ ¯â æ¨ï CP/M-80 ¯®¤ Sprinter, ª ª à § ¤«ï
¨á¯®«ì§®¢ ­¨ï ï§ëª®¢ ¯à®£à ¬¬¨à®¢ ­¨ï ¨  áᥬ¡«¥à®¢ à ¡®â îé¨å ¯®¤ í⮩
®¯¥à æ¨®­ª®©. €¤ ¯â æ¨ï ¯®¤à §ã¬¥¢ ¥â ª ª ¯®¤¤¥à¦ªã DOS Sprinter-  (¤«ï à ¡®âë
á ¢¨­ç¥áâ¥à®¬), â ª ¨ à ¡®â®á¯®á®¡­®áâì 㦥 áãé¥áâ¢ãîé¨å ¯à®£à ¬¬ ¯®¤ CP/M-80
(¤«ï ¯®«­®âë  ¤ ¯â æ¨¨).
—â®-¦¥ ª á ¥âáï ¨­ä®à¬ æ¨¨ ¤«ï ¯à®£à ¬¬¨à®¢ ­¨ï, â® ¢áï ­¥®¡å®¤¨¬ ï ¨­ä®à¬ æ¨ï
¬®¦¥â ¡ëâì ¢ëá« ­ .
“¤ ç¨!
€«¥ªá¥© ƒ®àï祢
... ‚® ¨¬ï ‘íâ , ï ¢¤à㣠㦠᭮ § å®â¥« ¯®¢¨¤« . „ ¦¥ ¢® àâã ¯¥à¥á®å«®.
---
* Origin: PETERS PLUS LTD (2:5030/529.48)