mirror of
https://github.com/Druthulu/BFM-decomp
synced 2026-09-26 13:33:34 -04:00
Drew T
22 lines
2.2 KiB
Markdown
22 lines
2.2 KiB
Markdown
# Readability of the matched C — the Gen3 series
|
|
|
|
> **Generated by `tools/readability_progress.py --snapshot`; never typed (R75).** Companion to
|
|
> `docs/levers.md`, which counts the compiler-forcing levers. This one counts the two things that are wrong
|
|
> with the source even where no lever remains: call declarations that are FALSE, and memory read through raw
|
|
> pointer casts where the original had a struct. From Phase 37 the row carries the type census's columns
|
|
> (`tools/type_census.py`): all four dereference forms, the typed cast-member intermediate, the definitions and the map.
|
|
|
|
| date | label | commit | lying declarations | of which `()` | of which `(void)` | in a pinned body | raw cast derefs (one form, raw text) | struct member reads | **raw derefs, four forms** | typed cast-member | struct defs (canonical / in .c) | layouts | duplicate classes / names | map types (% sites) |
|
|
|---|---|---|---:|---:|---:|---:|---:|---:|---:|---:|---|---:|---|---|
|
|
| 2026-09-10 | P36 S102 — after the 16,759 free declaration repairs | `51028a78d` | 94001 | 86701 | 7300 | 461 | 414148 | 173286 | **—** | — | — | — | — | — |
|
|
| 2026-09-11 | P36 close | `7a7f78e25` | 98648 | 91357 | 7291 | 33 | 411850 | 177902 | **—** | — | — | — | — | — |
|
|
| 2026-09-11 | P37 T1 — the type census (four forms, definitions, the map) | `23fc5d215` | 98648 | 91357 | 7291 | 33 | 411850 | 177902 | **503016** | 36681 | 7261 (1179 / 5995) | 525 | 206 / 2789 | 18760 (99.2 %) |
|
|
| 2026-09-12 | P37 T2 — the census after the audit's parser fixes (attributes, dead guards) | `da26c05d6` | 98648 | 91357 | 7291 | 33 | 411850 | 177902 | **503016** | 36681 | 7255 (1179 / 5989) | 527 | 206 / 2823 | 18760 (99.2 %) |
|
|
|
|
**How to read it.** A *lying declaration* is a call site whose in-scope declaration names fewer parameters
|
|
than the callee's own definition. It is not a style problem: on this processor an argument travels in a
|
|
register, so a dropped argument removes an instruction, and Phase 36 found register pins inserted to fake
|
|
exactly that instruction. *Raw cast derefs* is the struct debt — a struct cannot be recovered from the
|
|
binary, only inferred from consistent base+offset+width evidence, so this figure falls as that work lands.
|
|
|