Describe what the code does in comments and docs.

Comments say what the code does and why, docs/maxwell.md keeps the Maxwell facts, and fetch_refs.sh clones only the checkout the build reads. Code is unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
chrg6
2026-11-07 03:20:42 -05:00
parent a1871280a3
commit 1b39aabd37
128 changed files with 481 additions and 577 deletions

View File

@@ -1,6 +1,6 @@
"""Shared parts of the differential tests: Unicorn reference, operand generators, build and run of harness.c.
Adapted from LAS Recomp tools/test_lift.py and tools/test_simd.py @ da35b83 (MIT, Copyright (c) 2026 Peiikai).
Copyright (c) 2026 Peiikai (MIT; see THIRD_PARTY_NOTICES.md).
"""
import os
import shutil

View File

@@ -8,7 +8,7 @@ Skipped: system instructions and exceptions, whose single step cannot be compare
atomics, which atomic.py covers. Encodings the lifter rejects are counted per module and mnemonic; --coverage lifts
every distinct word instead of testing.
Adapted from LAS Recomp tools/test_lift.py @ da35b83 (MIT, Copyright (c) 2026 Peiikai).
Copyright (c) 2026 Peiikai (MIT; see THIRD_PARTY_NOTICES.md).
Usage: lift.py [--exefs DIR] [--modules main,sdk,subsdk0] [--encodings N] [--cases K] [--seed S] [--jobs J]
lift.py --coverage

View File

@@ -7,7 +7,7 @@ operands (NaNs, infinities, denormals, +-0, saturation edges, random FPCR.DN/FZ/
and, for stores, memory must match. FPSR is not compared; the lowering does not model the cumulative exception bits
or QC.
Adapted from LAS Recomp tools/test_simd.py @ da35b83 (MIT, Copyright (c) 2026 Peiikai).
Copyright (c) 2026 Peiikai (MIT; see THIRD_PARTY_NOTICES.md).
Usage: simd.py [--encodings N] [--cases K] [--seed S] [--jobs J] [--no-validity] [--filter HEX/MASK]
"""