Repository navigation
Document intake: 68080 Programmer's Reference Manual - #7
Merged
Merged
Conversation
Add the original ODT to sources/official/ and a converter, tools/intake/prm68080.py, that generates core/cpu-68080/prm/: an index, one file per instruction (integer, AMMX, FPU) and overview files. Diagrams and the benchmark chart are described as tables. The converter keeps a maintainer's status while a file's content is unchanged, and CI checks that the generated files match the original. Generated files are marked reviewed by WDrijver. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This was referenced Nov 3, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
First document intake (CONTRIBUTING.md section 11): the Apollo 68080 Programmer's Reference Manual (AC68080PRM.odt, update okt 2026). The ODT is leading.
What's in it
sources/official/AC68080PRM.odt: the original, unchanged.tools/intake/prm68080.py: the converter. It uses only the Python standard library. The ODT has no semantic headings (its layout is visual), so pandoc output was not usable; the converter relies on the manual's fixed page structure.--checkverifies that the generated files match the ODT.core/cpu-68080/prm/(89 files):core/cpu-68080/index.md: now points toprm/.sources/README.mdand the CI workflow: the converter step, and a new check "Generated files match their originals".Conversion notes
.marks a box the original leaves empty.reviewed(WDrijver). The converter keeps that status while a file's content is unchanged, and generates the file asdraftagain when its content changes.Possible errors in the original
Reported to the document owner (Tommo). The conversion keeps the original as it is.
02 23but the result shows01 23.PC – 1 → Dn; DBcc hasDn – 1 → Dn.bsel d1,d2,e0, but the PCMPccB page writesbsel d2,d1,e0.Knowledge base files relied on
templates/files/reference.md🤖 Generated with Claude Code