My opinion is that the reference should be a reference and not a how-to-use guide (as would be used in programming classes).
I have no problem with a "How to write and assembler program" manual, but it is outside the scope of the POPs. On Thu, 13 Nov 2014 10:52:17 +0000 "Ward Able, Grant" <[email protected]> wrote: :>I could not disagree more, Joey! :>PRECISE yes, but it does not need to be concise. I have always believed that it is too terse and could do with and upgrade. Mervyn's suggestions are a good starting argument and I, for one, would really enjoy a much more modern POPS manual, which has more verbose descriptions and examples. :> :> :> :>Regards Grant. :>Telephone Internal: 201496 (London) :>Telephone External: +44 (0)207 650 1496 :> :> :>-----Original Message----- :>From: IBM Mainframe Assembler List [mailto:[email protected]] On Behalf Of Capps, Joey :>Sent: 12 November 2014 22:15 :>To: [email protected] :>Subject: Re: Redesigning the Principles of Operation Manual :> :>Personally I don't think it's design was to save paper. :>I think it was to 'be concise'. :>And that is what I think it needs to be. :> :>As for reorganizing it into different chapters, that might be useful. :>But we cannot afford to have it lose its concise nature. :> :>Joey :> :> :>-----Original Message----- :>From: IBM Mainframe Assembler List [mailto:[email protected]] On Behalf Of Melvyn Maltz :>Sent: Wednesday, November 12, 2014 4:04 PM :>To: [email protected] :>Subject: Redesigning the Principles of Operation Manual :> :>One can see why the Principles of Operation manual (PoP) was designed in its present format...to save paper. :> :>There is now no need to design this manual in a form that was suitable 30 years ago. :> :>Now that I've restarted teaching Assembler I realise that the PoP neither serves the professional learning new instructions or techniques nor the student learning for the first time. :> :>The suggestions below have been compiled by myself and contacts and are not in any priority order. I offer these in order to stimulate discussion. I know IBM monitor this forum as I see names that I know. :>IBM can join in as well. :> :>1) Instruction descriptions :> Every instruction must be individually described. No more bunching. :> :>2) Two Manuals :> ---PoP1 describes formats and techniques :> ---PoP2 describes instructions and examples :> :> Hyperlinks to similar instructions and examples. :> :>3) Classification :> The current classification is inadequate, ie. CVD isn't a decimal instruction...there are many others. :> :> If you have to classify, then here is a suggestion... :> 1) Boolean...AND/OR/XOR :> 2) Branch....BRANCH and PROGRAM :> 3) Compare...COMPARE and TEST :> a) Binary :> b) Floating point :> c) Decimal :> 4) Conversion...CONVERT/TRANSLATE/UNPACK/EDIT/PACK :> a) Character/Binary/Decimal :> b) Floating point :> 5) Cryptography...COMPRESSION/CIPHER/PERFORM :> 6) I/O...CHANNEL :> 7) Maths :> a) Binary :> b) Floating point :> c) Decimal :> 8) Move...PAGE/MOVE/LOAD/STORE/INSERT :> 9) Trace..TRACE :> 10) Transaction..TRANSACTION :> 11) Trap...TRAP :> 12) Others :> :>4) An iPoP app that can display an individual instruction with multiple cross-references for local use. :> :>5) A Web app to do the same, but has the advantage of being international and collective. :> "People who looked up LG also looked up LLGF" :> :>Let the discourse begin. :>DTCC DISCLAIMER: This email and any files transmitted with it are confidential and intended solely for the use of the individual or entity to whom they are addressed. If you have received this email in error, please notify us immediately and delete the email and any attachments from your system. The recipient should check this email and any attachments for the presence of viruses. The company accepts no liability for any damage caused by any virus transmitted by this email. -- Binyamin Dissen <[email protected]> http://www.dissensoftware.com Director, Dissen Software, Bar & Grill - Israel Should you use the mailblocks package and expect a response from me, you should preauthorize the dissensoftware.com domain. I very rarely bother responding to challenge/response systems, especially those from irresponsible companies.
