Завершить разделение SDK и внешних проектов

release_docs/en/examples.md

@@ -1,76 +1,30 @@
-# Examples tour
+# Programs and examples
 
-The release ships with 27 example programs in `examples/`.  Every one of them
-is a self-contained demo with comments — they were used as regression tests
-during development.
+The SDK release includes its regression programs in `tests/`: `hello`,
+`cat`, `gfx_demo`, `bgitest` and others. They exercise compiler, libc,
+graphics and Sprinter runtime behavior. Build them with `make`; `make floppy`
+packs them into a local `build/media/toolkit-tests.img`.
 
-## Build any example
+Larger demonstrations (`balls`, `mdview`, `mdview2`, `rpgwalk`, `scroll`,
+`space`) are published in the separate Examples project. Clone it separately
+and point it at this installed SDK:
 
 ```sh
-cd examples/hello
+export SPRINTER_ROOT=/path/to/sprinter-c
+cd /path/to/Examples
+pyenv exec python -m pip install -r requirements.txt
 make
 ```
 
-That produces `hello.exe` next to `hello.c` using `examples/example.mk`.
-
-## Categories
-
-### Hello world / basics
-* **`hello`** — stdio + conio Turbo-C-style colours
-* **`argv`** — argv parsing in crt0
-* **`conio`** — conio API smoke test
-* **`attrprob`** — probe Sprinter text-attribute byte layout
-
-### File I/O
-* **`cat`** — read & print TEST.TXT
-* **`seek`** — 32-bit lseek over a 100 KB file
-* **`ls`** — directory listing via ffirst/fnext
-* **`filetest`** — FILE* streams (`fopen`/`fread`/`fwrite`/`fclose`)
-* **`stattest`** — `stat`/`fstat` on files and directories
-* **`openenv`** — open() flags + environment variables
-
-### Memory & banking
-* **`malloc`** — heap stress test (200+ allocations)
-* **`mem_test`** — page allocator + `bank_read`/`bank_write`
-* **`banked`** — banked code in W3 (huge mode)
-* **`bankedbg`** — banked code in W1 (big mode)
-* **`banklocl`** — bank-local static data and BSS
-
-### Mouse
-* **`mouse`** — driver in text mode
-* **`gfx_mous`** — mouse with custom bitmap cursor in graphics mode
-
-### Graphics
-* **`gfx_demo`** — 320×256×256: lines, rectangles, fill via accelerator
-* **`gfx_d16`** — 640×256×16: same primitives in 16-color mode
-* **`gfx_text`** — bitmap-font text on graphics screen
-
-### Misc
-* **`errno`** — errno / strerror / perror
-* **`timedir`** — date/time + directory listing
-* **`ptime`** — POSIX time API (time / localtime / mktime)
-* **`strtest`** — `<string.h>` test (from SDCC's z80.lib)
-* **`stdlib`** — `<stdlib.h>` test (qsort / rand / strtol / etc.)
-* **`assrtest`** — assert()
-* **`rt_test`** — runtime helpers (sleep, setjmp, atexit)
-
-## Example.mk
-
-Every example uses `examples/example.mk`.  A minimal Makefile looks like:
+For your own program, use the SDK's `app.mk`:
 
 ```makefile
-PROJ_ROOT := $(abspath $(CURDIR)/../..)
-EXAMPLE   := my_app
-include $(PROJ_ROOT)/examples/example.mk
+SPRINTER_ROOT ?= /path/to/sprinter-c
+EXAMPLE := my_app
+include $(SPRINTER_ROOT)/app.mk
 ```
 
-Optional knobs (set before `include`):
-
-```makefile
-MEMORY      := huge                       # default tiny
-STACK_SIZE  := 4096                       # default ~1278
-EXTRA_SRCS  := helper.c util.c            # extra .c files in same dir
-EXTRA_FLAGS := --bank 1=engine.c --debug  # pass-through to sprinter-cc
-```
-
-Use this template for your own programs.
+`make floppy` creates an image under the application's `build/media/`.
+For an emulator launch, set `MAME_HOME` to a prepared MAME runtime with
+`mame.arm`, `roms/` and `IMG/`; `MAME_BIN`, `MAME_ROMPATH`, `MAME_DSS_IMAGE`,
+`MAME_SYSTEM_HDD_IMAGE` and `MAME_BIOS` can override each part.

release_docs/en/getting_started.md

@@ -10,14 +10,15 @@ After extracting `sprinter-c-v1.0-<host>.tar.gz` you've got:
 * **`lib/sprinter.lib`** — the Sprinter target libc (prebuilt; rebuilt by `make` if you modify libc sources).
 * **`runtime/`** — crt0 variants and runtime helpers (assembled per-build).
 * **`toolchain/mkexe/`** — host utility that packs SDCC's `.ihx` into a SprintEXE.
-* **`examples/`** — 27 ready-to-build programs.
+* **`tests/` + `testkit/`** — SDK regression programs and host tests.
+* **`app.mk`** — standalone application build/run rules.
 * **`docs/{en,ru}/`** — this documentation.
 
 ## First build
 
 ```sh
 cd sprinter-c-v1.0-<host>
-make all                    # rebuild lib + every example (~30 s)
+make all                    # rebuild tools, libraries and SDK tests
 ```
 
 If `make` complains about a missing SDCC binary, fetch it once:
@@ -48,8 +49,9 @@ ESTEX DSS shell.
 The release does **not** include the MAME emulator or the Sprinter ROM /
 DSS / HDD images — those are large and have their own licensing.  To test:
 
-* **MAME:** install MAME 0.283+ separately, obtain Sprinter Sp2000 images from
-  Peters Plus, mount a FAT12 floppy with your `.exe` files as `-flop1`.
+* **MAME:** install a build with the Sprinter driver and prepare `MAME_HOME`
+  containing `mame.arm`, `roms/`, DSS floppy and system CHD. `make floppy`
+  creates a local SDK test disk; `make run MAME_HOME=/path/to/runtime` mounts it.
 * **Real Sprinter:** copy `.exe` to a floppy or HDD partition that DSS can
   see, then `RUN HELLO` from the shell.
 
@@ -57,5 +59,5 @@ DSS / HDD images — those are large and have their own licensing.  To test:
 
 * Read `sprinter_cc.md` for compiler flags.
 * Read `memory_modes.md` when you start needing more than 14 KB of code.
-* Browse `examples/` — every file is a working program with comments.
+* See `examples.md` for SDK tests and the separate Examples project.
 * See `headers.md` for the public API surface.