сборка: гигиена (П5) — stale .rel, все тесты в make all, размерный регресс

- lib/Makefile: stale .rel удаляются сверкой списка модулей перед
  упаковкой; штамп build/.modules триггерит перелинковку при любом
  изменении состава исходников (при смене списка архив сносится —
  на exFAT гранулярность mtime грубая, сравнение времён ненадёжно)
- top-level TESTS: все каталоги tests/ теперь собираются make all
  (43 программы; banktest переименован из banked.exe — конфликт имён
  с tests/banked); mdview2 добавлен в APPS
- размерный регресс: toolchain/size_check.py сверяет _CODE всех
  программ с docs/size_baseline.tsv; make size-check / size-baseline
- заголовки: контракт затенения SDCC задокументирован в
  docs/libc-headers.md; новый string.h (include_next + strlwr/strupr);
  из sprinter_compat.h убраны макросы min/max — конфликтовали с
  функциями из stdlib.h, и в Solid-C min/max тоже функции

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-06 16:50:39 +03:00
parent 60373930fb
commit a4c8c79428
10 changed files with 273 additions and 32 deletions
+46
View File
@@ -0,0 +1,46 @@
# Заголовки libc: контракт затенения SDCC (2026-07-06)
`libc/include` стоит в -I ПЕРЕД заголовками SDCC, поэтому наш файл с
именем стандартного заголовка «затеняет» SDCC-шный. Два разрешённых
паттерна:
## 1. Цепочка `#include_next` — только ДОБАВЛЯЕМ
Наш заголовок первым делом делает `#include_next <имя>` (берёт
SDCC-версию) и дальше только добавляет Sprinter-расширения. Ничего
из стандартной части не переобъявлять — malloc/strlen/… должны
приходить из SDCC, иначе разъедутся прототипы с z80.lib (уже кусало:
полный shadow stdlib.h терял malloc/free).
| Заголовок | Что добавляем |
|---|---|
| `stdlib.h` | min/max (функции, int16_t — как `int min()` в Solid-C) |
| `string.h` | strlwr/strupr (CP866-регистры) |
## 2. Полная замена — обязаны продублировать контракт SDCC
Наш заголовок полностью замещает SDCC-шный. Он ОБЯЗАН объявить всё,
что программы берут из z80.lib, с точными SDCC-сигнатурами:
| Заголовок | Обязан объявлять (из z80.lib) | Наше |
|---|---|---|
| `stdio.h` | printf, sprintf, vprintf, vsprintf | FILE* API (буферизованный B+), puts/putchar/getchar (наши, ESTEX), scanf-семейство, dec*/hex*, gets |
| `time.h` | struct tm, time_t, time, mktime, gmtime, localtime, asctime, ctime — **раскладка struct tm и __TIME_UNSIGNED=1 должны совпадать с SDCC ABI** (см. шапку time.h) | datetime_t, getdatetime/setdatetime, DOW_* |
При апгрейде SDCC сверять сигнатуры этих двух заголовков с
`third_party/sdcc/share/sdcc/include/`.
## 3. Свои заголовки (SDCC-аналога нет — затенения нет)
conio.h, dir.h, dos.h, errno.h, fcntl.h, gfx.h, mouse.h, palette.h,
sprinter*.h, unistd.h, bios/*.
## Правила
- новый стандартный заголовок — сначала пробовать паттерн 1
(include_next); паттерн 2 — только если надо переопределить
реализацию (как puts/putchar на ESTEX);
- в заголовках паттерна 2 — комментарий, какие декларации обслуживают
z80.lib;
- internal-заголовки libc (`_conio.h`, `_file.h`, `_gfx.h`, …) живут
РЯДОМ с исходниками в libc/<area>/, не в libc/include.
+14 -14
View File
@@ -68,21 +68,21 @@ fgetpos/fsetpos (хвост П2). bdos/brk/ioctl — отказ решение
- [x] rename() — ESTEX RENAME $10 (HL=старое, DE=новое), libc/io/rename.c
- [x] isatty(fd) — fd < 2 (манипуляторы DSS с 2; консольные псевдо-fd 0/-1/-2)
## П5. Заголовки и гигиена сборки
## П5. Заголовки и гигиена сборки — ЗАКРЫТ 2026-07-06
- [ ] Аудит затенения SDCC-заголовков: stdlib.h уже на `#include_next`;
stdio.h/time.h — полные замены (задокументировать контракт «что обязаны
объявлять»); подумать про собственный string.h (include_next + strlwr/
strupr из sprinter_compat.h)
- [ ] lib/build: wildcard не удаляет stale .rel при удалении исходника —
либо чистка в Makefile (сверка списка), либо привычка `make clean`
после переименований (это уже укусило: старый file.rel лежал в build)
- [ ] Включить extra-тесты (conio2, dec_test, gets, hello2, simple, stest2,
winrest, bios_text, text_palette, gfx_dbuf, mdview2) в top-level
TESTS/APPS — иначе `make all` их не собирает и их baseline протухает
(уже дало ложные «+17 Б» при сравнении)
- [ ] Размерный регресс-тест: скрипт сравнения _CODE по .map с эталоном
(ловить случайные разжирения при правках libc)
- [x] Контракт затенения **docs/libc-headers.md**: include_next
(stdlib.h + новый string.h со strlwr/strupr) vs полная замена
(stdio.h, time.h — обязаны дублировать сигнатуры z80.lib);
из sprinter_compat.h убраны макросы min/max (конфликтовали с
функциями из stdlib.h; в Solid-C это тоже функции)
- [x] lib/Makefile: stale .rel чистятся сверкой списка перед упаковкой;
штамп .modules триггерит перелинковку при смене состава (и сносит
архив — mtime на exFAT грубый)
- [x] Все extra-тесты в top-level TESTS (43 программы: + hello2, simple,
banktest (переименован из banked.exe), conio2, dec_test, gets,
stest2, winrest, bios_text, text_palette, gfx_dbuf) и mdview2 в APPS
- [x] Размерный регресс: toolchain/size_check.py + docs/size_baseline.tsv;
`make size-check` (выход 1 при росте) / `make size-baseline`
## П6. Верификация после сплита
+44
View File
@@ -0,0 +1,44 @@
# Эталон размеров _CODE (байт); обновление: python3 toolchain/size_check.py --update
argv 3431
assrtest 3847
attrprob 4091
banked 1040
bankedbg 1051
banklocl 4816
banktest 3751
bios_text 4470
cat 915
conio 4634
conio2 3946
dec_test 860
errno 6216
fbench 9040
fdmax 6337
filetest 11624
gets 509
gfx_d16 3319
gfx_dbuf 2396
gfx_demo 3219
gfx_mous 5542
gfx_text 2560
hello 4176
hello2 4251
ls 4919
malloc 4462
mdview 19122
mdview2 27029
mem_test 4558
mouse 4394
openenv 6111
ptime 5896
rt_test 4103
seek 4177
simple 963
solidt 12381
stattest 7700
stdlib 6643
stest2 3644
strtest 1340
text_palette 5039
timedir 5471
winrest 4481
1 # Эталон размеров _CODE (байт); обновление: python3 toolchain/size_check.py --update
2 argv 3431
3 assrtest 3847
4 attrprob 4091
5 banked 1040
6 bankedbg 1051
7 banklocl 4816
8 banktest 3751
9 bios_text 4470
10 cat 915
11 conio 4634
12 conio2 3946
13 dec_test 860
14 errno 6216
15 fbench 9040
16 fdmax 6337
17 filetest 11624
18 gets 509
19 gfx_d16 3319
20 gfx_dbuf 2396
21 gfx_demo 3219
22 gfx_mous 5542
23 gfx_text 2560
24 hello 4176
25 hello2 4251
26 ls 4919
27 malloc 4462
28 mdview 19122
29 mdview2 27029
30 mem_test 4558
31 mouse 4394
32 openenv 6111
33 ptime 5896
34 rt_test 4103
35 seek 4177
36 simple 963
37 solidt 12381
38 stattest 7700
39 stdlib 6643
40 stest2 3644
41 strtest 1340
42 text_palette 5039
43 timedir 5471
44 winrest 4481