Lisa Develpment System Internals Documentation

---~inc aR...,, ,.,..,.,,,,„.., KalM IYIU.)' •••••••••••••••merno••••••••••••••• To: Development Tools Group, Operating Sy·stems Group, Numerics Group, Eric Herslem, Lerry Tesler, Pete Creuman, steve Luckau, Paul Williams, Berry Haynes, Susan Keohan, Chris Espinosa, Ceroline Rose, Jerome Coonen From: Katie Withey, x3596 Date: 1' Fet>ruery 64 Re: Internals Documentation ••••••••••••••••••••••••••••••••••• Attatched is the fint draft of the Lisa Development S}1stem Jnternals Documentation. Please note that this is a living document; changes will be made, end no pert of it js guarenteed to be accurate. If you have any changes or corrections_, PLE ASE don't just merk them in your copy; tell me about them. Suggestions for inclusions in the next release ere also welcome. Preface lhe purpose of thh document is to explain/the internal itruct.ures and algorithms used by the Ltsa's run-time erwironment and development tools, and the internal library units (such as OBJIOLIB and SULIB) that ere related only to Lisa systems software. lt is actually a collection of documenh and memos, any or which cen be used separately, all relating to different aspects of the sytt.em. lhis is a reference document for programmen working on the following: • Maintaining or enhancing exirting Lisa development software. • Writing compilers or utilities for the Lisa Workshop, elther on contract with Apple or as third-party independanh. • Writing auembly-le.nguage programs that will interf ace with our compiled code. How will they benef it from thb document? • lt will save the people maintaining tools the trouble of looking through the code themselves to find inf ormatior.. • lt will save out.dde programmen, who don't have acceu to the code, from ce.lling us to ask questions about things that we have to look up in the code. • Parts of it will be included as a ref erence section in technical contracb that we assign to outside programmers. • lt will provide assembly-language programmers with such specifics e.s register conventions, pm-ameter-passing techniques, and memory layouh used by the compiler f or different types of arrays and structures. • lt can be uied to train new syitems ioftware programmen on the existing internah of the system. 16-JanuBJ'}„-84 Preface Contents Lisa Development Software Dcicurnentation: A Road Map Pascal Compiler Directives Pascal Code-Cruncher' s He.ndbook Tt1e Last Whole Eexth Text File Format Pascal's Packing Algorithrn PASLIB Procedure Interface PaslibCall Unit PPaslibC Unit.: Privil eged PASLIB Calls Floating-Point Libraries Standard Unit Execution Environment of the Pascal Compiler Intrinsic Unit.s Mechanism (overview) IUManager (old and "spring release" versions) Objec:t File Formats Interface to OBJIOLIB Format of .SYMBOLS File Using LisaBug Shell-VJriter's Guide Contents Lisa Development Software Documentation: A Road Map JrUoduction This road map was designed to help you to find your Wt!f!I around the verious documents descr…