docs: add Atari Jaguar 1999 hardware reference set as Markdown

Mirror the 20 official Atari Jaguar developer-binder PDFs released into the
public domain by Hasbro Interactive in 1999, converted to Markdown via
pymupdf4llm so the Tom/Jerry register reference, opcode tables, and
hardware-bugs list are greppable next to src/op.c, src/tom.c, src/gpu.c,
src/dsp.c, etc.

Source PDFs are mirrored from cubanismo/jaguar-sdk and hillsoftware.com.
The PDFs themselves are .gitignored to keep the repo small (~73 MB skipped,
~2 MB of Markdown checked in); fetch-pdfs.sh + .convert.py reproduce them
locally on demand.

The 'Technical Reference v8.md' (Brennan/Dunn/Mathieson, rev 8, 28 Feb 2001)
comes from a typeset PDF and is the cleanest source. The numbered binder
files (00-17) are scans, so OCR quality varies — README.md notes this and
points to the originals when in doubt.

Made-with: Cursor

Author: JoeMatt

docs/atari-jaguar-1999/.convert.py

@@ -0,0 +1,46 @@
+#!/usr/bin/env python3
+"""Convert every PDF in this directory to a sibling .md via pymupdf4llm."""
+from __future__ import annotations
+
+import os
+import sys
+import time
+from concurrent.futures import ProcessPoolExecutor, as_completed
+from pathlib import Path
+
+import pymupdf4llm
+
+HERE = Path(__file__).resolve().parent
+
+
+def convert(pdf: Path) -> tuple[Path, int, float]:
+    t0 = time.time()
+    md = pymupdf4llm.to_markdown(str(pdf), show_progress=False)
+    out = pdf.with_suffix(".md")
+    out.write_text(md, encoding="utf-8")
+    return out, len(md), time.time() - t0
+
+
+def main() -> int:
+    pdfs = sorted(p for p in HERE.glob("*.pdf"))
+    if not pdfs:
+        print("no PDFs found", file=sys.stderr)
+        return 1
+
+    workers = min(os.cpu_count() or 4, 8)
+    print(f">> converting {len(pdfs)} PDFs with {workers} workers", flush=True)
+
+    with ProcessPoolExecutor(max_workers=workers) as ex:
+        futs = {ex.submit(convert, p): p for p in pdfs}
+        for f in as_completed(futs):
+            src = futs[f]
+            try:
+                out, size, dt = f.result()
+                print(f"  [{dt:5.1f}s] {src.name}  ->  {out.name} ({size:,} chars)", flush=True)
+            except Exception as exc:
+                print(f"  !! {src.name}: {type(exc).__name__}: {exc}", flush=True)
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

docs/atari-jaguar-1999/.gitignore

@@ -0,0 +1,8 @@
+.venv/
+__pycache__/
+*.pyc
+
+# Source PDFs (~73 MB) are not checked in — they live in cubanismo/jaguar-sdk
+# and hillsoftware.com. Run `./fetch-pdfs.sh` to re-download locally if you
+# need them, then `./.venv/bin/python .convert.py` to regenerate the .md files.
+*.pdf