README.md¶

Deterministic source record. The complete textual file is reproduced below; this page does not replace architectural interpretation in the authored chapters.

File identity¶

Field	Value
Path	`third_party/doomgeneric/README.md`
Lines	22
Bytes	977
SHA-256	`681bdd4cbd85a9699f4f77dcb15ef486fd1393763094ad562b9d29fd7fccddd1`
ChrisOS revision	`da3df29cb397932c43d32373871fb9380e688ade`

Detected syntactic dependencies¶

Line	Include
—	No preprocessor include detected.

Detected symbols¶

Line	Symbol
—	No C-like function definition detected by the scanner.

Complete source¶

The following block is the complete textual file at the recorded revision. No lines are elided, abbreviated or paraphrased.

This tree is the ChrisOS bring-up of doomgeneric (GPLv2).

Vendored upstream snapshot: `third_party/doomgeneric_src` (clone of https://github.com/ozkl/doomgeneric).

## Playable path (ENGINE)

- `GAMES/DOOM/ENGINE.LST` → `ENGINE.CLV` (full doomgeneric + Chris glue)
- `GAMES/DOOM/MAIN.CC` — argv `-iwad GAMES/DOOM/DOOM1.WAD -mb 16`
- `GAMES/DOOM/I_CHRIS.CC` — DG_* video/timer (320×200, `fb_blit` / `setpal`)
- `GAMES/DOOM/I_VIDEO.CC` / `I_INPUT.CC` / `I_SOUND.CC` / `W_FILE.CC` — Chocolate Doom I_* + WAD IO
- `GAMES/DOOM/DOOM1.WAD` — **Freedoom Phase 1** (`freedoom1.wad`). Do not commit commercial IWADs.
- Desktop / taskbar / shell launch `GAMES/DOOM/ENGINE.CLV`

Controls: arrows move, Ctrl fire, Space use, Esc menu, Enter select, Y/N quit confirm.

## Demo path (optional)

- `GAMES/DOOM/DOOM.LST` → `DOOM.CLV` — palette / fb_blit bring-up only
- `GAMES/DOOM/DOOM1.MINI.WAD` — PLAYPAL-only mini IWAD for tests

Do not compile Chocolate Doom + SDL here.

Role of this record¶

The atlas guarantees file-by-file traceability. Responsibility, invariants, ownership, concurrency, security, performance and subsystem interactions belong in authored chapters and must cite this file when applicable.