сборка: гигиена (П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:
@@ -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.
|
||||
Reference in New Issue
Block a user