I think the PoP should be split in two documents. The instructions descriptions would form PoO Volume I, the other chapters PoO Volume II (or the other way around). The 'other' chapters are fine just the way the are and a PDF seems a good way to distribute the information.
The description of the intructions contain u huge amount of highly structured information that is not very suited to a 'sequential' format like a PDF document. This thread mentioned a lot of like: What ADD instructions do I have? What exactly does TROT do? What instructions does this particular facility contain? What does the opcode 0FE0 do? Every one represents a valid use case but none of them are answered particularly well or fast by the the PoO in it's current form. I would propose that the information would be split in a description of every individual instruction and a taxonomy of the various properties of instructions. This taxonomy would look something like this: Function + Logical + + And + + Or + + Exclusive Or + Mathematical + + Addition + + Division + + Multiplication + + Square Root + + Subtraction Operand Location + Immediate + Register + + Access + + Control + + Floating Point + + General + + + 32 bit + + + + High + + + + Low + + + 64 bit + Memory Operand Size + Byte + Halfword + Fullword + Double word + Quad word Instruction Size + 2 bytes + 4 bytes + 6 bytes Facility + Execute Extensions + High Word + Long Displacement Et cetera The description of every individual instruction would be tagged with all the relevant terms form this taxonomy and stored in some kind of database. A user interface should allow one to navigate the taxonomy structure and filter on additional terms. Creating doesn't need to be that hard: creating the taxonomy and the descriptions could be a group effort. The result could be stored in a note taking app that allows structures of tags. Unfortunately the default iOS Note taking app or Vesper (my note taking app of choice) don't support that. But I'm sure "there's an app for that'. But I'm not sure if that falls within the usage terms of the PoO... Fred! ----------------------------------------------------------------- ATTENTION: The information in this electronic mail message is private and confidential, and only intended for the addressee. Should you receive this message by mistake, you are hereby notified that any disclosure, reproduction, distribution or use of this message is strictly prohibited. Please inform the sender by reply transmission and delete the message without copying or opening it. Messages and attachments are scanned for all viruses known. If this message contains password-protected attachments, the files have NOT been scanned for viruses by the ING mail domain. Always scan attachments before opening them. -----------------------------------------------------------------
