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

release_docs/ru/examples.md

@@ -1,75 +1,30 @@
-# Обзор примеров
+# Программы и примеры
 
-Релиз содержит 27 примеров в каталоге `examples/`.  Каждый — самодостаточная
-демо-программа с комментариями (использовались как regression-тесты при разработке).
+Релиз SDK содержит регрессионные программы в `tests/`: `hello`, `cat`,
+`gfx_demo`, `bgitest` и другие. Они проверяют компилятор, libc, графику и
+runtime Sprinter. `make` собирает их, а `make floppy` упаковывает в локальный
+`build/media/toolkit-tests.img`.
 
-## Сборка примера
+Большие демонстрации (`balls`, `mdview`, `mdview2`, `rpgwalk`, `scroll`,
+`space`) выпускаются отдельным проектом Examples. Для него задаётся только
+путь к установленному SDK:
 
 ```sh
-cd examples/hello
+export SPRINTER_ROOT=/путь/к/sprinter-c
+cd /путь/к/Examples
+pyenv exec python -m pip install -r requirements.txt
 make
 ```
 
-Результат — `hello.exe` рядом с `hello.c` через `examples/example.mk`.
-
-## Категории
-
-### Hello world / основы
-* **`hello`** — stdio + conio Turbo-C-стиль цвета
-* **`argv`** — парсинг argv в crt0
-* **`conio`** — smoke test conio API
-* **`attrprob`** — пробинг байта атрибутов Sprinter
-
-### Файловый ввод-вывод
-* **`cat`** — читает и печатает TEST.TXT
-* **`seek`** — 32-битный lseek по файлу в 100 КБ
-* **`ls`** — листинг каталога через ffirst/fnext
-* **`filetest`** — FILE* стримы (`fopen`/`fread`/`fwrite`/`fclose`)
-* **`stattest`** — `stat`/`fstat` для файлов и каталогов
-* **`openenv`** — флаги open() + environment variables
-
-### Память и банки
-* **`malloc`** — стресс-тест heap (200+ allocations)
-* **`mem_test`** — page allocator + `bank_read`/`bank_write`
-* **`banked`** — banked-код в W3 (huge mode)
-* **`bankedbg`** — banked-код в W1 (big mode)
-* **`banklocl`** — bank-local статические данные и BSS
-
-### Мышь
-* **`mouse`** — драйвер в текстовом режиме
-* **`gfx_mous`** — мышь с пользовательским bitmap-курсором в графическом режиме
-
-### Графика
-* **`gfx_demo`** — 320×256×256: линии, прямоугольники, fill через accelerator
-* **`gfx_d16`** — 640×256×16: те же примитивы в 16-цветном режиме
-* **`gfx_text`** — bitmap-текст на графическом экране
-
-### Прочее
-* **`errno`** — errno / strerror / perror
-* **`timedir`** — дата/время + листинг каталога
-* **`ptime`** — POSIX time API (time / localtime / mktime)
-* **`strtest`** — `<string.h>` тест (из SDCC's z80.lib)
-* **`stdlib`** — `<stdlib.h>` тест (qsort / rand / strtol / etc.)
-* **`assrtest`** — assert()
-* **`rt_test`** — runtime helpers (sleep, setjmp, atexit)
-
-## Example.mk
-
-Каждый пример использует `examples/example.mk`.  Минимальный Makefile:
+Для своей программы подключайте `app.mk` SDK:
 
 ```makefile
-PROJ_ROOT := $(abspath $(CURDIR)/../..)
-EXAMPLE   := my_app
-include $(PROJ_ROOT)/examples/example.mk
+SPRINTER_ROOT ?= /путь/к/sprinter-c
+EXAMPLE := my_app
+include $(SPRINTER_ROOT)/app.mk
 ```
 
-Опциональные параметры (задаются до `include`):
-
-```makefile
-MEMORY      := huge                       # по умолчанию tiny
-STACK_SIZE  := 4096                       # по умолчанию ~1278
-EXTRA_SRCS  := helper.c util.c            # дополнительные .c в той же папке
-EXTRA_FLAGS := --bank 1=engine.c --debug  # pass-through в sprinter-cc
-```
-
-Используйте этот template для своих программ.
+`make floppy` создаёт образ в локальном `build/media/` приложения. Для
+запуска в эмуляторе задайте `MAME_HOME` с `mame.arm`, `roms/` и `IMG/`;
+`MAME_BIN`, `MAME_ROMPATH`, `MAME_DSS_IMAGE`, `MAME_SYSTEM_HDD_IMAGE` и
+`MAME_BIOS` позволяют переопределить отдельные пути.