Repository navigation
PRM intake: the document owner's answers and the November 2026 update - #14
Merged
Merged
Conversation
Tommo answered the intake questions on 2026-11-03. Converter changes: - An empty encoding box drawn without a border towards one named field now belongs to that field. The original leaves such boxes unmerged to center the field name. Fixes Bcc/BRA/BSR (displacement 7-1), MOVE2/MOVEH/MOVEX/MOVZ2 (B is 15-12), BFLY/TRANS/UNPACK1632 (d is 11-9) and DBcc.L/FDBcc.L (displacement 15-1). - Programming model: PC is 32 bits; CC is the 8-bit condition-code part of the 16-bit SR, and SR is not part of the user programming model. - Index: what gray means in the original (less relevant, removed or unused). - PEOR: PNOT is not an instruction; use peor.w #-1. The 15 regenerated files drop back to draft, as the converter does for any changed body. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Tommo's updated AC68080PRM.odt (update nov 2026) fixes the confirmed typos (MOVZ2 example, FDBcc operation, PCMPccB bsel), the "where a0 points to" lines on MOVEH and STOREILM, merges the B-field cells, and adds a note on MOVEC about grayed-out registers. Converter: recognize paragraph styles by their properties instead of their automatic names. LibreOffice renamed the code style P47 to P59 in this version, which broke the code blocks on the overview pages. Style attributes without a visible effect (opacity, use-window-font-color) are left out of the comparison. With the previous ODT the converter still gives the committed output. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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.
Tommo, the PRM's document owner, answered the questions from the intake (PR #7) on 2026-11-03 and sent an updated ODT (update nov 2026). This PR replaces
sources/official/AC68080PRM.odt, changes the converter (tools/intake/prm68080.py) and regenerates the files.Changes
Empty encoding boxes. The original leaves some boxes unmerged so the field name is centered. They are drawn without a border towards their field. The converter now reads the cell borders: an empty box with no border towards exactly one named field becomes part of that field.
11The last two rows were not in the intake questions. The same border rule finds them. Only FMOVEM still shows empty boxes: whole long words left blank in the memory format.
Programming model. PC is 32 bits. CC is the 8-bit condition-code part of the 16-bit SR, and SR is not part of the user programming model. Before, the table gave the drawn width (64 bits) for both.
Gray text. The reading guide in
index.mdnow says what gray means in the original: less relevant, removed or unused.PNOT.
peor.mdgets the rule: PNOT is not an instruction; usepeor.w #-1,d1,d2, as the page's note shows.Status
18 files are back at
draft, because the converter does that for any changed body: 15 from the converter changes, plus PCMPccB, STOREILM and MOVEC from the new ODT. The 18 need a new review before they go back toreviewed. The other 71 stayreviewed; only their source line changes to "update nov 2026".From the new ODT
02 23 45 67is now01 23 45 67;PC – 1 → Dnis nowDn – 1 → Dn;bsel d2,d1,e0is nowbsel d1,d2,e0.Converter: styles by properties. LibreOffice renamed the code style
P47toP59in this version, which broke the code blocks on the overview pages (integer-unit,fpu-unit,optimizing). The converter now recognizes the styles it needs (instruction name, subheading, cover tool lines, code) by a hash of their properties. It leaves out attributes without a visible effect (opacity,use-window-font-color). In both ODT versions each role matches exactly the intended styles, and with the old ODT the converter still gives the committed output.Still open
storem d0,d1,(a2)on the STOREILM page andstoreilm e10,e11,(a2)on the STOREM page. Each example's result follows the rule of the page it is on, not of the mnemonic it shows. The question to Tommo: which mnemonic did he assemble, and which bytes were written to memory?Knowledge base files relied on
CONTRIBUTING.mdsection 11 (document intake)🤖 Generated with Claude Code