Files

T

snark13 a4c8c79428 сборка: гигиена (П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>

2026-07-06 16:50:39 +03:00

2.8 KiB

Raw Blame History

Заголовки 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//, не в libc/include.

2.8 KiB Raw Blame History